xref: /dflybsd-src/contrib/gcc-4.7/gcc/doc/include/gcc-common.texi (revision 04febcfb30580676d3e95f58a16c5137ee478b32)
1*e4b17023SJohn Marino@c Copyright (C) 2001, 2002, 2003, 2004, 2005,
2*e4b17023SJohn Marino@c 2007 Free Software Foundation, Inc.
3*e4b17023SJohn Marino@c This is part of the GCC manual.
4*e4b17023SJohn Marino@c For copying conditions, see the file gcc.texi.
5*e4b17023SJohn Marino
6*e4b17023SJohn Marino@c Version number and development mode.
7*e4b17023SJohn Marino@c version-GCC is @set to the base GCC version number.
8*e4b17023SJohn Marino@c DEVELOPMENT is @set for an in-development version, @clear for a
9*e4b17023SJohn Marino@c release version (corresponding to ``experimental''/anything else
10*e4b17023SJohn Marino@c in gcc/DEV-PHASE).
11*e4b17023SJohn Marino
12*e4b17023SJohn Marino@include gcc-vers.texi
13*e4b17023SJohn Marino
14*e4b17023SJohn Marino@c Common macros to support generating man pages:
15*e4b17023SJohn Marino
16*e4b17023SJohn Marino@macro gcctabopt{body}
17*e4b17023SJohn Marino@code{\body\}
18*e4b17023SJohn Marino@end macro
19*e4b17023SJohn Marino@macro gccoptlist{body}
20*e4b17023SJohn Marino@smallexample
21*e4b17023SJohn Marino\body\
22*e4b17023SJohn Marino@end smallexample
23*e4b17023SJohn Marino@end macro
24*e4b17023SJohn Marino@c Makeinfo handles the above macro OK, TeX needs manual line breaks;
25*e4b17023SJohn Marino@c they get lost at some point in handling the macro.  But if @macro is
26*e4b17023SJohn Marino@c used here rather than @alias, it produces double line breaks.
27*e4b17023SJohn Marino@iftex
28*e4b17023SJohn Marino@alias gol = *
29*e4b17023SJohn Marino@end iftex
30*e4b17023SJohn Marino@ifnottex
31*e4b17023SJohn Marino@macro gol
32*e4b17023SJohn Marino@end macro
33*e4b17023SJohn Marino@end ifnottex
34*e4b17023SJohn Marino
35*e4b17023SJohn Marino@c For FSF printing, define FSFPRINT.  Also update the ISBN and last
36*e4b17023SJohn Marino@c printing date for the manual being printed.
37*e4b17023SJohn Marino@c @set FSFPRINT
38*e4b17023SJohn Marino@ifset FSFPRINT
39*e4b17023SJohn Marino@smallbook
40*e4b17023SJohn Marino@finalout
41*e4b17023SJohn Marino@c Cause even numbered pages to be printed on the left hand side of
42*e4b17023SJohn Marino@c the page and odd numbered pages to be printed on the right hand
43*e4b17023SJohn Marino@c side of the page.  Using this, you can print on both sides of a
44*e4b17023SJohn Marino@c sheet of paper and have the text on the same part of the sheet.
45*e4b17023SJohn Marino
46*e4b17023SJohn Marino@c The text on right hand pages is pushed towards the right hand
47*e4b17023SJohn Marino@c margin and the text on left hand pages is pushed toward the left
48*e4b17023SJohn Marino@c hand margin.
49*e4b17023SJohn Marino@c (To provide the reverse effect, set bindingoffset to -0.75in.)
50*e4b17023SJohn Marino@tex
51*e4b17023SJohn Marino\global\bindingoffset=0.75in
52*e4b17023SJohn Marino\global\normaloffset =0.75in
53*e4b17023SJohn Marino@end tex
54*e4b17023SJohn Marino@end ifset
55*e4b17023SJohn Marino
56*e4b17023SJohn Marino@c Macro to generate a "For the N.N.N version" subtitle on the title
57*e4b17023SJohn Marino@c page of TeX documentation.  This macro should be used in the
58*e4b17023SJohn Marino@c titlepage environment after the title and any other subtitles have
59*e4b17023SJohn Marino@c been placed, and before any authors are placed.
60*e4b17023SJohn Marino@macro versionsubtitle
61*e4b17023SJohn Marino@ifclear DEVELOPMENT
62*e4b17023SJohn Marino@subtitle For @sc{gcc} version @value{version-GCC}
63*e4b17023SJohn Marino@end ifclear
64*e4b17023SJohn Marino@ifset DEVELOPMENT
65*e4b17023SJohn Marino@subtitle For @sc{gcc} version @value{version-GCC} (pre-release)
66*e4b17023SJohn Marino@end ifset
67*e4b17023SJohn Marino@ifset VERSION_PACKAGE
68*e4b17023SJohn Marino@sp 1
69*e4b17023SJohn Marino@subtitle @value{VERSION_PACKAGE}
70*e4b17023SJohn Marino@end ifset
71*e4b17023SJohn Marino@c Even if there are no authors, the second titlepage line should be
72*e4b17023SJohn Marino@c forced to the bottom of the page.
73*e4b17023SJohn Marino@vskip 0pt plus 1filll
74*e4b17023SJohn Marino@end macro
75