gnome-doc-utils 0.18.1

gnome-doc-utils is a collection of documentation utilities for the Gnome project. gnome-doc-utils contains a collection of documentation utilities for the Gnome desktop. Notably, it contains utilities for building documentation and all auxiliary files in your source tree, and it contains the XSLT stylesheets DocBook that were once distributed with Yelp. From Gnome 2.8, Yelp will require gnome-doc-utils for the XSLT transformation. ORGANIZATIONtest / The test directory contains a number of tests for gnome-doc-utils. Directories of testdocn form, where n is a positive integer, trees are a source containing skeletal material, with the provision, which is used in real projects. The directory contains unit tests testdoc from docbook-testdoc developed by Norm and Co. for the pan-DocBook stylesheets Galactic. A README file is added to this directory, giving instructions on the extension or modification of any of the files in doc gnome - CVS.doc utils / The doc directory contains documentation for gnome-doc-utils. In most cases, gnome-doc-utils is needed to build its documentation. Mechanisms are in place to bootstrapping.xslt / XSLT The directory contains all XSLT in gnome-doc-utils. Notably, the xslt / docbook directory contains the DocBook XSLT, and XSLT / gettext provides gettext utility XSLT for automatic translation of texts. sandbox / The working directory is not DistEd, so it appears as if you have a CVS checkout. This is a new playground ideas.xml2po / xml2po The directory contains the tool developed by Danilo Segan xml2po for translating arbitrary XML formats. It is used by gnome-doc-utils for translating DocBook. TESTINGUnder the test directory are a number of tests for gnome-doc-utils. To test the build system (gnome-doc-utils.m4 and gnome-doc-utils.make), you can use one of testdocn (for na positive integer) directories. It is set up as a source of skeletal trees, behave exactly like a real project would. Also, gnome-doc-utils itself uses to build its own documentation (in doc), if gnome-doc-utils is itself a test of construction tools. To test the DocBook stylesheets, use the test / directory testdoc. These tests are based unit of package docbook-testdoc on docbook.SourceForge.net developed by Norm and Co. simply typing make in this directory will be the construction of each test. If the filename is foo.001.xml test, the output will html/foo.001/foo.001.html. Each test usually tests a small number of items related DocBook. Many features of DocBook or XSLT transformation in gnome-doc-utils could not be tested by them. Additional tests may be added, follow the instructions in Test testdoc / README for this. Also useful for testing the XSLT is to transform some great documents to use. The Gnome User Guide and Manual Gnumeric are both excellent test docs. More HACKINGUnlike C programming, working on a large part of gnome-doc-utils is really isolated involve incremental improvements. There is no way to give a short list of general features in a TODO list. To work on the build tools (gnome-doc-utils. m4 and gnome-doc-utils.make), strengthening the docs test and see what does not. gnome-doc-utils.make has a list of all the high level objectives which must be fully supported. To work on the DocBook XSLT, find something that is not yet implemented and applied. If you have XML Starlet (xmlstar. Sourceforge.net) installed, you can type 'make report.html "in xslt / docbook / html directory to geta nice HTML report on what elements are implemented. There is also a file TODO in this directory with a very short list of matches that need to be done that can not be captured by report.html. Note that the XSLT is documented in line with XSLdoc, which is itself part of gnome-doc -utils. Feel free to work on xsldoc too. The documentation generated by xsldoc is included in the manual in doc / XSLT.