• Gaetan Nadon's avatar
    Documentation: add Docbook external references support · ee435d73
    Gaetan Nadon authored
    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 feature works with PDF, HTML, PS (and epub?) generated documents
    and will generate links to the other versions of the same type, i.e. html
    docs will link to other html docs,  and pdf docs will link to other pdf
    docs.
    
    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's avatarMatt Dew <marcoz@osource.org>
    Acked-by: Dan Nicholson's avatarDan Nicholson <dbn.lists@gmail.com>
    Signed-off-by: Gaetan Nadon's avatarGaetan Nadon <memsize@videotron.ca>
    ee435d73
.gitignore 1 KB