[Buildroot] [PATCH 0/11 v3] Add list of virtual packages to manual (branch yem/manual)

[Yann E. MORIN <yann.morin.1998@free.fr>]

From: "Yann E. MORIN" <yann.morin.1998@free.fr>

Hello All!

This series intends to add the list of virtual packages to the manual, for
three reasons:

  - for users that are told (in a comment in the menuconfig) that a
    package they need depends on a virtual package, to know what provider
    to select,

  - for people writing a new provider for an existing virtual package to
    have a reference of which symbol to select and which package to provide
    in their Config.in and .mk files,

  - for people writing a new package that depends on features provided by
    a virtual package to know what symbol to depend on.

The series starts with some preparatory changes and cleanups, then
introduces a way to generate different forms of tables, then goes on by
removing virtual packages from the current lists, and finally adds a new
list with the virtual packages.

Pre-rendered manual available here:
    http://ymorin.is-a-geek.org/download/tmp/buildroot/virtual-packages/manual/manual.html

Special thanks to Samuel and Maxime for their pythonistic help! :-)


Changes v2 -> v3:
  - drop remaining 'both' instances  (Samuel)

Changes RFC -> v2:
  - saner API to formatter-functions  (Samuel)
  - more classical Python constructs for dicts and lambdas  (Samuel)
  - more accurate python-doc  (Samuel)
  - lota typoes  (Samuel)


Regards,
Yann E. MORIN.


The following changes since commit ed1182641812986f529b2150635f1e93c799a419:

  xserver_xorg-server: add support for xtensa architecture (2014-06-08 15:51:00 +0200)

are available in the git repository at:

  git://gitorious.org/buildroot/buildroot.git yem/manual

for you to fetch changes up to e5d675da25e21b9b647172b947977d45da55c3eb:

  docs/manual: add the virtual packages list (2014-06-08 16:07:30 +0200)

----------------------------------------------------------------
Yann E. MORIN (11):
      package/cryptodev: make it behave more like other virtual packages
      package/jpeg: make it behave more like other virtual packages
      package/mesa3d: rename the prompt
      support/scripts: prepare expanding the packages lists
      support/scripts: document args to _is_package() in gen-manual-lists
      support/scripts: prepare handling virtual packages in generated lists
      support/scripts: do not display virtual packages in generated lists
      support/scripts: who's responsible to decide what is a package
      support/scripts: introduce a symbol formatter to generate package lists
      support/scripts: generate a list of virtual packages
      docs/manual: add the virtual packages list

 docs/manual/adding-packages-directory.txt |  10 ++
 docs/manual/adding-packages-virtual.txt   |   6 +
 docs/manual/appendix.txt                  |   8 ++
 package/cryptodev/Config.in               |   4 +-
 package/jpeg/Config.in                    |   4 +-
 package/mesa3d/Config.in                  |   2 +-
 support/scripts/gen-manual-lists.py       | 217 ++++++++++++++++++++++++------
 7 files changed, 209 insertions(+), 42 deletions(-)

-- 
.-----------------.--------------------.------------------.--------------------.
|  Yann E. MORIN  | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +33 662 376 056 | Software  Designer | \ / CAMPAIGN     |  ___               |
| +33 223 225 172 `------------.-------:  X  AGAINST      |  \e/  There is no  |
| http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL    |   v   conspiracy.  |
'------------------------------^-------^------------------^--------------------'