libX11: Changes to 'master'

[Gaetan Nadon]

 Makefile.am                         |    1 
 configure.ac                        |   17 +
 docbook-gen-chunk.am                |  102 +++++++++
 docbook-gen.am                      |   96 ++++++++
 nls/Makefile.am                     |   98 ---------
 nls/compose-chart.pl                |  389 ------------------------------------
 nls/xmlrules.in                     |   59 -----
 specs/i18n/Makefile.am              |    2 
 specs/i18n/compose/.gitignore       |    2 
 specs/i18n/compose/Makefile.am      |   29 ++
 specs/i18n/compose/compose-chart.pl |  388 +++++++++++++++++++++++++++++++++++
 specs/libX11/AppA.xml               |    8 
 specs/libX11/AppC.xml               |   68 +-----
 specs/libX11/AppD.xml               |   26 +-
 specs/libX11/CH03.xml               |   85 +++----
 specs/libX11/CH04.xml               |   34 +--
 specs/libX11/CH05.xml               |   14 -
 specs/libX11/CH06.xml               |   10 
 specs/libX11/CH07.xml               |   93 ++++----
 specs/libX11/CH08.xml               |   88 ++++----
 specs/libX11/CH09.xml               |   52 ++--
 specs/libX11/CH10.xml               |   88 ++------
 specs/libX11/CH11.xml               |  132 +++++-------
 specs/libX11/CH12.xml               |   68 +++---
 specs/libX11/CH13.xml               |  332 +++++++++++++-----------------
 specs/libX11/CH14.xml               |   96 ++++----
 specs/libX11/CH15.xml               |   51 +---
 specs/libX11/CH16.xml               |   92 ++++----
 specs/libX11/credits.xml            |   16 -
 29 files changed, 1246 insertions(+), 1290 deletions(-)

New commits:
commit 7f23c72c94d9d14122426b0d8c66054f1402769a
Author: Gaetan Nadon <memsize at videotron.ca>
Date:   Fri Aug 5 14:33:32 2011 -0400

    libX11 specs: review doclifter generated tables
    
    Many tables had a questionnable layout and some had information dropped.
    Each table was cross-referenced with a pre-docbook version
    to ensure semantic integrity.
    
    Signed-off-by: Gaetan Nadon <memsize at videotron.ca>

commit 1efdbeb8cd08f443188ac783cbab6ba0654a66d6
Author: Gaetan Nadon <memsize at videotron.ca>
Date:   Wed Jul 20 15:28:47 2011 -0400

    credits.xml: remove toc from Acknowledgments
    
    There should be no toc for a simple preface with only one
    Acknowledgments section.
    
    Use <simplesect> markup rather than sect1.
    
    Signed-off-by: Gaetan Nadon <memsize at videotron.ca>

commit 77cc17ed0817c1df3ac5feb9dc83a5ba5d021a4b
Author: Gaetan Nadon <memsize at videotron.ca>
Date:   Thu Aug 4 19:59:37 2011 -0400

    libX11 specs: move </para> above <varaiablelist>
    
    Many, but not all, function synopsis have a paragraph that
    nests the variable list. The code was generated by doclifter
    and there is no apprent reasons as to why it was done this way.
    Found while investigating a spacing issue.
    
    Before the patch:
    <para>Some blurb about the function
    <funcsynopsis>
    </funcsynopsis>
    <variablelist>
    </variablelist>
    </para>
    
    After the patch:
    <para>Some blurb about the function</para>
    <funcsynopsis>
    </funcsynopsis>
    <variablelist>
    </variablelist>
    
    There are no noticable differences when reading the doc
    other than than the removed few pixels of spacing between
    the function sysnopsis and the variable list block.
    
    In some cases, there are no "blurb about the fucntion"
    and the empty paragraph is removed.
    
    Signed-off-by: Gaetan Nadon <memsize at videotron.ca>

commit 18595f0d8f95ff1c12e7b9f73bd4b30dda5c7168
Author: Gaetan Nadon <memsize at videotron.ca>
Date:   Thu Jul 28 19:46:14 2011 -0400

    compose specs: generate chunked html
    
    For large 600 page documents such as this one, chunked html
    provide faster browser load time and better navigation.
    
    Simply click on the locale of your choice in the toc and
    the browser loads just that one file. Being a DocBook,
    it benefits from all of the usual features and can be
    integrated with the rest of the documentation.
    
    Acked-by: Alan Coopersmith <alan.coopersmith at oracle.com>
    Signed-off-by: Gaetan Nadon <memsize at videotron.ca>

commit 5cc8815b8a117cf0b6af37e7d55c5a420d9fff57
Author: Gaetan Nadon <memsize at videotron.ca>
Date:   Thu Jun 23 15:16:47 2011 -0400

    specs: build compose keys tables in specs/i18n/compose
    
    Build the tables article together with the rest of the specs.
    Make it transparent that the source in generated in nls.
    Reuse docbook.am and get all the features such as olink.
    
    The docbook article file stem and id must be the same. The new name
    for the main article is libX11-keys. The new installation location
    is $docdir/libX11/i18n/compose.
    
    The nls dir retains the role of generating the DocBook/XML source
    but does not build neither installs output formats or generated source.
    
    The tables article now has to specify that each included locale
    section is a dependency. It did not matter before as they were web links.
    
    The xorg-sgml-doctools masterdb shall be updated to include this new doc.
    Install location moved from doc/libX11/Compose to doc/libX11/i18n/compose.
    
    Acked-by: Alan Coopersmith <alan.coopersmith at oracle.com>
    Signed-off-by: Gaetan Nadon <memsize at videotron.ca>

commit adebbe3856b4aee39c0c7af902c1dea847dd6d7c
Author: Gaetan Nadon <memsize at videotron.ca>
Date:   Thu Jun 23 14:43:31 2011 -0400

    nls: restructure charts as a single article with sections
    
    Looks more like a real article with a toc rather than individual
    web pages. Looks nicer in pdf.
    
    Each locale is a "section" rather than an "article".
    Using XInclude to aggregate xml source files gets you the toc for free.
    
    The single document is over 600 pages while there were 62 separate
    documents previously. FOP version 1.0 is required to handle missing
    character like capital sharp s.
    
    Acked-by: Alan Coopersmith <alan.coopersmith at oracle.com>
    Signed-off-by: Gaetan Nadon <memsize at videotron.ca>