`<cause>`

The <cause> element describes a potential source of the problem that is addressed by the troubleshooting topic.

Usage information

The <cause> element is a component of a potential solution. The cause might be omitted if it is implicit or if the remedy is not associated with a cause.

Specialization hierarchy

The <cause> element is specialized from <section>. It is defined in the troubleshooting module.

Content model

<title>?(<audio> | <dl> | <div> | <example> | <fig> | <image> | <lines> | <lq> | <note> | <object> | <ol> | <p> | <pre> | <simpletable> | <sl> | <table> | <ul> | <video> | <data> | <foreign> | <draft-comment> | <fn> | <indexterm> | <required-cleanup>)*?

Contained by

<troubleSolution>

Optional Optional <title>Zero or more of the following

<audio>
<data>
<div>
<dl>
<draft-comment>
<example>
<fig>
<fn>
<foreign>
<image>
<indexterm>
<lines>
<lq>
<note>
<object>
<ol>
<p>
<pre>
<required-cleanup>
<simpletable>
<sl>
<table>
<ul>
<video>

Contained by

<troubleSolution>

Inheritance

- topic/section troubleshooting/cause

The <cause> element is specialized from <section>. It is defined in the troubleshooting module.

Attributes

The following attributes are available on this element: universal attributes.

Example

This section is non-normative.

In the following code sample, the <cause> element contains information that explains the origins of the problem:

<troubleshooting id="simple-example">
  <title>System will not turn on</title>
  <troublebody>
    <condition>The system is plugged in and powered up, but the system will not start.
    </condition>
    <troubleSolution>
      <!-- . . . -->
      <cause>The problem is usually due to the power not being supplied to the system through
             the electrical outlet. Often, a circuit breaker has been tripped so that no
             power is available at the outlet.</p>
      </cause>
      <!-- . . . -->
    </troubleSolution>
    <!-- . . . -->
  </troublebody>
</troubleshooting>