procedure

procedure — A list of operations to be performed in a well-defined sequence.

Synopsis

procedure ::=

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • type

Additional Constraints

  • If this element is the root element, it must have a version attribute.

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 ensure 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 preconditions in the first step and the results in the last step), or described outside the body of the procedure.

The task element, added to DocBook in V4.3, provides some of this infrastructure.

Processing expectations

Formatted as a displayed block.

Attributes

Common attributes and common linking attributes.

any attribute

Any attribute in any other explicit namespace

type

Identifies the type of procedure

Parents

These elements contain procedure: abstract, acknowledgements, annotation, answer, appendix, article, bibliodiv, bibliography, bibliolist, blockquote, callout, calloutlist, caption (db.caption), caution, chapter, colophon, constraintdef, cover, danger, dedication, entry, example, figure, footnote, glossary, glossdef, glossdiv, glosslist, important, index, indexdiv, informalexample, informalfigure, itemizedlist, legalnotice, listitem, meta (db.meta.content), msgexplan, msgtext, note, orderedlist, para, partintro, preface, procedure, qandadiv, qandaset, question, refsect1, refsect2, refsect3, refsection, refsynopsisdiv, result, revdescription, sect1, sect2, sect3, sect4, sect5, section, setindex, sidebar, simplesect, step, task, taskprerequisites, taskrelated, tasksummary, td, textobject, th, tip, toc, tocdiv, topic, variablelist, warning.

Children

The following elements occur in procedure: address, anchor, annotation, bibliolist, blockquote, bridgehead, calloutlist, caution, classsynopsis, cmdsynopsis, constraintdef, constructorsynopsis, danger, destructorsynopsis, enumsynopsis, epigraph, equation, example, fieldsynopsis, figure, formalgroup, formalpara, funcsynopsis, glosslist, important, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titleonly.info), informalequation, informalexample, informalfigure, informaltable (db.cals.informaltable), informaltable (db.html.informaltable), itemizedlist, literallayout, macrosynopsis, mediaobject, methodsynopsis, msgset, note, orderedlist, packagesynopsis, para, procedure, productionset, programlisting, programlistingco, qandaset, remark, result, revhistory, screen, screenco, screenshot, segmentedlist, sidebar, simpara, simplelist, step, synopsis, table (db.cals.table), table (db.html.table), task, tip, title, titleabbrev, typedefsynopsis, unionsynopsis, variablelist, warning.

Examples

 1 |<article xmlns='http://docbook.org/ns/docbook'>
   |<title>Example procedure</title>
   | 
   |<procedure><title>An Example Procedure</title>
 5 |<step>
   |  <para>A Step</para>
   |</step>
   |<step>
   |  <para>Another Step</para>
10 |  <substeps>
   |    <step>
   |      <para>Substeps can be nested indefinitely deep.</para>
   |    </step>
   |  </substeps>
15 |</step>
   |<step>
   |  <para>A Final Step</para>
   |</step>
   |</procedure>
20 | 
   |</article>
Procedure 1An Example Procedure
  1. A Step

  2. Another Step

    1. Substeps can be nested indefinitely deep.

  3. A Final Step