[Plplot-cvs] CVS update notice (plplot/doc/docbook/src)

[Rafael L. <rla...@us...>]

Update of /cvsroot/plplot/plplot/doc/docbook/src
In directory sc8-pr-cvs1:/tmp/cvs-serv13996/src

Modified Files:
	Makefile.am 
Log Message:
Introduced a makefile target "validate" in doc/docbook/src/Makefile.am, such
that developers can quickly check the integrity of the XML documentation
sources without having to build the documentation.  Generation of file
plplotdoc.xml with the correct DTD is still needed, what implies that
configure can find the DTD.  To the best of my knowledge, there is no way to
avoid this.

The validation is done with the onsgmls program, which is part of the opensp
suite (www.openjade.org).

Typical outputs are like the following.  When there are no problems:

    $ cd doc/docbook/src
    $ make validate
    Validating plplotdoc.xml:
    No problems found.

and when typos are found:

    $ cd doc/docbook/src
    $ make validate
    Validating plplotdoc.xml:
    onsgmls:api.xml:8:7:E: element "uote" undefined
    onsgmls:api.xml:8:17:E: end tag for element "quote" which is not open
    onsgmls:api.xml:13:8:E: end tag for "uote" omitted, but OMITTAG NO was specified
    onsgmls:api.xml:8:2: start tag was here
    make: *** [validate] Error 1

When the onsgmls program has not been detected by donfigure, this is what
happens:

    $ cd doc/docbook/src
    $ make validate
    I cannot validate plplotdoc.xml because program onsgmls is unavailable