JezK
Edit File: _0040titlepage.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <!-- Created by GNU Texinfo 6.8, https://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.8, 8 June 2021), 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-2021 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>@titlepage (GNU Texinfo 6.8)</title> <meta name="description" content="@titlepage (GNU Texinfo 6.8)"> <meta name="keywords" content="@titlepage (GNU Texinfo 6.8)"> <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="Titlepage-_0026-Copyright-Page.html" rel="up" title="Titlepage & Copyright Page"> <link href="_0040title-_0040subtitle-_0040author.html" rel="next" title="@title @subtitle @author"> <style type="text/css"> <!-- a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {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} span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> </head> <body lang="en"> <div class="subsection" id="g_t_0040titlepage"> <div class="header"> <p> Next: <a href="_0040title-_0040subtitle-_0040author.html" accesskey="n" rel="next"><code>@title</code>, <code>@subtitle</code>, and <code>@author</code></a>, Up: <a href="Titlepage-_0026-Copyright-Page.html" accesskey="u" rel="up">Title and Copyright Pages</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_0040titlepage-1"></span><h4 class="subsection">2.7.1 <code>@titlepage</code></h4> <span id="titlepage"></span><span id="index-Title-page"></span> <span id="index-titlepage"></span> <p>Start the material for the title page and following copyright page with <code>@titlepage</code> on a line by itself and end it with <code>@end titlepage</code> on a line by itself. </p> <p>The <code>@end titlepage</code> command starts a new page and turns on page numbering (see <a href="Heading-Generation.html">Heading Generation</a>). All the material that you want to appear on unnumbered pages should be put between the <code>@titlepage</code> and <code>@end titlepage</code> commands. </p> <span id="index-page_002c-within-_0040titlepage"></span> <p>By using the <code>@page</code> command, you can force a page break within the region delineated by the <code>@titlepage</code> and <code>@end titlepage</code> commands and thereby create more than one unnumbered page. This is how the copyright page is produced. (The <code>@titlepage</code> command might perhaps have been better named the <code>@titleandadditionalpages</code> command, but that would have been rather long!) </p> <p>When you write a manual about a computer program, you should write the version of the program to which the manual applies on the title page. If the manual changes more frequently than the program or is independent of it, you should also include an edition number<a id="DOCF1" href="#FOOT1"><sup>1</sup></a> for the manual. This helps readers keep track of which manual is for which version of the program. (The ‘Top’ node should also contain this information; see <a href="The-Top-Node.html">The ‘Top’ Node and Master Menu</a>.) </p> <p>One method uses the <code>@title</code>, <code>@subtitle</code>, and <code>@author</code> commands to create a title page with black rules under the title and author lines and the subtitle text set flush to the right-hand side of the page. With this method, you do not specify any of the actual formatting of the title page. You specify the text you want, and Texinfo does the formatting. </p> <p>Texinfo also provides a second method for creating a title page. using typesetting commands that are not to be used in the main text. This method uses uses the <code>@titlefont</code>, <code>@sp</code>, and <code>@center</code> commands to generate a title page in which the words on the page are centered. </p> <span id="index-shorttitlepage"></span> <span id="index-Bastard-title-page"></span> <span id="index-Title-page-1"></span> <p>For sufficiently simple documents, and for the bastard title page in traditional book frontmatter, Texinfo also provides a command <code>@shorttitlepage</code> which takes the rest of the line as the title. The argument is typeset on a page by itself and followed by a blank page. </p> </div> <div class="footnote"> <hr> <h4 class="footnotes-heading">Footnotes</h4> <h5><a id="FOOT1" href="#DOCF1">(1)</a></h5> <p>We have found that it is helpful to refer to versions of independent manuals as ‘editions’ and versions of programs as ‘versions’; otherwise, we find we are liable to confuse each other in conversation by referring to both the documentation and the software with the same words.</p> </div> <hr> <div class="header"> <p> Next: <a href="_0040title-_0040subtitle-_0040author.html"><code>@title</code>, <code>@subtitle</code>, and <code>@author</code></a>, Up: <a href="Titlepage-_0026-Copyright-Page.html">Title and Copyright Pages</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>