2.8.1 @titlepage

Start the material for the title page and following copyright page with @titlepage on a line by itself and end it with @end titlepage on a line by itself.

The @end titlepage command starts a new page and turns on page numbering (see Heading Generation). All the material that you want to appear on unnumbered pages should be put between the @titlepage and @end titlepage commands.

By using the @page command, you can force a page break within the region delineated by the @titlepage and @end titlepage commands and thereby create more than one unnumbered page. This is how the copyright page is produced. (The @titlepage command might perhaps have been better named the @titleandadditionalpages command, but that would have been rather long!)

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 number2 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 The ‘Top’ Node and Master Menu.)

One method uses the @title, @subtitle, and @author commands to create a title 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. The usual formatting consist of black rules under the title and author lines and the subtitle text set flush to the right-hand side of the page.

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 @titlefont, @sp, and @center commands to generate a title page in which the words on the page are centered.

For sufficiently simple documents, and for the bastard title page in traditional book frontmatter, Texinfo also provides a command @shorttitlepage 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. In HTML, @shorttitlepage can play the same role as @settitle, if @settitle is not set. See @settitle: Set the Document Title.


Footnotes

(2)

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.