38-doc-ac-init.patch

[Akim Demaille]

This is the 700'th commit on my home repo :)

Index: ChangeLog
from  Akim Demaille  <address@hidden>

        * lib/autoconf/general.m4 (_AC_INIT_PACKAGE): Warn if the
        arguments are not literals.
        * doc/autoconf.texi (Input) <AC_INIT>: Arguments must be literals.
        Specify the output variables, and macros defined.

Index: NEWS
--- NEWS Tue, 14 Aug 2001 01:47:02 +0200 akim
+++ NEWS Mon, 20 Aug 2001 08:45:24 +0200 akim
@@ -1,8 +1,15 @@
 * Major changes in Autoconf 2.52c                       -*- outline -*-
 ** Licensing
-  The autoconf manual is now distributed under the terms of the GNU FDL.
+  The Autoconf manual is now distributed under the terms of the GNU FDL.
 ** Requirements
   Perl 5.005 is now required to run Autoconf.
+** Documentation
+- AC_INIT
+  Argument requirements, output variables, defined macros.
+- Autotest
+  First sketch of its documentation.
+- Double quoting macros
+  AC_TRY_CPP, AC_TRY_COMPILE, AC_TRY_LINK and AC_TRY_RUN.
 ** autom4te
   New executable, used by the Autoconf suite to cache and speed up
   some processing.
Index: doc/autoconf.texi
--- doc/autoconf.texi Mon, 20 Aug 2001 07:56:36 +0200 akim
+++ doc/autoconf.texi Mon, 20 Aug 2001 08:32:04 +0200 akim
@@ -1592,6 +1592,37 @@ @node Input, Output, Notices, Setup
 and verifications.  Set the name of the @var{package} and its
 @var{version}.  The optional argument @var{bug-report-address} should be
 the email to which users should send bug reports.
+
+These three arguments must be @emph{static}, i.e., there must not be any
+shell computation, but they can be computed by M4.  The following macros
+and output variables are then defined:
+
address@hidden @asis
address@hidden @code{AC_PACKAGE_NAME}, @code{PACKAGE_NAME}
address@hidden PACKAGE_NAME
address@hidden PACKAGE_NAME
+Exactly @var{package}.
+
address@hidden @code{AC_PACKAGE_TARNAME}, @code{PACKAGE_TARNAME}
address@hidden PACKAGE_TARNAME
address@hidden PACKAGE_TARNAME
address@hidden once @samp{GNU } strip, and lower cased.
+
address@hidden @code{AC_PACKAGE_VERSION}, @code{PACKAGE_VERSION}
address@hidden PACKAGE_VERSION
address@hidden PACKAGE_VERSION
+Exactly @var{version}.
+
address@hidden @code{AC_PACKAGE_STRING}, @code{PACKAGE_STRING}
address@hidden PACKAGE_STRING
address@hidden PACKAGE_STRING
+Exactly @address@hidden @var{version}}.
+
address@hidden @code{AC_PACKAGE_BUGREPORT}, @code{PACKAGE_BUGREPORT}
address@hidden PACKAGE_BUGREPORT
address@hidden PACKAGE_BUGREPORT
+Exactly @var{bug-report-address}.
address@hidden table
 @end defmac

 @defmac AC_CONFIG_SRCDIR (@var{unique-file-in-source-dir})
Index: lib/autoconf/general.m4
--- lib/autoconf/general.m4 Sun, 19 Aug 2001 22:23:58 +0200 akim
+++ lib/autoconf/general.m4 Mon, 20 Aug 2001 08:40:05 +0200 akim
@@ -452,12 +452,13 @@ m4_define([AC_HELP_STRING],



-# _AC_INIT_PACKAGE(PACKAGE-NAME, VERSION,
-#                  [BUG-REPORT],
-#                  [TAR-NAME = unGNU'd lower case PACKAGE-NAME])
-# --------------------------------------------------------------
+# _AC_INIT_PACKAGE(PACKAGE-NAME, VERSION, BUG-REPORT)
+# ---------------------------------------------------
 m4_define([_AC_INIT_PACKAGE],
-[m4_define([AC_PACKAGE_NAME],     [$1])
+[AS_LITERAL_IF([$1], [], [m4_warn([syntax], [AC_INIT: not a literal: $1])])
+AS_LITERAL_IF([$2], [],  [m4_warn([syntax], [AC_INIT: not a literal: $2])])
+AS_LITERAL_IF([$3], [],  [m4_warn([syntax], [AC_INIT: not a literal: $3])])
+m4_define([AC_PACKAGE_NAME],     [$1])
 m4_define([AC_PACKAGE_TARNAME],
           m4_tolower(m4_patsubst([[[$1]]], [GNU ])))
 m4_define([AC_PACKAGE_VERSION],   [$2])