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.

Yep.

| |   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
confused.

                                        Cheers,
                                          norm

-- 
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