<!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>@chapter (GNU Texinfo 6.7)</title>
<meta name="description" content="@chapter (GNU Texinfo 6.7)">
<meta name="keywords" content="@chapter (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="_0040unnumbered-_0040appendix.html" rel="next" title="@unnumbered @appendix">
<link href="Structuring-Command-Types.html" rel="prev" title="Structuring Command Types">
<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_0040chapter"></span><div class="header">
<p>
Next: <a href="_0040unnumbered-_0040appendix.html" accesskey="n" rel="next"><code>@unnumbered @appendix</code></a>, Previous: <a href="Structuring-Command-Types.html" accesskey="p" rel="prev">Structuring Command Types</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_0040chapter_003a-Chapter-Structuring"></span><h3 class="section">5.3 <code>@chapter</code>: Chapter Structuring</h3>
<span id="chapter"></span><span id="index-chapter"></span>
<p><code>@chapter</code> identifies a chapter in the document–the highest
level of the normal document structuring hierarchy. Write the command
at the beginning of a line and follow it on the same line by the title
of the chapter. The chapter is numbered automatically, starting
from 1.
</p>
<p>For example, the present chapter in this manual is entitled
“<code>@chapter</code>: Chapter Structuring”; the <code>@chapter</code> line
looks like this:
</p>
<div class="example">
<pre class="example">@chapter @code{@@chapter}: Chapter Structuring
</pre></div>
<p>In TeX, the <code>@chapter</code> command produces a chapter heading in
the document.
</p>
<p>In Info and plain text output, the <code>@chapter</code> command causes the
title to appear on a line by itself, with a line of asterisks inserted
underneath. So, the above example produces the following output:
</p>
<div class="example">
<pre class="example">5 Chapter Structuring
*********************
</pre></div>
<p>In HTML, the <code>@chapter</code> command produces an <code><h2></code>-level
header by default (controlled by the <code>CHAPTER_HEADER_LEVEL</code>
customization variable, see <a href="Other-Customization-Variables.html">Other Customization Variables</a>).
</p>
<p>In the XML and Docbook output, a <code><chapter></code> element is produced
that includes all the following sections, up to the next chapter.
</p>
</body>
</html>