• Gaetan Nadon's avatar
    Documentation: add Docbook external references support · e8c76407
    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 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>
    Signed-off-by: Gaetan Nadon's avatarGaetan Nadon <memsize@videotron.ca>
    e8c76407
docbook.am 3.05 KB