This is the mail archive of the
mailing list for the DocBook project.
Re: Re: Including OS Version information on DocBook elements
/ Karl EICHWALDER <firstname.lastname@example.org> 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 <email@example.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