This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
[docbook] [docbook 4.3] the syntax of code listings
- From: Tobias Reif <tobiasreif at pinkjuice dot com>
- To: docbook at lists dot oasis-open dot org
- Date: Fri, 22 Aug 2003 11:35:15 +0200
- Subject: [docbook] [docbook 4.3] the syntax of code listings
Hi
4.3b2 adds a an attribute "language" to linespecific.attrib.
1.
I think the attribute should be called "syntax", or there should be
attributes "language" and "syntax".
If an application processing DocBook can find out which syntax is used
in code snippets or listings it can do syntax markup and syntax
highlighting. [use case]
Sets of languages share on syntax. For example: the DBX and SVG
languages are written using the XML syntax. The syntax highlighter might
handle XML but not SVG, so I need to be able to specify syntax="XML".
Other languages can be written in several syntaxes, Relax NG for example
has two syntaxes.
So when the app sees
<programlisting language="RNG">[...]</programlisting>
it still doesn't know which syntax is used, and can't do syntax
highlighting or any other action based on the syntax.
2.
I think an attribute "syntax" should also be added to element "code".
Tobi
[use case]
eg
http://www.pinkjuice.com/howto/vimxml/setup.xml#catalogs
role="XML" is (ab)used until there is syntax="XML"
--
http://www.pinkjuice.com/
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org