<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.7, 23 September 2019),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.
Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019 Free Software
Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled
"GNU Free Documentation License". -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>@itemize (GNU Texinfo 6.7)</title>
<meta name="description" content="@itemize (GNU Texinfo 6.7)">
<meta name="keywords" content="@itemize (GNU Texinfo 6.7)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<link href="index.html" rel="start" title="Top">
<link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Lists-and-Tables.html" rel="up" title="Lists and Tables">
<link href="_0040enumerate.html" rel="next" title="@enumerate">
<link href="Introducing-Lists.html" rel="prev" title="Introducing Lists">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<span id="g_t_0040itemize"></span><div class="header">
<p>
Next: <a href="_0040enumerate.html" accesskey="n" rel="next"><code>@enumerate</code></a>, Previous: <a href="Introducing-Lists.html" accesskey="p" rel="prev">Introducing Lists</a>, Up: <a href="Lists-and-Tables.html" accesskey="u" rel="up">Lists and Tables</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="g_t_0040itemize_003a-Making-an-Itemized-List"></span><h3 class="section">9.2 <code>@itemize</code>: Making an Itemized List</h3>
<span id="itemize"></span><span id="index-itemize"></span>
<span id="index-Itemization"></span>
<p>The <code>@itemize</code> command produces a sequence of “items”, each
starting with a bullet or other mark inside the left margin, and
generally indented.
</p>
<span id="index-_0040w_002c-for-blank-items"></span>
<p>Begin an itemized list by writing <code>@itemize</code> at the beginning of
a line. Follow the command, on the same line, with a character or a
Texinfo command that generates a mark. Usually, you will use
<code>@bullet</code> after <code>@itemize</code>, but you can use
<code>@minus</code>, or any command or character that results in a single
character in the Info file. (When you write the mark command such as
<code>@bullet</code> after an <code>@itemize</code> command, you may omit the
‘<samp>{}</samp>’.) If you don’t specify a mark command, the default is
<code>@bullet</code>. If you don’t want any mark at all, but still want
logical items, use <code>@w{}</code> (in this case the braces are
required).
</p>
<span id="index-item"></span>
<p>After the <code>@itemize</code>, write your items, each starting with
<code>@item</code>. Text can follow on the same line as the <code>@item</code>.
The text of an item can continue for more than one paragraph.
</p>
<p>There should be at least one <code>@item</code> inside the <code>@itemize</code>
environment. If none are present, <code>makeinfo</code> gives a warning.
If you just want indented text and not a list of items, use
<code>@indentedblock</code>; see <a href="_0040indentedblock.html"><code>@indentedblock</code></a>.
</p>
<p>Index entries and comments that are given before an <code>@item</code>
including the first, are automatically moved (internally) to after the
<code>@item</code>, so the output is as expected. Historically this has
been a common practice.
</p>
<p>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.
</p>
<p>Here is an example of the use of <code>@itemize</code>, followed by the
output it produces. <code>@bullet</code> produces an ‘<samp>*</samp>’ in Info and
a round dot in other output formats.
</p>
<div class="example">
<pre class="example">@itemize @bullet
@item
Some text for foo.
@item
Some text
for bar.
@end itemize
</pre></div>
<p>This produces:
</p>
<blockquote>
<ul>
<li> Some text for foo.
</li><li> Some text
for bar.
</li></ul>
</blockquote>
<p>Itemized lists may be embedded within other itemized lists. Here is a
list marked with dashes embedded in a list marked with bullets:
</p>
<div class="example">
<pre class="example">@itemize @bullet
@item
First item.
@itemize @minus
@item
Inner item.
@item
Second inner item.
@end itemize
@item
Second outer item.
@end itemize
</pre></div>
<p>This produces:
</p>
<blockquote>
<ul>
<li> First item.
<ul class="no-bullet">
<li>- Inner item.
</li><li>- Second inner item.
</li></ul>
</li><li> Second outer item.
</li></ul>
</blockquote>
<hr>
<div class="header">
<p>
Next: <a href="_0040enumerate.html" accesskey="n" rel="next"><code>@enumerate</code></a>, Previous: <a href="Introducing-Lists.html" accesskey="p" rel="prev">Introducing Lists</a>, Up: <a href="Lists-and-Tables.html" accesskey="u" rel="up">Lists and Tables</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>