Commit Graph

1942 Commits

Author SHA1 Message Date
Jim Meyering
a7f773305a doc: fix grammar/doubled-word errors
* doc/autoconf.texi: Remove/fix doubled-word errors.
Also, s/can not/cannot/.
* lib/m4sugar/m4sh.m4: Reword "if IF" comment to avoid triggering
the doubled-word warning.
2012-01-21 11:49:40 +01:00
Stefano Lattarini
7dae44f737 maint: sync files from gnulib
* GNUmakefile: Sync from gnulib.
* build-aux/announce-gen: Likewise.
* build-aux/config.guess: Likewise.
* build-aux/config.sub: Likewise.
* build-aux/git-version-gen: Likewise.
* build-aux/gnupload: Likewise.
* build-aux/move-if-change: Likewise.
* build-aux/texinfo.tex: Likewise.
* build-aux/update-copyright: Likewise.
* build-aux/vc-list-files: Likewise.
* doc/gendocs_template: Likewise.
* doc/standards.texi: Likewise.
* m4/autobuild.m4: Likewise.
2012-01-21 10:50:57 +01:00
Paul Eggert
28fd1f4aa4 doc: mention Bash 2.03 bug with backslash-newline
* doc/autoconf.texi (Invoking the Shell): New section.
(Backslash-Newline-Empty): Rename from Backslash-Newline-Newline.
Mention problem with Bash 2.03.
2012-01-05 12:33:05 -08:00
Paul Eggert
3b4b3ee585 doc: clarify sed buffer limit
* doc/autoconf.texi (Limitations of Usual Tools):
That 4000-byte limit applies to output and internal buffers, too.
2012-01-05 12:33:05 -08:00
Paul Eggert
b69f4c2834 maint: update copyright year
All files changed to add 2012, via 'make update-copyright'.
2012-01-04 00:20:24 -08:00
Paul Eggert
9b939481e6 maint: resync upstream files
* ChangeLog, GNUmakefile, build-aux/announce-gen:
* build-aux/config.guess, build-aux/config.sub, build-aux/gendocs.sh:
* build-aux/git-version-gen, build-aux/move-if-change:
* build-aux/texinfo.tex, build-aux/update-copyright:
* build-aux/vc-list-files, doc/fdl.texi, doc/gendocs_template:
* doc/standards.texi, lib/Autom4te/XFile.pm, m4/autobuild.m4:
Regenerated by 'make fetch'.
2012-01-04 00:20:24 -08:00
Stefano Lattarini
b5832028b6 configure: will re-execute with $CONFIG_SHELL, if it's set
* lib/m4sugar/general.m4 (_AS_DETECT_BETTER_SHELL): Define the macro
`_AS_FORCE_REEXEC_WITH_CONFIG_SHELL' to `yes', so that the code in
`_AS_DETECT_BETTER_SHELL' will cause autoconf-generated configure
scripts to always re-execute themselves with $CONFIG_SHELL, if it's
set in the environment.
* doc/autoconf.texi (config.status Invocation): Update.
* doc/install.texi (Defining Variables): Likewise.
* NEWS: Likewise.
* tests/m4sh.at: Add tests for the new semantics in ...
(Configure re-execs self with CONFIG_SHELL): ... this new
test group.
2011-12-26 22:17:54 +01:00
Stefano Lattarini
d1b31ac57c docs: issue with shell functions and here-documents on Solaris
* doc/autoconf.texi (Here-Documents): Using a command substitution
in a here-documents being fed to a shell function is unportable.

Problem revealed by the automake testsuite:
<http://lists.gnu.org/archive/html/automake-patches/2011-12/msg00149.html>
2011-12-26 11:33:41 +01:00
Paul Eggert
17ea0df46f AS_LN_S: fall back on 'cp -pR' (not 'cp -p') if 'ln -s' fails
This works better for symlinks to directories.
Problem reported by Eli Zaretskii via Werner Lemberg in
<http://lists.gnu.org/archive/html/bug-autoconf/2011-12/msg00006.html>.
* NEWS:
* doc/autoconf.texi (Particular Programs): Document this.
* lib/m4sugar/m4sh.m4 (_AS_LN_S_PREPARE): Implement this.
2011-12-26 00:35:06 -08:00
Paul Eggert
a8942db4d7 doc: document GNU make's \#
* doc/autoconf.texi (Comments in Make Macros): Also mention \#
in the right hand side of a macro, as an unportable usage.
2011-12-05 14:21:44 -08:00
Eric Blake
7aae67fbef doc: tweak previous commit
* doc/autoconf.texi (Limitations of Builtins) <export>: Give
concrete example of offender, and drop redundant text.
Reported by Stefano Lattarini.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-11-11 14:19:04 -07:00
Eric Blake
2f3cec7dfc doc: mention export portability hint
* doc/autoconf.texi (Limitations of Builtins) <export>: Document
export limitation.
Suggested by Bruno Haible.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-11-11 13:51:33 -07:00
Stefano Lattarini
bd962acf3e fortran: define $GFC to "yes" if $FC is a GNU compiler
* lib/autoconf/fortran.m4 (AC_PROG_FC): Define `$GFC' to "yes" if
the detected fortran compiler is a GNU compiler, define it to the
empty string otherwise.
This is mostly for consistency for what is done for the C, C++
and Fortran 77 compilers.
* doc/automake.texi: Update.
2011-10-21 14:00:36 +02:00
Stefano Lattarini
e0cb97afda docs: we prefer US English spelling over British one
* doc/autoconf.texi (Parallel Make): Prefer `behavior' over
`behaviour' in a couple of places.
2011-10-06 10:40:23 +02:00
Stefano Lattarini
f60916593d docs: some fixlets in section about shell signal handling
* doc/autoconf.texi (Signal handling): Rename ...
(Signal Handling): ... to this, for consistency with other node
names.  Fix some typos and grammaros.  Add more URL references
in comments.
2011-10-06 10:35:48 +02:00
Stefano Lattarini
124d6e9d96 docs: korn shells can have $? > 256 for signal-terminated children
Some Korn shells, when a child process dies due to signal number
n, can leave in $? an exit status of 256+n, instead of the more
common 128+n.  See also Austin Group issue 0000051:
  <http://www.austingroupbugs.net/view.php?id=51>

* doc/autoconf.texi (Signal handling): Document the described Korn
Shell behaviour, and some of its possible shortcomings.

Suggestion by Eric Blake.
2011-10-06 10:34:14 +02:00
Eric Blake
00f569ae0c docs: relax documentation license by dropping cover text
See https://lists.gnu.org/archive/html/bug-diffutils/2011-08/msg00022.html
for precedence in diffutils.  The autoconf manual, as of this commit,
was still barely below 400 pages.

* doc/autoconf.texi (copying): Drop front- and back-cover texts.
* NEWS: Document this.
Reported by Brian Gough.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-09-26 12:02:35 -06:00
Stefano Lattarini
cff03ec71f docs: signal-related bugs and incompatibilities for the shells
* doc/autoconf.texi (Signal handling): New paragraph.
(@menu at "Portable Shell", @detailmenu): Update.

Motivated by recent discussion on the bug-autoconf list, as well
as work in the automake testsuite:
 <https://lists.gnu.org/archive/html/bug-autoconf/2011-09/msg00003.html>
 <https://lists.gnu.org/archive/html/bug-autoconf/2011-09/msg00004.html>
 <http://lists.gnu.org/archive/html/automake-patches/2011-09/msg00066.html>
2011-09-20 18:10:19 +02:00
Eric Blake
f37c5e315c docs: refer to correct AC_RUN_IFELSE parameter name
The docs referred to @var{program}, which did not exist.

* doc/autoconf.texi (Runtime) <AC_RUN_IFELSE>: Fix wording.
Reported by Reuben Thomas.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-09-19 10:59:14 -06:00
Eric Blake
2a9b772222 docs: fix typo in shell example
* doc/autoconf.texi (Shell Substitutions): Fix typo.
* THANKS: Update.
Reported by Nick Bowler.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-09-16 13:37:38 -06:00
Stefano Lattarini
19951ff75b docs: more details about make VPATH rewriting woes
* doc/autoconf.texi (Automatic Rule Rewriting): Solaris make
VPATH rewriting applies to any whitespace-separated word in a
rule, so it might apply also to shell variables, functions
and keywords (and automake has already tripped on this once);
document this, with an example.  Since we are at it, do some
minor reformatting of existing text.
2011-09-16 10:21:14 +02:00
Stefano Lattarini
7b49187003 docs: document Solaris 10 /bin/ksh and XPG4 sh 'unset' bug
* doc/autoconf.texi (Limitations of Builtins): Solaris 10 ksh
and XPG4 sh also fails upon `unset' of a variable that is not
set.
2011-09-13 16:24:41 +02:00
Stefano Lattarini
96cdf32954 docs: other issues with parallel BSD make
Motivated by automake bug#9245:
 <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=9245>
and FreeBSD PR bin/159730:
 <http://www.freebsd.org/cgi/query-pr.cgi?pr=159730>

* doc/autoconf.texi (Parallel Make): Document other BSD make
incompatibilities.  Reorganize the existing related documentation
accordingly.
2011-08-18 21:08:13 +02:00
Stefano Lattarini
f36755ebbb docs: fix minor typos
* doc/autoconf.texi (Shell Functions): Fix a couple of minor typos.
2011-08-08 22:19:19 +02:00
Stefano Lattarini
4b75742acc docs: another Solaris sh bug with redirected `:'
* doc/autoconf.texi (File Descriptors): Solaris 10 /bin/sh
"optimizes" away redirected `:' commands in a shell function
after the first call.
2011-08-04 15:13:26 +02:00
Paul Eggert
0ff6eaebd9 docs: modernize treatment of ns-resolution timestamps
* doc/autoconf.texi (Limitations of Usual Tools): ns-resolution time
stamps are now routinely supported by coreutils 'cp' etc.
2011-07-31 00:54:52 -07:00
Eric Blake
4d2efc4563 docs: fix minor doc problems
* doc/autoconf.texi (Why Not Imake): Fix grammar.
(autoreconf Invocation): Fix short option for --version.
* THANKS: Update.
Reported by Christophe Jarry and Russ Allbery.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-07-22 07:04:21 -06:00
Benoit Sigoure
855ce07e29 docs: fix typo in AC_PATH_PROG
* doc/autoconf.texi (Erlang Compiler and Interpreter):
s/AC_PROG_PATH/AC_PATH_PROG/.
* THANKS: Update.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-07-12 15:17:09 -06:00
Paul Eggert
9ddea209e5 * doc/autoconf.texi (File Descriptors): Fix texinfo typo. 2011-06-18 14:36:39 -07:00
Eric Blake
64a4d1799f doc: mention more about ksh cloexec behavior
* doc/autoconf.texi (File Descriptors): Clarify that only the exec
builtin suffers from cloexec issues.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-06-14 09:21:54 -06:00
Eric Blake
1a956c4b1e doc: update quoting example
The existing example triggers an autoconf warning, due to the
change in AC_COMPILE_IFELSE probing for an AC_LANG_SOURCE use.

* doc/autoconf.texi (Autoconf Language): Add AC_LANG_SOURCE use.
* THANKS: Update.
Reported by Křištof Želechovski.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-06-14 07:45:29 -06:00
Eric Blake
2105ae9700 doc: document dash bug with positional parameters
* doc/autoconf.texi (Shell Substitutions) <${10}>: Document
a pitfall with $10.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-05-05 08:29:21 -06:00
Eric Blake
5daf0f3404 docs: document NetBSD join bug
* doc/autoconf.texi (Limitations of Usual Tools) <join>: Mention
bug in -a parsing.
Reported by J.T. Conklin.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-04-27 10:27:08 -06:00
Ralf Wildenhues
8c2db1c128 New macro AC_FC_PP_DEFINE for the preprocessor define flag.
* lib/autoconf/fortran.m4 (AC_FC_PP_DEFINE): New macro.
* lib/autom4te.in (Automake-preselections): Preselect it.
* doc/autoconf.texi (Fortran Compiler): Document it.
* tests/local.at (_AT_CHECK_ENV): Do not complain about
FCFLAGS_F nor FC_DEFINE.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-04-02 15:37:40 +02:00
Ralf Wildenhues
1c3373c5f0 New macro AC_FC_PP_SRCEXT for preprocessed file extensions.
* lib/autoconf/fortran.m4 (AC_FC_PP_SRCEXT): New macro.
* lib/autom4te.in (Automake-preselections): Preselect it.
* doc/autoconf.texi (Fortran Compiler): Document it, rewriting
the documentation for AC_FC_SRCEXT along the way.
* tests/fortran.at (AC_FC_PP_SRCEXT usage): New test.
* tests/mktests.sh: Exclude the macro from default testing.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-04-02 15:06:29 +02:00
Ralf Wildenhues
ac427166c5 New macro AC_FC_MODULE_OUTPUT_FLAG: module output directory.
* lib/autoconf/fortran.m4 (AC_FC_MODULE_OUTPUT_FLAG): New macro.
* doc/autoconf.texi (Fortran Compiler): Document it.
* tests/local.at (_AT_CHECK_ENV): Do not complain about
FC_MODOUT.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-04-02 14:21:38 +02:00
Luc Maisonobe
3e3412d3dd New macro AC_FC_MODULE_FLAG: Fortran 90 module include path.
* lib/autoconf/fortran.m4 (AC_FC_MODULE_FLAG): New macro,
adjusted and rewritten from the AX_F90_MODULE_FLAG macro from
the Autoconf Macro Archive by Luc Maisonobe, Julian C. Cummings,
and Alexander Pletzer.
* doc/autoconf.texi (Fortran Compiler): Document it.
* tests/fortran.at (AC_FC_MODULE_FLAG): New test.
* tests/local.at (AT_CHECK_ENV): Do not complain about FC_MODINC
setting.
* NEWS, THANKS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-04-02 14:18:47 +02:00
Luc Maisonobe
bf140a4c8c New macro AC_FC_MODULE_EXTENSION: Fortran 90 module extension.
* lib/autoconf/fortran.m4 (AC_FC_MODULE_EXTENSION): New macro,
rewritten from the AX_F90_MODULE_EXTENSION macro from the
Autoconf Macro Archive by Luc Maisonobe and Alexander Pletzer.
* doc/autoconf.texi (Fortran Compiler): Document it.
* tests/local.at (_AT_CHECK_ENV): Do not complain about
FC_MODEXT setting.
* NEWS, THANKS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-04-02 14:15:14 +02:00
Colin Watson
f3c183d084 docs: Document AC_FUNC_FORK cache variables.
* doc/autoconf.texi (Particular Functions): Document AC_FUNC_FORK
cache variables.
* THANKS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-03-08 20:48:29 +01:00
Ralf Wildenhues
fd0e10b3f3 docs: BSD and Solaris make trailing space macro issue.
* doc/autoconf.texi (Trailing whitespace in Make Macros):
Document issue with trailing whitespace in macro settings.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-03-08 20:46:02 +01:00
Ralf Wildenhues
1fb4fba330 docs: document several Fortran and OpenMP cache variables.
* doc/autoconf.texi (Generic Compiler Characteristics)
[AC_OPENMP]: Document associated cache variables.
(Fortran Compiler) [AC_PROG_F77, AC_PROG_FC, AC_PROG_F77_C_O]
[AC_PROG_FC_C_O, AC_F77_LIBRARY_LDFLAGS, AC_FC_LIBRARY_LDFLAGS]
[AC_F77_DUMMY_MAIN, AC_FC_DUMMY_MAIN, AC_F77_MAIN, AC_FC_MAIN]
[AC_F77_WRAPPERS, AC_FC_WRAPPERS, AC_FC_FREEFORM]
[AC_FC_FIXEDFORM, AC_FC_LINE_LENGTH, AC_FC_CHECK_BOUNDS]
[AC_F77_IMPLICIT_NONE, AC_FC_IMPLICIT_NONE]: Document and/or
index the cache variables used by these macros.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-03-05 17:30:59 +01:00
Ralf Wildenhues
c9cbf626a1 docs: fix description of AC_F77_IMPLICIT_NONE.
* doc/autoconf.texi (Fortran Compiler) [AC_F77_IMPLICIT_NONE]:
This macro modifies FFLAGS, not FCFLAGS.  Fix grammar nit.
2011-03-05 12:33:57 +01:00
Ralf Wildenhues
5f11bce456 New macros AC_{F77,FC}_IMPLICIT_NONE to disable Fortran implicit int.
* lib/autoconf/fortran.m4 (_AC_FC_IMPLICIT_NONE): New internal
macro.
(AC_F77_IMPLICIT_NONE, AC_FC_IMPLICIT_NONE): New macros.
* doc/autoconf.texi (Fortran Compiler): Document them.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-03-05 09:42:04 +01:00
Ralf Wildenhues
8476731b83 New macro AC_FC_CHECK_BOUNDS to enable Fortran array bounds checking.
* lib/autoconf/fortran.m4 (AC_FC_CHECK_BOUNDS): New macro.
* doc/autoconf.texi (Fortran Compiler): Document it.
* tests/fortran.at (AC_FC_CHECK_BOUNDS): New test.
* NEWS: Update.
Prompted by report from Eve-Marie Devaliere.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-03-05 09:34:00 +01:00
Ralf Wildenhues
0542805c54 docs: macro synopses document default failure cases.
* doc/autoconf.texi (Fortran Compiler, Obsolete Macros):
Document failure case for AC_F77_DUMMY_MAIN, AC_FC_DUMMY_MAIN,
AC_FC_SRCEXT, AC_FC_FREEFORM, AC_FC_FIXEDFORM,
AC_FC_LINE_LENGTH, and AC_TRY_RUN macros.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-03-04 21:24:32 +01:00
Ralf Wildenhues
4659f06146 Reword Fortran macro documentation.
* doc/autoconf.texi (Fortran Compiler): Improve wording for
AC_FC_FREEFORM, AC_FC_FIXEDFORM, and AC_FC_LINE_LENGTH macros.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-03-04 21:23:49 +01:00
Ian Lance Taylor
67b4182579 Add support for the Go programming language.
* lib/autoconf/go.m4: New file.
* lib/autoconf/autoconf.m4: Include autoconf/go.m4.
* lib/autoconf/Makefile.am (dist_autoconflib_DATA): Add go.m4.
* lib/freeze.mk (autoconf_m4f_dependencies): Add
$(src_libdir)/autoconf/go.m4.
* doc/autoconf.texi: Rebuild menus.
(Preset Output Variables): Mention Go.  Document GOFLAGS.
(Libraries): Mention Go.
(Go Compiler): New subsection.
(Language Choice): Mention Go.
(Generating Sources): Likewise.
(Running the Preprocessor): Likewise.
* tests/go.at: New file.
* tests/suite.at: Include go.at and acgo.at.
* tests/local.at (_AT_CHECK_ENV): Add GOC and GOFLAGS.
* tests/Makefile.am (TESTSUITE_GENERATED_AT): Add
$(srcdir)/acgo.at.
(TESTSUITE_HAND_AT): Add go.at.
(AUTOCONF_FILES): Add $(autoconfdir)/go.m4.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-02-21 21:24:59 +01:00
Eric Blake
f9fb235488 docs: document fourth argument of AC_RUN_IFELSE better
* doc/autoconf.texi (Runtime) <AC_RUN_IFELSE>: Make synopsis show
that the default is configure failure.  Rework the text about
proper use of the fourth argument.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-02-18 11:09:59 -07:00
Patrick Welche
5280404852 docs: fix a typo
* doc/autoconf.texi (Generic Structures): Fix typo.
2011-02-16 09:02:38 -07:00
Matt Kraai
7218999370 docs: fix some typos
* doc/autoconf.texi (testsuite Scripts): Fix typos.
* THANKS: Update.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-02-16 08:56:34 -07:00