This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]