<!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>@part (GNU Texinfo 6.7)</title>
<meta name="description" content="@part (GNU Texinfo 6.7)">
<meta name="keywords" content="@part (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="Chapter-Structuring.html" rel="up" title="Chapter Structuring">
<link href="Raise_002flower-sections.html" rel="next" title="Raise/lower sections">
<link href="_0040subsubsection.html" rel="prev" title="@subsubsection">
<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_0040part"></span><div class="header">
<p>
Next: <a href="Raise_002flower-sections.html" accesskey="n" rel="next">Raise/lower sections</a>, Previous: <a href="_0040subsubsection.html" accesskey="p" rel="prev"><code>@subsubsection</code></a>, Up: <a href="Chapter-Structuring.html" accesskey="u" rel="up">Chapter Structuring</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_0040part_003a-Groups-of-Chapters"></span><h3 class="section">5.11 <code>@part</code>: Groups of Chapters</h3>
<span id="index-part"></span>
<span id="index-Part-pages"></span>
<p>The final sectioning command is <code>@part</code>, to mark a <em>part</em> of
a manual, that is, a group of chapters or (rarely) appendices. This
behaves quite differently from the other sectioning commands, to fit
with the way such “parts” are conventionally used in books.
</p>
<p>No <code>@node</code> command is associated with <code>@part</code>. Just write
the command on a line by itself, including the part title, at the
place in the document you want to mark off as starting that part. For
example:
</p>
<div class="example">
<pre class="example">@part Part I:@* The beginning
</pre></div>
<p>As can be inferred from this example, no automatic numbering or
labeling of the <code>@part</code> text is done. The text is taken as-is.
</p>
<p>Because parts are not associated with nodes, no general text can
follow the <code>@part</code> line. To produce the intended output, it
must be followed by a chapter-level command (including its node).
Thus, to continue the example:
</p>
<div class="example">
<pre class="example">@part Part I:@* The beginning
@node Introduction
@chapter Introduction
...
</pre></div>
<p>In the TeX output, the <code>@part</code> text is included in both the
normal and short tables of contents (see <a href="Contents.html">Contents</a>), without a page
number (since that is the normal convention). In addition, a “part
page” is output in the body of the document, with just the
<code>@part</code> text. In the example above, the <code>@*</code> causes a
line break on the part page (but is replaced with a space in the
tables of contents). This part page is always forced to be on an odd
(right-hand) page, regardless of the chapter pagination
(see <a href="_0040setchapternewpage.html"><code>@setchapternewpage</code></a>).
</p>
<p>In the HTML output, the <code>@part</code> text is similarly included in
the tables of contents, and a heading is included in the main document
text, as part of the following chapter or appendix node.
</p>
<p>In the XML and Docbook output, the <code><part></code> element includes all
the following chapters, up to the next <code><part></code>. A <code><part></code>
containing chapters is also closed at an appendix.
</p>
<p>In the Info and plain text output, <code>@part</code> has no effect.
</p>
<p><code>@part</code> is ignored when raising or lowering sections (see next
section). That is, it is never lowered and nothing can be raised to it.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Raise_002flower-sections.html" accesskey="n" rel="next">Raise/lower sections</a>, Previous: <a href="_0040subsubsection.html" accesskey="p" rel="prev"><code>@subsubsection</code></a>, Up: <a href="Chapter-Structuring.html" accesskey="u" rel="up">Chapter Structuring</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>