OL (Ordered List)

The OL tag defines an ordered list of items within an information region.

Syntax


>>-<OL--+---------+--+--------+--+----------------+------------->
        '-COMPACT-'  '-NOSKIP-'  |        .-NO--. |   
                                 '-SPACE=-+-YES-+-'   

>--+----------+--+----------------------+-->--</OL>------------><
   '-INDENT=n-'  '-TEXT=OL-heading-text-'

Parameters

COMPACT

This attribute causes the list to be formatted without a blank line between the list items.

NOSKIP

This attribute causes the list to format without creating a blank line before the first line of the list.

SPACE=NO | YES

The SPACE attribute controls the indentation space for the list item. When the SPACE attribute is not specified on the LI tag, the SPACE attribute from the OL tag is used to set the indentation space for the nested LI tag item-text.

When SPACE=YES, the indentation is set to 3 spaces. When SPACE=NO (or SPACE is not specified), the indentation is set to 4 spaces.

The SPACE attribute can be used to control the alignment of list items when the first word of some list items is a DBCS word preceded by a shift-out

INDENT=n

This attribute specifies that the list be indented from the current left margin.

TEXT=OL-heading-text

This attribute causes the list to format with a heading line containing the OL-heading-text.

Comments

The OL tag defines an ordered list of items within an information region. You use ordered lists to indicate a set of sequential items or steps. You can code the OL tag anywhere within an information region.

Ordered lists are formatted as indented lists, with sequential numbers or letters at the left margin of the list items. Nested lists (lists embedded within other lists) indent four spaces to the right of the left margin of the list that contains them.

Note: The SPACE attribute does not affect the indentation of nested lists.

The conversion utility adds a blank line before the first item in the list.

Sequential numbers or letters, depending on the nesting level of the ordered list precede the list items. The levels are:

Level 1: 1., 2., 3., . . .
Level 2: a., b., c., . . .
Level 3: 1), 2), 3), . . .
Level 4: a), b), c), . . .

Any additional levels repeat the sequence from level 1.

Panels formatted with the DBCS option use uppercase alphabetic characters for the even-numbered nesting levels.

Use the LI tag to denote each list item. See LI (List Item) for more information on the LI tag.

Restrictions

The OL tag requires an end tag.
You must code the OL tag within an INFO definition. See INFO (Information Region) for a complete description of this tag.

Processing

Table 1. Tags you can code within an OL definition
Tag	Reference	Usage	Required
LI	LI (List Item)	Multiple	No
LP	LP (List Part)	Multiple	No

Examples

Here is help panel markup that contains two ordered lists and a paragraph. The second ordered list and the paragraph are nested within the first list. Figure 1 shows the formatted result.

<!DOCTYPE DM SYSTEM>

<HELP NAME=ol DEPTH=22 WIDTH=60>Widget Assembly Help
<AREA>
<INFO>
  <P>To assemble your new Widget, you should:
  <OL>
    <LI>Attach the gizmo flexure component to the
    main steering mechanism of the doohickey.
      <OL COMPACT>
        <LI>If slot A fits snugly on retaining
        pin B, proceed to step 2.
        <LI>If slot A does not fit snugly on
        retaining pin B, throw the Widget away
        and buy a new one.
      </OL>
    <LI>Use a screwdriver to turn the power drive unit on.
    <LI>Stand back and watch the fun!
      <P>Wake up the kids and call the neighbors, they won't
      want to miss it!
  </OL>
</INFO>
</AREA>
</HELP>

Figure 1. Ordered lists

                    Widget Assembly Help

 To assemble your new Widget, you should:

 1.  Attach the gizmo flexure component to the main
     steering mechanism of the doohickey.

     a.  If slot A fits snugly on retaining pin B, proceed
         to step 2.
     b.  If slot A does not fit snugly on retaining pin B,
         throw the Widget away and buy a new one.

 2.  Use a screwdriver to turn the power drive unit on.

 3.  Stand back and watch the fun!

     Wake up the kids and call the neighbors, they won't
     want to miss it!

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