summaryrefslogtreecommitdiff
path: root/specs
Commit message (Collapse)AuthorAgeFilesLines
* libX11 spec: Correct prototype for XConvertSelectionAlan Coopersmith2012-06-061-1/+2
| | | | | | selection & target parameters were accidentally run together Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* Add X11R7 sections to the libX11 & XKBlib credits to cover Docbook conversionAlan Coopersmith2012-04-172-3/+21
| | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* Add olinks from libX11 & localedb specs to ICCCM specAlan Coopersmith2012-04-174-7/+7
| | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* Add olinks from libX11 spec to ICCCM specAlan Coopersmith2012-04-178-14/+19
| | | | | | Also convert ICCCM title mentions from <emphasis> to <citetitle> Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* libX11 AppC: Fix section headers that didn't translate from nroff properlyAlan Coopersmith2012-04-171-40/+54
| | | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> Acked-by: Peter Hutterer <peter.hutterer@who-t.net>
* Add olinks from libX11 spec to x11protocol specAlan Coopersmith2012-04-173-3/+6
| | | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> Acked-by: Peter Hutterer <peter.hutterer@who-t.net>
* libX11 spec: Remove .br nroff macro left behind in XGetWindowProperty prototypeAlan Coopersmith2012-04-141-1/+1
| | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* informaltable & table cleanupMatt Dew2012-01-2134-2916/+3294
| | | | | | | | | | | | | | | | On certain tables, add top and bottom borders to table header and a bottom border to the table. This matches what those tables in the old pdfs looked like. the <?dbfo keep-together='always'> prevents tables from splitting across pages. Useful for tiny tables. Converting the colwidth to a floating point, IE, 1* -> 1.0* cleans up these build errors: WARNING: table-layout="fixed" and column-width unspecified => falling back to proportional-column-width(1) Signed-off-by: Matt Dew <marcoz@osource.org>
* Cleanup IDs and links in docMatt Dew2011-10-0748-3740/+3716
| | | | | | | | | | 1 - fix the capitalization of the ID attributes to match either the <title> or <funcdef> string it goes with. 2 - fix any <linkend>'s that were affected by 1. 3 - any <function> in the docs that has an actual funcdef, will become an olink. Signed-off-by: Matt Dew <marcoz@osource.org>
* localedb specs: use <copyright> for first holder of multi licenseGaetan Nadon2011-09-201-2/+3
| | | | Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* libX11 specs: use <copyright> for first holder of multi licenseGaetan Nadon2011-09-201-7/+8
| | | | Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* XKB: provide adequate quotes for the license textGaetan Nadon2011-09-191-1/+1
| | | | Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* XIM: refactor the multi licensing legal textGaetan Nadon2011-09-191-15/+35
| | | | Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* xim trans: restore Fujitsu copyright legal textGaetan Nadon2011-09-191-6/+11
| | | | | | Somehow lost during docbook conversion. text from x.org ftp R7.5. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* xtrans: restore X Consortium original legal textGaetan Nadon2011-09-191-3/+3
| | | | | | | | | Asking X Consortium permission to use The Open Group name makes no sense. Even more so in 1994 before X Window System was passed on to the Open Group. Using original text from xorg-docs/general/License Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* Framework: restore X Consortium copyrightGaetan Nadon2011-09-191-1/+2
| | | | | | | Somewhat dammaged during docbook conversion. Also restore pasrt of the original license text Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* localedb: restore X Consortium original legal textGaetan Nadon2011-09-191-3/+3
| | | | | | | | | Asking X Consortium permission to use The Open Group name makes no sense. Even more so in 1994 before X Window System was passed on to the Open Group. Using original text from xorg-docs/general/License Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* specs: support multi licensed copyright notice and license textGaetan Nadon2011-09-191-3/+2
| | | | | | | | | | For documentation having multiple licenses, the copyright and legalnotice elements sequence cannot instantiated multiple times. The copyright notice and license text are therefore coded inside a legalnotice element. The role attribute on the paragraph is used to allow styling of the copyright notice text which should not be italicized. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* localedb: add release info to specGaetan Nadon2011-09-191-1/+5
| | | | Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* specs: fix The Open Group license textGaetan Nadon2011-09-191-7/+6
| | | | | | The warranty referred to the X Consortium Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* specs: The strandard name is still "X Consortium Standard"Gaetan Nadon2011-09-191-1/+1
| | | | | | | This spec, and fsproto spec, are the only two docs with a different standard name. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* specs: support multi licensed copyright notice and license textGaetan Nadon2011-09-181-6/+2
| | | | | | | | | | For documentation having multiple licenses, the copyright and legalnotice elements sequence cannot instantiated multiple times. The copyright notice and license text are therefore coded inside a legalnotice element. The role attribute on the paragraph is used to allow styling of the copyright notice text which should not be italicized. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* docs: merge copyright holder under the same copyright noticeGaetan Nadon2011-09-173-9/+16
| | | | | | As per the docbook markup dtd. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* specs: handle multiple sets of copyright notice/license/warrantyGaetan Nadon2011-09-171-8/+6
| | | | | | | | | | | | | | | | Docbook groups all the <copyright> elements together and all the <legalnotice> elements together. We cannot have a sequence: <copyright> <legalnotice> <copyright> <legalnotice> [...] A workaround, which was done in some documents, is to put the copyright notice inside the legalnotice in plain text without the <copyright> element. A formal paragraph title is added here which makes the copyright notice bold, and makes it much easier to locate. Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com> Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* specs: remove orphan affiliation.Gaetan Nadon2011-09-141-1/+0
| | | | | | Authors affiliation are correct. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* specs: use appropriate markup for Copyright statementsGaetan Nadon2011-09-131-5/+5
| | | | | | Also move <releaseinfo> to match order of appearance Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* docs: use the &fullrelvers; entity to set X11 release informationGaetan Nadon2011-09-124-8/+20
| | | | Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* docs: remove <productnumber> which is not used by defaultGaetan Nadon2011-09-112-2/+0
| | | | | | | | This element is not rendered by default on the title. A template customization is required to display it. X Window System does not have a product number. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* docs: use the &fullrelvers; entity to set X11 release informationGaetan Nadon2011-09-111-2/+6
| | | | Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* docs: remove orphan <affiliation>Gaetan Nadon2011-09-111-2/+0
| | | | | | | Somehow created during the conversion from roff. Unable to locate the author to which it belongs. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* docs: remove <productnumber> which is not used by defaultGaetan Nadon2011-09-111-1/+0
| | | | | | | | This element is not rendered by default on the title. A template customization is required to display it. X Window System does not have a product number. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* docbook.am: embed css styles inside the HTML HEAD elementGaetan Nadon2011-09-091-4/+0
| | | | | | | | | | | | Rather than referring to the external xorg.css stylesheet, embed the content of the file in the html output produced. This is accomplished by using version 1.10 of xorg-xhtml.xsl. This makes the whole html docs tree much more relocatable. In addition, it eliminates xorg.css as a runtime file which makes xorg-sgml-doctools a build time only package. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* compose: upgrade makefile to support olinking on chunked htmlGaetan Nadon2011-09-092-10/+133
| | | | | | | | | | | | | | | The essential differences over the regular docbook.am are: Adding root.filename parameter for naming of chapters html files. Using xhtml xmlto format and xorg-chunk.xsl stylesheet Set olink.base.uri for pdf but not for chunked html Olink is not applicable to ps and txt formats. Html chapters are added to shelf_DATA as they are also installed. The xml is generated from a perl script and not distributed. Requires version 1.10 of xorg-sgml-doctools. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* libX11 specs: review doclifter generated tablesGaetan Nadon2011-08-199-274/+192
| | | | | | | | 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@videotron.ca>
* credits.xml: remove toc from AcknowledgmentsGaetan Nadon2011-08-191-8/+8
| | | | | | | | | 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@videotron.ca>
* libX11 specs: move </para> above <varaiablelist>Gaetan Nadon2011-08-1915-463/+408
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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@videotron.ca>
* compose specs: generate chunked htmlGaetan Nadon2011-08-191-1/+1
| | | | | | | | | | | | | 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@oracle.com> Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* specs: build compose keys tables in specs/i18n/composeGaetan Nadon2011-08-054-1/+420
| | | | | | | | | | | | | | | | | | | | | | 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@oracle.com> Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* Add id attributes to error codes to allow linking from other docs.Matt Dew2011-07-171-17/+17
| | | | | | Signed-off-by: Matt Dew <marcoz@osource.org> Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com> Acked-by: Gaetan Nadon <memsize@videotron.ca>
* Remove unused xmlrules.in in specs, now in /nlsGaetan Nadon2011-06-221-59/+0
| | | | | | The specs dir has been converted to docbook.am Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* nls: move xmlrules.in from specs to nlsGaetan Nadon2011-06-151-10/+2
| | | | | | | | | | | | It is no longer used in the specs dir. Remove html from CLEANFILES as it breaks. Make do not clean directories Remove SUFFIXES as pattern rules are used rather than suffix rules. Other improvements are possible, the first priority is to move it out of the specs dir. Acked-by: Peter Hutterer <peter.hutterer@who-t.net> Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
* specs/libX11: Turn appendix references into linksAlan Coopersmith2011-06-072-2/+2
| | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* specs/libX11: Turn chapter references into linksAlan Coopersmith2011-06-078-16/+26
| | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* specs/libX11: Turn many "see section ..." into linksAlan Coopersmith2011-06-0716-76/+124
| | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* specs/libX11: Convert some header filenames to filename tagsAlan Coopersmith2011-06-053-20/+20
| | | | | | perl -i -p -e 's{^&lt;(.*\.h)&gt;\ *}{<filename class="headerfile">&lt;\1&gt;</filename>}' *.xml Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* Add id attributes to funcsynopsis to allow other docs to olink to them.Matt Dew2011-06-042-46/+46
| | | | | | Signed-off-by: Matt Dew <marcoz@osource.org> Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com> Reviewed-by: Gaetan Nadon <memsize@videotron.ca>
* Bug 37624 - parameter x is missing from synopsis of XDrawString in libX11.htmlAlan Coopersmith2011-05-271-1/+2
| | | | | | https://bugs.freedesktop.org/show_bug.cgi?id=37624 Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* Add id's to functions, to make clickable links.Matt Dew2011-05-2416-584/+584
| | | | | Signed-off-by: Matt Dew <marcoz@osource.org> Reviewed-by: Gaetan Nadon <memsize@videotron.ca>
* libX11 spec: fix monospaced column alignment after deligaturizationAlan Coopersmith2011-05-201-1/+1
| | | | Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
* Expand latin ligatures out to their NFKC equivalents.James Cloos2011-05-207-15/+15
| | | | | | | | Ligatures should be done by the typesetting system. Manuscripts should not bother with them. Signed-off-by: James Cloos <cloos@jhcloos.com> Reviewed-by: Keith Packard <keithp@keithp.com>