OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Subject: Re: DOCBOOK: Re: Including OS Version information on DocBook elements

/ Karl EICHWALDER <ke@gnu.franken.de> was heard to say:
| Okay, you're right.  But simple cases are solvable with marked section
| right now.  You can mark a section as "version-from-1.2-to 2.1" and to
| include this section if appropriate.  AFAIK, nesting and overlapping are
| not possible?

Right. If you're willing to process a combinatorial number of binary
choices, it _might_ be possible with marked sections. As long as none
of them overlap.

| The attribute solution has the following drawbacks: At certain points
| you'll have to add elements to produce a valid DocBook document (two
| title elements in sequence are not allowed) or to add elements to have a
| possibility to add the needed info at all (part of a para element might
| belong to a special version).  The proposed solution is to use phrase
| elements; this was discussed earlier this year.


| |   And using XML instead of SGML makes writing applications to perform
| |   these sorts of semantic transformations nearly infinitely easier.
| Application, yes.  But I've said that it's more convinient for the user
| enter data in SGML (OMITTAG, SHORTTAG); at least, it's easier for some
| users who don't have advanced SGML/XML editors available.

OMITTAG and SHORTTAG are only convenient for the author that uses them.
Some other author, less familiar with the DTD is just going to be


Norman Walsh <ndw@nwalsh.com>      | In all pointed sentences, some
http://www.oasis-open.org/docbook/ | degree of accuracy must be
Member, DocBook Editorial Board    | sacrificed to conciseness.--Samuel
                                   | Johnson

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Powered by eList eXpress LLC