<!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>Raise/lower sections (GNU Texinfo 6.7)</title>
<meta name="description" content="Raise/lower sections (GNU Texinfo 6.7)">
<meta name="keywords" content="Raise/lower sections (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="Cross-References.html" rel="next" title="Cross References">
<link href="_0040part.html" rel="prev" title="@part">
<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="Raise_002flower-sections"></span><div class="header">
<p>
Previous: <a href="_0040part.html" accesskey="p" rel="prev"><code>@part</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="Raise_002flower-Sections_003a-_0040raisesections-and-_0040lowersections"></span><h3 class="section">5.12 Raise/lower Sections: <code>@raisesections</code> and <code>@lowersections</code></h3>
<span id="index-raisesections"></span>
<span id="index-lowersections"></span>
<span id="index-Raising-and-lowering-sections"></span>
<span id="index-Lowering-and-raising-sections"></span>
<span id="index-Sections_002c-raising-and-lowering"></span>
<p>The <code>@raisesections</code> and <code>@lowersections</code> commands
implicitly raise and lower the hierarchical level of following
chapters, sections and the other sectioning commands (excluding parts).
</p>
<p>That is, the <code>@raisesections</code> command changes sections to
chapters, subsections to sections, and so on. Conversely, the
<code>@lowersections</code> command changes chapters to sections, sections
to subsections, and so on. Thus, a <code>@lowersections</code> command
cancels a <code>@raisesections</code> command, and vice versa.
</p>
<span id="index-Include-files_002c-and-section-levels"></span>
<p>You can use <code>@lowersections</code> to include text written as an outer
or standalone Texinfo file in another Texinfo file as an inner,
included file (see <a href="Include-Files.html">Include Files</a>). Typical usage looks like this:
</p>
<div class="example">
<pre class="example">@lowersections
@include somefile.texi
@raisesections
</pre></div>
<p>(Without the <code>@raisesections</code>, all the subsequent
sections in the main file would also be lowered.)
</p>
<p>If the included file being lowered has a <code>@top</code> node, you’ll
need to conditionalize its inclusion with a flag (see <a href="_0040set-_0040value.html"><code>@set @value</code></a>).
</p>
<p>As a practical matter, you generally only want to raise or lower large
chunks, usually in external files as shown above. The final result has
to have menus that take the raising and lowering into account, so you
cannot just arbitrarily sprinkle <code>@raisesections</code> and
<code>@lowersections</code> commands throughout the document.
</p>
<p>Repeated use of the commands continues to raise or lower the
hierarchical level a step at a time. An attempt to raise above
‘chapter’ reproduces chapter commands; an attempt to lower below
‘subsubsection’ reproduces subsubsection commands. Also, lowered
subsubsections and raised chapters will not work with
<code>makeinfo</code>’s feature of implicitly determining node pointers,
since the menu structure cannot be represented correctly.
</p>
<p>Write each <code>@raisesections</code> and <code>@lowersections</code> command
on a line of its own.
</p>
<hr>
<div class="header">
<p>
Previous: <a href="_0040part.html" accesskey="p" rel="prev"><code>@part</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>