task

task — A task to be completed.

Synopsis

task ::=

Sequence of:
- One of:
  - Sequence of:
    - Interleave of:
    - info? (db.titleforbidden.info)
  - info (db.titlereq.info)
- tasksummary?
- taskprerequisites?
- One or more of:
  - procedure
- Zero or more of:
  - example
- taskrelated?

Attributes

Common linking attributes.

None.

Additional Constraints

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

Description

A task encapsulates a procedure providing an explicit location for summary information, identifying prerequisites for the task, examples, and pointers to related information.

Processing expectations

Formatted as a displayed block.

Attributes

Common linking attributes.

any attribute: Any attribute in any other explicit namespace

Parents

These elements contain task: 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, taskprerequisites, taskrelated, tasksummary, td, textobject, th, tip, toc, tocdiv, topic, variablelist, warning.

Children

The following elements occur in task: example, info (db.titleforbidden.info), info (db.titlereq.info), procedure, subtitle, taskprerequisites, taskrelated, tasksummary, title, titleabbrev.

Examples

 1 |<article xmlns='http://docbook.org/ns/docbook'>
   |  <title>Example task</title>
   |  <task>
   |    <title>Changing a light bulb</title>
 5 |    <tasksummary>
   |      <para>How to change a light bulb</para>
   |    </tasksummary>
   |    <taskprerequisites>
   |      <para>Make sure you have a new light bulb.</para>
10 |      <para>Make sure you have turned off the light switch.</para>
   |    </taskprerequisites>
   |    <procedure>
   |      <step><para>Remove the old light bulb.</para></step>
   |      <step><para>Insert the new light bulb.</para></step>
15 |      <step><para>Turn on the new light bulb.</para></step>
   |      <step><para>Throw away the old light bulb.</para></step>
   |    </procedure>
   |  </task>
   | 
20 |</article>