contrib/gcc-4.4/gcc/doc/include/gcc-common.texi

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