Re: vs

Tom Lane writes:

> More generally, what are the standard set of markup tags that should be
> used?  I know that I tend to overuse <literal>foo</> because I'm not
> clear on the alternatives like <type>, <envar>, <option>, yadda yadda.
> It'd help if there were a list somewhere.


At docbook.org you can download (read online, buy, ...) "DocBook: The
Definitive Guide", which contains introductions to SGML, XML, DocBook,
stylesheets, plus a complete reference of all elements, what they're for
and what can go where.  I use it nearly every day.

As for what tags to use, it's difficult to keep track of the over a
hundred elements that DocBook has, but "when in doubt, use <literal>"
seems like a reasonable thing to do and it seems to fit the idea of the
element.

One day we might want to add some tags that fit our domain better, such as
<sqlcode> or <databaseobject>.

--
Peter Eisentraut   peter_e@gmx.net