== paragraphs ==

60 column format:

----------------------------------------------------------------------

This is some text in the first paragraph.

  A small indented paragraph. It is followed by some lines

  containing random whitespace.

The third and final paragraph.

----------------------------------------------------------------------

30 column format:

----------------------------------------------------------------------

This is some text in the first

paragraph.

  A small indented paragraph.

  It is followed by some lines

  containing random

  whitespace.

The third and final paragraph.

----------------------------------------------------------------------

html format:

----------------------------------------------------------------------

<p>

This is some text in the first paragraph.

</p>

<p>

A small indented paragraph.

It is followed by some lines

containing random whitespace.

</p>

<p>

The third and final paragraph.

</p>

----------------------------------------------------------------------

== definitions ==

60 column format:

----------------------------------------------------------------------

A Term

  Definition. The indented lines make up the definition.

Another Term

    Another definition. The final line in the definition

    determines the indentation, so this will be indented

    with four spaces.

  A Nested/Indented Term

    Definition.

----------------------------------------------------------------------

30 column format:

----------------------------------------------------------------------

A Term

  Definition. The indented

  lines make up the

  definition.

Another Term

    Another definition. The

    final line in the

    definition determines the

    indentation, so this will

    be indented with four

    spaces.

  A Nested/Indented Term

    Definition.

----------------------------------------------------------------------

html format:

----------------------------------------------------------------------

<dl>

 <dt>A Term

 <dd>Definition. The indented lines make up the definition.

 <dt>Another Term

 <dd>Another definition. The final line in the definition determines the indentation, so this will be indented with four spaces.

 <dt>A Nested/Indented Term

 <dd>Definition.

</dl>

----------------------------------------------------------------------

== literals ==

60 column format:

----------------------------------------------------------------------

The fully minimized form is the most convenient form:

  Hello

    literal

      world

In the partially minimized form a paragraph simply ends with

space-double-colon.

  ////////////////////////////////////////

  long un-wrapped line in a literal block

  \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

  This literal block is started with '::',

    the so-called expanded form. The paragraph

      with '::' disappears in the final output.

----------------------------------------------------------------------

30 column format:

----------------------------------------------------------------------

The fully minimized form is

the most convenient form:

  Hello

    literal

      world

In the partially minimized

form a paragraph simply ends

with space-double-colon.

  ////////////////////////////////////////

  long un-wrapped line in a literal block

  \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

  This literal block is started with '::',

    the so-called expanded form. The paragraph

      with '::' disappears in the final output.

----------------------------------------------------------------------

html format:

----------------------------------------------------------------------

<p>

The fully minimized form is the most

convenient form:

</p>

<pre>

Hello

  literal

    world

</pre>

<p>

In the partially minimized form a paragraph

simply ends with space-double-colon.

</p>

<pre>

////////////////////////////////////////

long un-wrapped line in a literal block

\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

</pre>

<pre>

This literal block is started with '::',

  the so-called expanded form. The paragraph

    with '::' disappears in the final output.

</pre>

----------------------------------------------------------------------

== lists ==

60 column format:

----------------------------------------------------------------------

- This is the first list item.

  Second paragraph in the first list item.

- List items need not be separated by a blank line.

- And will be rendered without one in any case.

We can have indented lists:

  - This is an indented list item

  - Another indented list item:

      - A literal block in the middle

            of an indented list.

      (The above is not a list item since we are in the literal block.)

  Literal block with no indentation (apart from

  the two spaces added to all literal blocks).

1. This is an enumerated list (first item).

2. Continuing with the second item.

(1) foo

(2) bar

1) Another

2) List

Line blocks are also a form of list:

This is the first line. The line continues here.

This is the second line.

Bullet lists are also detected:

* This is the first bullet

* This is the second bullet It has 2 lines

* This is the third bullet

----------------------------------------------------------------------

30 column format:

----------------------------------------------------------------------

- This is the first list item.

  Second paragraph in the

  first list item.

- List items need not be

  separated by a blank line.

- And will be rendered without

  one in any case.

We can have indented lists:

  - This is an indented list

    item

  - Another indented list

    item:

      - A literal block in the middle

            of an indented list.

      (The above is not a list item since we are in the literal block.)

  Literal block with no indentation (apart from

  the two spaces added to all literal blocks).

1. This is an enumerated list

   (first item).

2. Continuing with the second

   item.

(1) foo

(2) bar

1) Another

2) List

Line blocks are also a form of

list:

This is the first line. The

line continues here.

This is the second line.

Bullet lists are also

detected:

* This is the first bullet

* This is the second bullet It

  has 2 lines

* This is the third bullet

----------------------------------------------------------------------

html format:

----------------------------------------------------------------------

<ul>

 <li> This is the first list item.

<p>

Second paragraph in the first list item.

</p>

 <li> List items need not be separated   by a blank line.

 <li> And will be rendered without   one in any case.

</ul>

<p>

We can have indented lists:

</p>

<ul>

 <li> This is an indented list item

 <li> Another indented list item:

<pre>

- A literal block in the middle

      of an indented list.

</pre>

<pre>

(The above is not a list item since we are in the literal block.)

</pre>

</ul>

<pre>

Literal block with no indentation (apart from

the two spaces added to all literal blocks).

</pre>

<ol>

 <li> This is an enumerated list (first item).

 <li> Continuing with the second item.

 <li> foo

 <li> bar

 <li> Another

 <li> List

</ol>

<p>

Line blocks are also a form of list:

</p>

<ol>

 <li> This is the first line.   The line continues here.

 <li> This is the second line.

</ol>

<p>

Bullet lists are also detected:

</p>

<ul>

 <li> This is the first bullet

 <li> This is the second bullet   It has 2 lines

 <li> This is the third bullet

</ul>

----------------------------------------------------------------------

== options ==

60 column format:

----------------------------------------------------------------------

There is support for simple option lists, but only with long

options:

 -X --exclude filter  an option with a short and long option

                      with an argument

 -I --include         an option with both a short option and

                      a long option

    --all             Output all.

    --both            Output both (this description is quite

                      long).

    --long            Output all day long.

    --par             This option has two paragraphs in its

                      description. This is the first.

                      This is the second.  Blank lines may

                      be omitted between options (as above)

                      or left in (as here).

The next paragraph looks like an option list, but lacks the

two-space marker after the option. It is treated as a normal

paragraph:

--foo bar baz

----------------------------------------------------------------------

30 column format:

----------------------------------------------------------------------

There is support for simple

option lists, but only with

long options:

 -X --exclude filter  an

                      option

                      with a

                      short

                      and

                      long

                      option

                      with an

                      argumen

                      t

 -I --include         an

                      option

                      with

                      both a

                      short

                      option

                      and a

                      long

                      option

    --all             Output

                      all.

    --both            Output

                      both

                      (this d

                      escript

                      ion is

                      quite

                      long).

    --long            Output

                      all day

                      long.

    --par             This

                      option

                      has two

                      paragra

                      phs in

                      its des

                      criptio

                      n. This

                      is the

                      first.

                      This is

                      the

                      second.

                      Blank

                      lines

                      may be

                      omitted

                      between

                      options

                      (as

                      above)

                      or left

                      in (as

                      here).

The next paragraph looks like

an option list, but lacks the

two-space marker after the

option. It is treated as a

normal paragraph:

--foo bar baz

----------------------------------------------------------------------

html format:

----------------------------------------------------------------------

<p>

There is support for simple option lists,

but only with long options:

</p>

<dl>

 <dt>-X --exclude filter

 <dd>an option with a short and long option with an argument

 <dt>-I --include

 <dd>an option with both a short option and a long option

 <dt>   --all

 <dd>Output all.

 <dt>   --both

 <dd>Output both (this description is quite long).

 <dt>   --long

 <dd>Output all day long.

 <dt>   --par

 <dd>This option has two paragraphs in its description. This is the first.

<p>

This is the second.  Blank lines may be omitted between

options (as above) or left in (as here).

</p>

</dl>

<p>

The next paragraph looks like an option list, but lacks the two-space

marker after the option. It is treated as a normal paragraph:

</p>

<p>

--foo bar baz

</p>

----------------------------------------------------------------------

== fields ==

60 column format:

----------------------------------------------------------------------

a             First item.

ab            Second item. Indentation and wrapping is

              handled automatically.

c:d           a key with colon

efg::hh       a key with many colon

Next list:

small         The larger key below triggers full indentation

              here.

much too large

              This key is big enough to get its own line.

----------------------------------------------------------------------

30 column format:

----------------------------------------------------------------------

a             First item.

ab            Second item.

              Indentation and

              wrapping is

              handled

              automatically.

c:d           a key with colon

efg::hh       a key with many

              colon

Next list:

small         The larger key

              below triggers

              full indentation

              here.

much too large

              This key is big

              enough to get

              its own line.

----------------------------------------------------------------------

html format:

----------------------------------------------------------------------

<dl>

 <dt>a

 <dd>First item.

 <dt>ab

 <dd>Second item. Indentation and wrapping is handled automatically.

 <dt>c:d

 <dd>a key with colon

 <dt>efg::hh

 <dd>a key with many colon

</dl>