CAUTION (Caution)

The CAUTION tag defines a statement that alerts the user of a possible risk.

Syntax


>>-<CAUTION>--+------+--</CAUTION>-----------------------------><
              '-text-'

Parameters

text: This is the text of the caution statement.

Comments

The CAUTION tag defines a statement that alerts the user of a possible risk. Use the CAUTION tag to alert the user to a condition that might have serious consequences, such as the deletion of a file.

The CAUTION tag is one of the tags that alert the user to a possible risk; the others are ATTENTION and WARNING.

Code a caution statement before the text to which it pertains so that the user can read about the possible risks before reading the text. When a caution statement is displayed, the string "CAUTION:" or its translated equivalent appears on the screen and the caution text displays on the line after.

You can code additional paragraphs of caution text by coding the P (paragraph) tag within a CAUTION definition. You can also code other tags allowed in an information area within a CAUTION definition.

CAUTION text is formatted with an attribute byte that causes it to be emphasized.

Restrictions

The CAUTION tag requires an end tag.
A CAUTION tag must be immediately preceded by an LI, LP, or P tag. See LI (List Item), LP (List Part), and P (Paragraph) for descriptions of these tags.
You must code the CAUTION tag only within an INFO definition. See INFO (Information Region) for a complete description of this tag.
You cannot nest ATTENTION, CAUTION, or WARNING tags within each other.

Processing

Table 1. Tags you can code within a CAUTION definition
Tag	Reference	Usage	Required
DL	DL (Definition List)	Multiple	No
FIG	FIG (Figure)	Multiple	No
HP	HP (Highlighted Phrase)	Multiple	No
LINES	LINES (Lines)	Multiple	No
NOTE	NOTE (Note)	Multiple	No
NOTEL	NOTEL (Note List)	Multiple	No
NT	NT (Note)	Multiple	No
OL	OL (Ordered List)	Multiple	No
P	P (Paragraph)	Multiple	No
PARML	PARML (Parameter List)	Multiple	No
PS	PS (Point-and-Shoot)	Multiple	No
RP	RP (Reference Phrase)	Multiple	No
SL	SL (Simple List)	Multiple	No
UL	UL (Unordered List)	Multiple	No
XMP	XMP (Example)	Multiple	No

Examples

Here is help panel markup that contains a caution statement. Figure 1 shows the formatted result.

<!DOCTYPE DM SYSTEM>

<HELP NAME=caution DEPTH=20>Help for DELETE Command
<AREA>
  <INFO>
    <P>The DELETE command erases the specified file from storage.
    <P><CAUTION>
    Issuing the DELETE command permanently
    removes the file from storage.
    There is no possibility of recovery.
    </CAUTION>
    <P>You can exit from the DELETE operation
    by pressing F12.
  </INFO>
</AREA>
</HELP>

Figure 1. Caution statement

             Help for DELETE Command

 The DELETE command erases the specified file
 from storage.

 CAUTION:
 Issuing the DELETE command permanently removes
 the file from storage. There is no possibility
 of recovery.

 You can exit from the DELETE operation by
 pressing F12.





  F1=Help         F3=Exit         F5=Exhelp
  F6=Keyshelp     F7=PrvTopic     F8=NxtTopic
 F10=PrvPage     F11=NxtPage     F12=Cancel