fixed a few small typos, simplified synopsis lines
- some comments - small extension for the future to support a more complex source context reports - guides/programming-style.xml: - small improvement of efficiency in an example - refs/NoCache: - reverted back the content that I accidentally removed - refs/DomainTail: new
- Makefile: - Some corrections to work properly with reduced number of reference sets: ( glob & cat confs -> confs, system & user & ui tags -> tags). - docbook/olink*: - Also corrections/updates to work with compound docs (as above) - Added some new glossary and refs items - bin/refs-autogen: - Hacked in support for EASIER adding of examples. The previous syntax: __NAME__ example <example> <title>Example Title</title> <para> blah blah <programlisting> ... </programlisting> </para> </example> __END__ Is now simply: __NAME__ example: Example Title blah blah <programlisting> ... </programlisting> __END__ (that is, <example> and <para> are assumed, <title> is inserted if you provide a title after a colon). The rationale behind this is that I want sections to be disassociated from the encapsulating elements (<example> in this case) so that we can directly include the text in other contexts, without first having to remove <example> and other context-specific tags from the input. This is a generalization of the idea to have a "preamble" in tags.html and confs.html that describes how to use tags and confs. (As Jon said it'd be nice to preserve that layout like in old docs). - refs/*: - Adjusted 'example' sections to adhere to above convention. Also added some missing bits and fixed few spelling errors.