automake-info.patch

   1 --- automake-1.11.3/doc/automake.texi.orig      2012-02-01 11:40:23.000000000 +0100
   2 +++ automake-1.11.3/doc/automake.texi   2012-02-02 17:12:44.575874589 +0100
   3 @@ -38,15 +38,11 @@
   4  @end quotation
   5  @end copying
   6
   7 -@dircategory Software development
   8 +@dircategory Programming tools:
   9  @direntry
  10 -* Automake: (automake).         Making GNU standards-compliant Makefiles.
  11 -@end direntry
  12 -
  13 -@dircategory Individual utilities
  14 -@direntry
  15 -* aclocal-invocation: (automake)aclocal Invocation.   Generating aclocal.m4.
  16 -* automake-invocation: (automake)automake Invocation. Generating Makefile.in.
  17 +* Automake: (automake).                        Making GNU standards-compliant Makefiles
  18 +* aclocal-invocation: (automake)aclocal.       Generating aclocal.m4
  19 +* automake-invocation: (automake)automake.     Generating Makefile.in
  20  @end direntry
  21
  22  @titlepage
  23 @@ -99,7 +95,7 @@
  24  * Autotools Introduction::      An Introduction to the Autotools
  25  * Generalities::                General ideas
  26  * Examples::                    Some example packages
  27 -* automake Invocation::         Creating a Makefile.in
  28 +* automake::                    Creating a Makefile.in
  29  * configure::                   Scanning configure.ac, using aclocal
  30  * Directories::                 Declaring subdirectories
  31  * Programs::                    Building programs and libraries
  32 @@ -178,7 +174,7 @@
  33
  34  * Requirements::                Configuration requirements
  35  * Optional::                    Other things Automake recognizes
  36 -* aclocal Invocation::          Auto-generating aclocal.m4
  37 +* aclocal::                     Auto-generating aclocal.m4
  38  * Macros::                      Autoconf macros supplied with Automake
  39
  40  Auto-generating aclocal.m4
  41 @@ -1673,7 +1669,7 @@
  42  When starting a new project, we suggest you start with such a simple
  43  @file{configure.ac}, and gradually add the other tests it requires.
  44  The command @command{autoscan} can also suggest a few of the tests
  45 -your package may need (@pxref{autoscan Invocation, , Using
  46 +your package may need (@pxref{autoscan, , Using
  47  @command{autoscan} to Create @file{configure.ac}, autoconf, The
  48  Autoconf Manual}).
  49
  50 @@ -2506,7 +2502,7 @@
  51  would be chosen by automake; they would be @file{false-true.o} and
  52  @file{true-true.o}. (The name of the object files rarely matters.)
  53
  54 -@node automake Invocation
  55 +@node automake
  56  @chapter Creating a @file{Makefile.in}
  57  @c This node used to be named "Invoking automake".  This @anchor
  58  @c allows old links to still work.
  59 @@ -2756,7 +2752,7 @@
  60  @menu
  61  * Requirements::                Configuration requirements
  62  * Optional::                    Other things Automake recognizes
  63 -* aclocal Invocation::          Auto-generating aclocal.m4
  64 +* aclocal::                     Auto-generating aclocal.m4
  65  * Macros::                      Autoconf macros supplied with Automake
  66  @end menu
  67
  68 @@ -3127,11 +3123,11 @@
  69  @code{m4_include} is seldom used by @file{configure.ac} authors, but
  70  can appear in @file{aclocal.m4} when @command{aclocal} detects that
  71  some required macros come from files local to your package (as opposed to
  72 -macros installed in a system-wide directory, @pxref{aclocal Invocation}).
  73 +macros installed in a system-wide directory, @pxref{aclocal}).
  74
  75  @end ftable
  76
  77 -@node aclocal Invocation
  78 +@node aclocal
  79  @section Auto-generating aclocal.m4
  80  @c This node used to be named "Invoking automake".  This @anchor
  81  @c allows old links to still work.
  82 @@ -3321,7 +3317,7 @@
  83
  84  @vindex WARNINGS
  85  The environment variable @env{WARNINGS} is honored in the same
  86 -way as it is for @command{automake} (@pxref{automake Invocation}).
  87 +way as it is for @command{automake} (@pxref{automake}).
  88
  89  @end table
  90
  91 @@ -3629,12 +3625,12 @@
  92
  93  @code{ACLOCAL_AMFLAGS} contains options to pass to @command{aclocal}
  94  when @file{aclocal.m4} is to be rebuilt by @command{make}.  This line is
  95 -also used by @command{autoreconf} (@pxref{autoreconf Invocation, ,
  96 +also used by @command{autoreconf} (@pxref{autoreconf, ,
  97  Using @command{autoreconf} to Update @file{configure} Scripts,
  98  autoconf, The Autoconf Manual}) to run @command{aclocal} with suitable
  99 -options, or by @command{autopoint} (@pxref{autopoint Invocation, ,
 100 +options, or by @command{autopoint} (@pxref{autopoint, ,
 101  Invoking the @command{autopoint} Program, gettext, GNU gettext tools})
 102 -and @command{gettextize} (@pxref{gettextize Invocation, , Invoking the
 103 +and @command{gettextize} (@pxref{gettextize, , Invoking the
 104  @command{gettextize} Program, gettext, GNU gettext tools}) to locate
 105  the place where Gettext's macros should be installed.  So even if you
 106  do not really care about the rebuild rules, you should define
 107 @@ -4092,7 +4088,7 @@
 108  Although using some of the following macros was required in past
 109  releases, you should not use any of them in new code.  Running
 110  @command{autoupdate} should adjust your @file{configure.ac}
 111 -automatically (@pxref{autoupdate Invocation, , Using
 112 +automatically (@pxref{autoupdate, , Using
 113  @command{autoupdate} to Modernize @file{configure.ac}, autoconf, The
 114  Autoconf Manual}).
 115
 116 @@ -5506,7 +5502,7 @@
 117  passed to the tool invoked by @command{libtool} (hence the use of
 118  @samp{@var{library}_LDFLAGS} for libtool linking flags).  Generic
 119  options include @option{--tag=@var{tag}} and @option{--silent}
 120 -(@pxref{Invoking libtool, , Invoking @command{libtool}, libtool, The
 121 +(@pxref{libtool, , Invoking @command{libtool}, libtool, The
 122  Libtool Manual} for more options) should appear before the mode
 123  selection on the command line; in @file{Makefile.am}s they should
 124  be listed in the @samp{@var{library}_LIBTOOLFLAGS} variable.
 125 @@ -5580,7 +5576,7 @@
 126  Since Automake 1.6, it has been decided that running
 127  @command{libtoolize} was none of Automake's business.  Instead, that
 128  functionality has been moved into the @command{autoreconf} command
 129 -(@pxref{autoreconf Invocation, , Using @command{autoreconf}, autoconf,
 130 +(@pxref{autoreconf, , Using @command{autoreconf}, autoconf,
 131  The Autoconf Manual}).  If you do not want to remember what to run and
 132  when, just learn the @command{autoreconf} command.  Hopefully,
 133  replacing existing @file{bootstrap.sh} or @file{autogen.sh} scripts by
 134 @@ -9589,7 +9585,7 @@
 135  @cindex Option, @option{-W@var{category}}
 136  @cindex Option, @option{--warnings=@var{category}}
 137  These options behave exactly like their command-line counterpart
 138 -(@pxref{automake Invocation}).  This allows you to enable or disable some
 139 +(@pxref{automake}).  This allows you to enable or disable some
 140  warning categories on a per-file basis.  You can also setup some warnings
 141  for your entire project; for instance, try @samp{AM_INIT_AUTOMAKE([-Wall])}
 142  in your @file{configure.ac}.
 143 @@ -10204,7 +10200,7 @@
 144  that is not required by POSIX 2008 but is widely supported in
 145  practice.  The @option{silent-rules} option thus turns off warnings
 146  about recursive variable expansion, which are in turn enabled by
 147 -@option{-Wportability} (@pxref{automake Invocation}).  On the rare
 148 +@option{-Wportability} (@pxref{automake}).  On the rare
 149  @command{make} implementations that do not support nested variable
 150  expansion, whether rules are silent is always determined at configure
 151  time, and cannot be overridden at make time.  Future versions of POSIX
 152 @@ -10431,7 +10427,7 @@
 153  settings of Automake, or replace some of its rules.  Overriding
 154  Automake rules is often inadvisable, particularly in the topmost
 155  directory of a package with subdirectories.  The @option{-Woverride}
 156 -option (@pxref{automake Invocation}) comes in handy to catch overridden
 157 +option (@pxref{automake}) comes in handy to catch overridden
 158  definitions.
 159
 160  Note that Automake does not make any distinction between rules with
 161 @@ -10879,7 +10875,7 @@
 162  @end example
 163
 164  The use of @option{--force-missing} ensures that auxiliary tools will be
 165 -overridden by new versions (@pxref{automake Invocation}).
 166 +overridden by new versions (@pxref{automake}).
 167
 168  It is important to regenerate all these files each time Automake is
 169  upgraded, even between bug fixes releases.  For instance, it is not