specs: Fix section titles/nesting

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Docbook: change the book id to match the xml file basename

Rename appgroup.xml as it conflicts with xorg-docs/specs/Xserver/appgroup.xml
This is required for the up-coming external references support.

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Docbook: change the book id to match the xml file basename

This is required for the up-coming external references support.

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Docbook: change the book id to match the xml file basename

This is required for the up-coming external references support.

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Version 7.2.0

Signed-off-by: Keith Packard <keithp@keithp.com>
Documentation: add Docbook external references support

When writing technical documentation, it is often necessary to cross
reference to other information. When that other information is not in the
current document, additional support is needed, namely <olink>.

A new feature with version 1.7 of xorg-sgml-doctools adds references to
other documents within or outside this package.

This patch adds technical support for this feature but does not change
the content of the documentation as seen by the end user.

Each book or article must generate a database containing the href
of sections that can be referred to from another document. This database
is installed in DATAROOTDIR/sgml/X11/dbs. There is a requirement that
the value of DATAROOTDIR for xorg-sgml-doctools and for the package
documentation is the same. This forms a virtual document tree.

This database is consulted by other documents while they are being generated
in order to fulfill the missing information for linking.
Refer to the xorg-sgml-doctools for further technical information.

Co-authored-by: Matt Dew <marcoz@osource.org>

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Add id attributes to funcsynopsis to allow other docs to olink to them.

Signed-off-by: Matt Dew <marcoz@osource.org>
Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Reviewed-by: Gaetan Nadon <memsize@videotron.ca>
Install target dbs alongside generated documents

This matches a change in xorg-sgml-docs whereby the masterdb will look for
the target dbs into the same location as the generated documents.

The target dbs are now installed alongside the generated documents.
Previously they are installed in $prefix/sgml/X11/dbs alongside masterdb which
has the potential of installing outside the package prefix and cause
distcheck to fail when user does not have write permission in this package.

Requires XORG_CHECK_SGML_DOCTOOLS(1.8) which was released 2011-06-11
Install xml versions of specs even if HAVE_XMLTO is false

DocBook/XML input source is also a usefull output format that can be viewed
with an XML viewer or editor and by some O/S help system.

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
docbook.am: global maintenance update - entities, images and olinking

Adding support in libX11 for html chunking caused a reorg of docbook.am
as well as the xorg-sgml-doctools masterdb for olinking.
The parameter img.src.path is added for pdf images.
A searchpath to the root builddir is added for local entities, if present.

The docbook.am makefile hides all the details and is identical for
all 22 modules having DocBook documentation. It is included by a thin
Makefile.am which requires no docbook knowledge.

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
docbook.am: embed css styles inside the HTML HEAD element

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>
Use more appropriate docbook element to get "Edited by"

The proper element to use is <editor>.
The <contrib> was a hack to insert text and showed up in the wrong location

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
docs: remove <productnumber> which is not used by default

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 information

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
sync: fix author name and authors affiliation

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
appgrp: use <copyright> markup and minor titlepage fixes

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
dbe spec: fix author affiliation and copyright notices

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
dpms spec: fix author affiliation

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
evi spec: fix copyright and orphan markup

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
geproto: fix author's e-mail

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>