5.6. Lists

The following commands build lists. Note that begin/end pairs must be balanced, and nesting is supported. There are three kinds of lists: numbered lists, which are numbered automatically, bullet lists, which display some special bullet symbol, and keyed lists, which display a string of text for each item.

  @begin_numbered_list(start=1):
  @end_numbered_list():
  @begin_numbered_list_item():
  @end_numbered_list_item():

  @begin_bullet_list():
  @end_bullet_list():
  @begin_bullet_list_item():
  @end_bullet_list_item():

  @begin_keyed_list():
  @end_keyed_list():
  @begin_keyed_list_item(key):
  @end_keyed_list_item():

Here's an example:

  @begin_keyed_list()
  @begin_keyed_list_item('bullet')
  A bullet or similar character at the start of each item.
  @end_keyed_list_item()
  @begin_keyed_list_item('numbered')
  A number at the start of each item.
  @end_keyed_list_item()
  @begin_keyed_list_item('keyed')
  A key, or definition term, at the start of each item.
  @end_keyed_list_item()
  @end_keyed_list()

which comes out like:

bullet: A bullet or similar character at the start of each item.
numbered: A number at the start of each item.
keyed: A key, or definition term, at the start of each item.

5.6.1. Easier lists