infog/test-infodir/texinfo_html/_0040setchapternewpage.html - texinfo - Git at Google

 <!DOCTYPE html>
 <html>
 <!-- Created by Texinfo 6.8dev+dev, http://www.gnu.org/software/texinfo/ -->
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <!-- This manual is for GNU Texinfo (version 6.8dev, 23 February 2022),
 a documentation system that can produce both online information and a
 printed manual from a single source using semantic markup.

 Copyright (C) 1988, 1990-1993, 1995-1999, 2001-2022 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". -->
 <title>@setchapternewpage (GNU Texinfo 6.8dev)</title>

 <meta name="description" content="@setchapternewpage (GNU Texinfo 6.8dev)">
 <meta name="keywords" content="@setchapternewpage (GNU Texinfo 6.8dev)">
 <meta name="resource-type" content="document">
 <meta name="distribution" content="global">
 <meta name="Generator" content="texi2any">
 <meta name="viewport" content="width=device-width,initial-scale=1">

 <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="Global-Document-Commands.html" rel="up" title="Global Document Commands">
 <link href="Headings.html" rel="next" title="Headings">
 <style type="text/css">
 <!--
 div.example {margin-left: 3.2em}
 -->
 </style>


 </head>

 <body lang="en">
 <div class="section-level-extent" id="g_t_0040setchapternewpage">
 <div class="nav-panel">
 <p>
 Next: <a href="Headings.html" accesskey="n" rel="next">Page Headings</a>, Up: <a href="Global-Document-Commands.html" accesskey="u" rel="up">Global Document Commands</a> &nbsp; [<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>
 <h3 class="section" id="g_t_0040setchapternewpage_003a-Blank-Pages-Before-Chapters">E.1 <code class="code">@setchapternewpage</code>: Blank Pages Before Chapters</h3>

 <a class="anchor" id="setchapternewpage"></a><a class="index-entry-id" id="index-setchapternewpage"></a>
 <a class="index-entry-id" id="index-Starting-chapters"></a>
 <a class="index-entry-id" id="index-Pages_002c-starting-odd"></a>

 <p>In an officially bound book, text is usually printed on both sides of
 the paper, chapters start on right-hand pages, and right-hand pages have
 odd numbers.  But in short reports, text often is printed only on one
 side of the paper.  Also in short reports, chapters sometimes do not
 start on new pages, but are printed on the same page as the end of the
 preceding chapter, after a small amount of vertical whitespace.
 </p>
 <p>You can use the <code class="code">@setchapternewpage</code> command with various
 arguments to specify how TeX should start chapters and whether it
 should format headers for printing on one or both sides of the paper
 (single-sided or double-sided printing).
 </p>
 <p>Write the <code class="code">@setchapternewpage</code> command at the beginning of a
 line followed by its argument.  For example, you would write the
 following to cause each chapter to start on a fresh odd-numbered page:
 </p>
 <div class="example">
 <pre class="example-preformatted">@setchapternewpage odd
 </pre></div>

 <p>You can specify one of three alternatives with the
 <code class="code">@setchapternewpage</code> command:
 </p>
 <dl class="table">
 <dt><code class="code">@setchapternewpage off</code></dt>
 <dd><p>Cause TeX to typeset a new chapter on the same page as the last
 chapter, after skipping some vertical whitespace.  Also, cause TeX to
 format page headers for single-sided printing.
 </p>
 </dd>
 <dt><code class="code">@setchapternewpage on</code></dt>
 <dd><p>Cause TeX to start new chapters on new pages and to format page
 headers for single-sided printing.  This is the form most often used for
 short reports or personal printing. This is the default.
 </p>
 </dd>
 <dt><code class="code">@setchapternewpage odd</code></dt>
 <dd><p>Cause TeX to start new chapters on new, odd-numbered pages
 (right-handed pages) and to typeset for double-sided printing.  This is
 the form most often used for books and manuals.
 </p></dd>
 </dl>

 <p>Texinfo does not have a <code class="code">@setchapternewpage even</code> command,
 because there is no printing tradition of starting chapters or books on
 an even-numbered page.
 </p>
 <p>If you don&rsquo;t like the default headers that <code class="code">@setchapternewpage</code>
 sets, you can explicit control them with the <code class="code">@headings</code> command.
 See <a class="xref" href="_0040headings.html">The <code class="code">@headings</code> Command</a>.
 </p>
 <p>At the beginning of a manual or book, pages are not numbered&mdash;for
 example, the title and copyright pages of a book are not numbered.  By
 convention, table of contents and frontmatter pages are numbered with
 roman numerals and not in sequence with the rest of the document.
 </p>
 <p>The <code class="code">@setchapternewpage</code> has no effect in output formats that do
 not have pages, such as Info and HTML.
 </p>
 <p>We recommend not including any <code class="code">@setchapternewpage</code> command in
 your document source at all, since such desired pagination is not
 intrinsic to the document.  For a particular hard copy run, if you
 don&rsquo;t want the default output (no blank pages, same headers on all
 pages) use the <samp class="option">--texinfo</samp> option to <code class="command">texi2dvi</code> to
 specify the output you want.
 </p>


 </div>
 <hr>
 <div class="nav-panel">
 <p>
 Next: <a href="Headings.html">Page Headings</a>, Up: <a href="Global-Document-Commands.html">Global Document Commands</a> &nbsp; [<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>
	<!DOCTYPE html>
	<html>
	<!-- Created by Texinfo 6.8dev+dev, http://www.gnu.org/software/texinfo/ -->
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
	<!-- This manual is for GNU Texinfo (version 6.8dev, 23 February 2022),
	a documentation system that can produce both online information and a
	printed manual from a single source using semantic markup.

	Copyright (C) 1988, 1990-1993, 1995-1999, 2001-2022 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". -->
	<title>@setchapternewpage (GNU Texinfo 6.8dev)</title>

	<meta name="description" content="@setchapternewpage (GNU Texinfo 6.8dev)">
	<meta name="keywords" content="@setchapternewpage (GNU Texinfo 6.8dev)">
	<meta name="resource-type" content="document">
	<meta name="distribution" content="global">
	<meta name="Generator" content="texi2any">
	<meta name="viewport" content="width=device-width,initial-scale=1">

	<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="Global-Document-Commands.html" rel="up" title="Global Document Commands">
	<link href="Headings.html" rel="next" title="Headings">
	<style type="text/css">
	<!--
	div.example {margin-left: 3.2em}
	-->
	</style>


	</head>

	<body lang="en">
	<div class="section-level-extent" id="g_t_0040setchapternewpage">
	<div class="nav-panel">
	<p>
	Next: <a href="Headings.html" accesskey="n" rel="next">Page Headings</a>, Up: <a href="Global-Document-Commands.html" accesskey="u" rel="up">Global Document Commands</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>
	<h3 class="section" id="g_t_0040setchapternewpage_003a-Blank-Pages-Before-Chapters">E.1 <code class="code">@setchapternewpage</code>: Blank Pages Before Chapters</h3>

	<a class="anchor" id="setchapternewpage"></a><a class="index-entry-id" id="index-setchapternewpage"></a>
	<a class="index-entry-id" id="index-Starting-chapters"></a>
	<a class="index-entry-id" id="index-Pages_002c-starting-odd"></a>

	<p>In an officially bound book, text is usually printed on both sides of
	the paper, chapters start on right-hand pages, and right-hand pages have
	odd numbers. But in short reports, text often is printed only on one
	side of the paper. Also in short reports, chapters sometimes do not
	start on new pages, but are printed on the same page as the end of the
	preceding chapter, after a small amount of vertical whitespace.
	</p>
	<p>You can use the <code class="code">@setchapternewpage</code> command with various
	arguments to specify how TeX should start chapters and whether it
	should format headers for printing on one or both sides of the paper
	(single-sided or double-sided printing).
	</p>
	<p>Write the <code class="code">@setchapternewpage</code> command at the beginning of a
	line followed by its argument. For example, you would write the
	following to cause each chapter to start on a fresh odd-numbered page:
	</p>
	<div class="example">
	<pre class="example-preformatted">@setchapternewpage odd
	</pre></div>

	<p>You can specify one of three alternatives with the
	<code class="code">@setchapternewpage</code> command:
	</p>
	<dl class="table">
	<dt><code class="code">@setchapternewpage off</code></dt>
	<dd><p>Cause TeX to typeset a new chapter on the same page as the last
	chapter, after skipping some vertical whitespace. Also, cause TeX to
	format page headers for single-sided printing.
	</p>
	</dd>
	<dt><code class="code">@setchapternewpage on</code></dt>
	<dd><p>Cause TeX to start new chapters on new pages and to format page
	headers for single-sided printing. This is the form most often used for
	short reports or personal printing. This is the default.
	</p>
	</dd>
	<dt><code class="code">@setchapternewpage odd</code></dt>
	<dd><p>Cause TeX to start new chapters on new, odd-numbered pages
	(right-handed pages) and to typeset for double-sided printing. This is
	the form most often used for books and manuals.
	</p></dd>
	</dl>

	<p>Texinfo does not have a <code class="code">@setchapternewpage even</code> command,
	because there is no printing tradition of starting chapters or books on
	an even-numbered page.
	</p>
	<p>If you don’t like the default headers that <code class="code">@setchapternewpage</code>
	sets, you can explicit control them with the <code class="code">@headings</code> command.
	See <a class="xref" href="_0040headings.html">The <code class="code">@headings</code> Command</a>.
	</p>
	<p>At the beginning of a manual or book, pages are not numbered—for
	example, the title and copyright pages of a book are not numbered. By
	convention, table of contents and frontmatter pages are numbered with
	roman numerals and not in sequence with the rest of the document.
	</p>
	<p>The <code class="code">@setchapternewpage</code> has no effect in output formats that do
	not have pages, such as Info and HTML.
	</p>
	<p>We recommend not including any <code class="code">@setchapternewpage</code> command in
	your document source at all, since such desired pagination is not
	intrinsic to the document. For a particular hard copy run, if you
	don’t want the default output (no blank pages, same headers on all
	pages) use the <samp class="option">--texinfo</samp> option to <code class="command">texi2dvi</code> to
	specify the output you want.
	</p>


	</div>
	<hr>
	<div class="nav-panel">
	<p>
	Next: <a href="Headings.html">Page Headings</a>, Up: <a href="Global-Document-Commands.html">Global Document Commands</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>