This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
RE: [docbook] marking up reserved words
- From: "Mauritz Jeanson" <mj at johanneberg dot com>
- To: "'Wolfgang Jeltsch'" <wolfgang at jeltsch dot net>, "'DocBook List'" <docbook at lists dot oasis-open dot org>
- Date: Fri, 5 Nov 2004 18:40:34 +0100
- Subject: RE: [docbook] marking up reserved words
> -----Original Message-----
> From: Wolfgang Jeltsch
> Am Donnerstag, 4. November 2004 19:18 schrieb Mauritz Jeanson:
> > [...]
>
> > Hello Bob,
> > How about <token>?
>
> Not so good, in my opinion. From "DocBook: The Definitive
> Guide 2.0.10
> (Alpha)":
>
> A Token identifies a unit of information. Usually,
> "tokens" are the result
> of some processing pass that has performed lexical
> analysis and divided a
> data set into the smallest units of information used for
> subsequent
> processing.
>
> So token elements in DocBook are mostly for tokens which are
> output by a
> lexer. These cover reserved words but cover also several
> other kinds of
> data. That's why I think that the token element is not so
> appropriate.
Markup semantics is not easy... It would be nice to have more good examples
in the TDG.
I found a passing remark about <token> and reserved words here:
http://www.dpawson.co.uk/docbook/markup.html#d369e782
/MJ