XSL Parameter Documentation Principle

-------------------------------------

- Each parameter is documented through an individual refentry file, like

  the DocBook Project does. These refentries stored unders params/ are the

  sources to maintain.

  There were built from the original parameter table (../custom/param.xml) with

  the command:

  xsltproc --xinclude ../../tools/param2ref.xsl ../custom/param.xml

  Each refentries XIncludes its related synopsis file. The reason of this

  structure (and not putting the synopsis directly in the refentries) is to be

  able to automatically update/sync the synopsis from the XSL stylesheets

  without modifying the refentries.

- The parameter synopsis are stored under the ./syn directory. They are 

  automatically produced from the dblatex XSL stylesheets with the following

  command:

  ../../tools/parambuild ./syn

- params/param.xml is the appendix that groups the whole refentries by

  XIncluding them. This file is currently maintained by hand, but it could be

  possible to build it through scripts.

- the params/param.xml file is XIncluded in the main documentation (manual.xml).