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

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