@itemize
: Making an Itemized List ¶The @itemize
command produces a sequence of “items”, each
starting with a bullet or other mark inside the left margin, and
generally indented.
Begin an itemized list by writing @itemize
at the beginning of
a line. Follow the command, on the same line, with a Texinfo command
or character to generate a mark. Usually, you will use @bullet
after @itemize
, but you can use @minus
, or any other
Texinfo command or character. If you don’t specify a mark command,
the default is @bullet
.
After the @itemize
, write your items, each starting with
@item
. Text can follow on the same line as the @item
.
The text of an item can continue for more than one paragraph.
Here is an example of the use of @itemize
:
@itemize @bullet{} @item Some text for foo. @item Some text for bar. @end itemize
This produces:
- Some text for foo.
- Some text for bar.
When you give a mark command such as @bullet
as the argument
to @itemize
command, you may omit the ‘{}’ that would
normally follow the command.
If you don’t want any mark at all, but still want logical items, use
@w{}
(in this case the braces are required).
There should be at least one @item
inside the @itemize
environment. If none are present, texi2any
gives a warning.
If you just want indented text and not a list of items, use
@indentedblock
; see @indentedblock
: Indented text blocks.
Index entries that occur immediately before an @item
are associated with the @item
.
Usually, you should put a blank line between items. This puts a blank line in the Info file. (TeX inserts the proper vertical space in any case.) Except when the entries are very brief, these blank lines make the list look better.
Itemized lists may be embedded within other itemized lists. Here is a list marked with dashes embedded in a list marked with bullets:
@itemize @bullet{} @item First item. @itemize @minus{} @item Inner item. @item Second inner item. @end itemize @item Second outer item. @end itemize
This produces:
- First item.
- Inner item.
- Second inner item.
- Second outer item.