DocBook: The Definitive Guide

docbook: the definitive guide
By Norman Walsh & Leonard Muellner
1st Edition October 1999
1-56592-580-7, Order Number: 5807
652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
PrevNext

Name

Procedure -- A list of operations to be performed in a well-defined sequence

Synopsis

Content Model

Procedure ::= ((Title,TitleAbbrev?)?,  (CalloutList|GlossList|ItemizedList|OrderedList|SegmentedList|   SimpleList|VariableList|Caution|Important|Note|Tip|Warning|   LiteralLayout|ProgramListing|ProgramListingCO|Screen|ScreenCO|   ScreenShot|Synopsis|CmdSynopsis|FuncSynopsis|FormalPara|Para|   SimPara|Address|BlockQuote|Graphic|GraphicCO|MediaObject|   MediaObjectCO|InformalEquation|InformalExample|InformalFigure|   InformalTable|Equation|Example|Figure|Table|MsgSet|Procedure|   Sidebar|QandASet|Anchor|BridgeHead|Comment|Highlights|Abstract|   AuthorBlurb|Epigraph|IndexTerm)*,  Step+)

Attributes

Common attributes

Tag Minimization

Both the start- and end-tags are required for this element.

Parameter Entities

%admon.mix;%bookcomponent.content;%component.mix;
%compound.class;%divcomponent.mix;%qandaset.mix;
%refcomponent.mix;%sidebar.mix;

Description

A Procedure encapsulates a task composed of Steps (and possibly, SubSteps). Procedures are usually performed sequentially, unless individual Steps direct the reader explicitly.

Often it is important to assure that certain conditions exist before a procedure is performed, and that the outcome of the procedure matches the expected results. DocBook does not provide explicit semantic markup for these pre- and post-conditions. Instead, they must be described as steps (check the pre-conditions in the first step and the results in the last step), or described outside the body of the procedure.

Processing expectations

Formatted as a displayed block.

Parents

These elements contain Procedure: Answer, Appendix, Article, BiblioDiv, Bibliography, BlockQuote, Callout, Caution, Chapter, Glossary, GlossDiv, Important, Index, ListItem, MsgExplan, MsgText, Note, PartIntro, Preface, Procedure, QandADiv, QandASet, Question, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, Sect1, Sect2, Sect3, Sect4, Sect5, Section, SetIndex, Sidebar, SimpleSect, Step, Tip, Warning.

Children

The following elements occur in Procedure: Abstract, Address, Anchor, AuthorBlurb, BlockQuote, BridgeHead, CalloutList, Caution, CmdSynopsis, Comment, Epigraph, Equation, Example, Figure, FormalPara, FuncSynopsis, GlossList, Graphic, GraphicCO, Highlights, Important, IndexTerm, InformalEquation, InformalExample, InformalFigure, InformalTable, ItemizedList, LiteralLayout, MediaObject, MediaObjectCO, MsgSet, Note, OrderedList, Para, Procedure, ProgramListing, ProgramListingCO, QandASet, Screen, ScreenCO, ScreenShot, SegmentedList, Sidebar, SimPara, SimpleList, Step, Synopsis, Table, Tip, Title, TitleAbbrev, VariableList, Warning.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

In some contexts, the following elements are excluded: Caution, Equation, Example, Figure, Important, IndexTerm, InformalTable, Note, Table, Tip, Warning.

Examples

<!DOCTYPE procedure PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <procedure><title>An Example Procedure</title> <step>   <para>     A Step   </para> </step> <step>   <para>     Another Step   </para>   <substeps>     <step>       <para>         Substeps can be nested indefinitely deep.       </para>     </step>   </substeps> </step> <step>   <para>     A Final Step   </para> </step> </procedure>

An Example Procedure

  1. A Step

  2. Another Step

    1. Substeps can be nested indefinitely deep.

  3. A Final Step


PrevHomeNext
PrintHistoryUpProductName

Back to: DocBook: The Definitive Guide


O'Reilly Home | O'Reilly Bookstores | How to Order | O'Reilly Contacts
International | About O'Reilly | Affiliated Companies

© 1999, O'Reilly & Associates, Inc.



DocBook. The Definitive Guide
DocBook 5: The Definitive Guide
ISBN: 0596805020
EAN: 2147483647
Year: 1999
Pages: 412
Authors: Walsh Norman, Richard L. Hamilton
BUY ON AMAZON

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net