task
task — A task to be completed.
Synopsis
task ::=
- Sequence of:
- One of:
tasksummary?taskprerequisites?- One or more of:
- Zero or more of:
taskrelated?
- One of:
Attributes
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.
Parents
These elements contain task: acknowledgements, annotation, answer, appendix, article, bibliodiv, bibliography, bibliolist, blockquote, callout, calloutlist, caption (db.caption), caution, chapter, colophon, constraintdef, cover, dedication, entry, example, figure, footnote, glossary, glossdef, glossdiv, glosslist, important, index, indexdiv, informalexample, informalfigure, itemizedlist, legalnotice, listitem, 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
<article xmlns='http://docbook.org/ns/docbook'>
<title>Example task</title>
<task>
<title>Changing a light bulb</title>
<tasksummary>
<para>How to change a light bulb</para>
</tasksummary>
<taskprerequisites>
<para>Make sure you have a new light bulb.</para>
<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>
<step><para>Turn on the new light bulb.</para></step>
<step><para>Throw away the old light bulb.</para></step>
</procedure>
</task>
</article>