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: DOCBOOK: Re: New element for Step alternatives?

Hash: SHA1

/ Michael Smith <smith@xml-doc.org> was heard to say:
| Substeps and the proposed Stepalternatives are containers for
| steps. What I'm suggesting is that we add a parallel generalized
| step container, with the same simple (step+) content model, for
| wrapping sets-of-steps-that-aren't-substeps.

Why? What purpose does this new container have?

I think your argument has been that it would allow users to identify
sets-of-steps for reuse (by pointing to the single wrapper). While
that's true...

| The fact that two or more steps in a row, by themselves, form a
| logical division -- a group of steps -- is something that I think
| ought to be expressible/capturable through markup, and so through
| a content model in the DTD.

There are very few semantically meaningless wrappers for grouping
things in DocBook. I could apply the same arguments to a series of
three paragraphs or to two figures and a table.

Maybe we need to consider the reuse question in more detail, but if
we're going to, I'd like to do it separately and globally, not as part
of a small enhancement to procedure.

                                        Be seeing you,

- -- 
Norman Walsh <ndw@nwalsh.com>      | Consistency requires you to be as
http://www.oasis-open.org/docbook/ | ignorant today as you were a year
Chair, DocBook Technical Committee | ago.--Bernard Berenson
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>


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

Powered by eList eXpress LLC