This is the mail archive of the
mailing list for the DocBook project.
[docbook] Repeatable segmentedlist?
- From: Jeff Beal <jeff dot beal at ansys dot com>
- To: "DocBook Mailing List (E-mail)" <docbook at lists dot oasis-open dot org>
- Date: Wed, 21 May 2003 15:57:52 -0400
- Subject: [docbook] Repeatable segmentedlist?
The product we are documenting is an old command-driven application with a
GUI added on top. Whenever we provide instructions to the user, we try to
provide both the relevant command and the menupaths through the GUI. We
have hundreds, if not thousands, of instructions like the following:
"From within the ANSYS program, you can use either of the following:
Utility Menu> File> Change Jobname"
Each command can potentially have several menupaths, and many of these
"lists" document several commands at once. So we also have:
Right now, we've been tagging these as <variablelist>:
It would be nice if we could use <segmentedlist> instead of <variablelist>
and set up a "master" <segmentedlist> that includes the segtitles, and all
other lists of this type pull the segtitles from that list, as in:
<seg><guimenu>Utility Menu> File> Change Jobname</guimenu></seg>
As I see it, this is a relatively minor DTD change (add the 'segtitleref'
attribute, make segitle optional) and it makes the <segmentedlist> much more
useful. Does anybody have any thoughts on this matter, or any suggestions
on other ways I could more easily mark up this sort of repeating pattern?
To unsubscribe, e-mail: firstname.lastname@example.org
For additional commands, e-mail: email@example.com