DocBook 5.1: The Definitive Guide  (Version 1.5.3 for DocBook 5.1)

task

task — A task to be completed.

Synopsis

task ::=

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.

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>