/usr/share/doc/texinfo/html/titlepage.html

<html lang="en">
<head>
<title>titlepage - GNU Texinfo 4.13</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Texinfo 4.13">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Titlepage-_0026-Copyright-Page.html#Titlepage-_0026-Copyright-Page" title="Titlepage &amp; Copyright Page">
<link rel="next" href="titlefont-center-sp.html#titlefont-center-sp" title="titlefont center sp">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This manual is for GNU Texinfo (version 4.13, 18 September 2008),
a documentation system that can produce both online information and a
printed manual from a single source.

Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
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.2 or any later version published by the Free Software
     Foundation; with no Invariant Sections, with the Front-Cover Texts
     being ``A GNU Manual'', and with the Back-Cover Texts as in (a)
     below.  A copy of the license is included in the section entitled
     ``GNU Free Documentation License.''

     (a) The FSF's Back-Cover Text is: ``You are free to copy and modify
     this GNU Manual.  Buying copies from GNU Press supports the FSF in
     developing GNU and promoting software freedom.''
  -->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
--></style>
</head>
<body>
<div class="node">
<a name="titlepage"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="titlefont-center-sp.html#titlefont-center-sp">titlefont center sp</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Titlepage-_0026-Copyright-Page.html#Titlepage-_0026-Copyright-Page">Titlepage &amp; Copyright Page</a>
<hr>
</div>

<h4 class="subsection">3.4.1 <code>@titlepage</code></h4>

<p><a name="index-Title-page-191"></a><a name="index-titlepage-192"></a>
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>The <code>@end titlepage</code> command starts a new page and turns on page
numbering.  (See <a href="Headings.html#Headings">Page Headings</a>, for details about how to
generate page headings.)  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.  You can force the table of contents to
appear there with the <code>@setcontentsaftertitlepage</code> command
(see <a href="Contents.html#Contents">Contents</a>).

  <p><a name="index-page_0040r_007b_002c-within-_0040code_007b_0040_0040titlepage_007d_007d-193"></a>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>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 rel="footnote" href="#fn-1" name="fnd-1"><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">The Top Node</a>.)

  <p>Texinfo provides two main methods for creating a title page.  One method
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>The second 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>You may use either method, or you may combine them; see the examples in
the sections below.

  <p><a name="index-shorttitlepage-194"></a><a name="index-Bastard-title-page-195"></a><a name="index-Title-page_002c-bastard-196"></a>For extremely 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.

  <div class="footnote">
<hr>
<h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> 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>

  <hr></div>

  </body></html>
texinfo-doc-nonfree 4.13a-1 / usr / share / doc / texinfo / html / titlepage.html
