Commit Graph

2009 Commits

Author SHA1 Message Date
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
Eric Blake
e5fb1ec281 doc: fix debug advice typo
* doc/autoconf.texi (Debugging): Put shell option in right place.
Reported by Reuben Thomas.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-02-15 14:22:11 -07:00
Ralf Wildenhues
9e71645ffc Rebuild menus in the manual.
* doc/autoconf.texi: Rebuild menus using emacs ^C ^U ^A.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-02-08 00:01:37 +01:00
Paul Eggert
46acbee4f8 autoconf: new macro AC_HEADER_CHECK_STDBOOL
* NEWS: Document this.
* doc/autoconf.texi (Particular Headers): Likewise.
In example, don't assume a 'system.h' exists.
* lib/autoconf/headers.m4 (AC_CHECK_HEADER_STDBOOL): New macro.
Use it with AN_IDENTIFIER, since it's less heavyweight.
Reindent to match gnulib, since that's a bit nicer.
(AC_HEADER_STDBOOL): Reimplement in terms of it.
2011-02-04 20:40:11 -08:00
Jim Warhol
ce7ebea4e7 docs: fix typo in the manual.
* doc/autoconf.texi (Introduction): Fix typo.
* THANKS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-29 11:36:15 +01:00
Stefano Lattarini
f8ef2568f2 docs: another parallel make issue
* doc/autoconf.texi (Parallel Make): Document that some make
implementations, when run in parallel mode, connect stdout and
stderr of child processes to pipes or temporary files, and might
re-route stderr of spawned processes to stout.  Also document
that FreeBSD make in parallel mode reuses the same shell for
multiple commands within one recipe (like NetBSD make does).
2011-01-27 20:44:09 +01:00
Ralf Wildenhues
2d082fa1ca docs: advise against HP-UX make due to time stamp semantics.
* doc/autoconf.texi (Timestamps and Make): Document HP-UX 11.31
make issue with targets having the same time stamps as their
prerequisites.
* doc/install.texi (Particular Systems): Warn against using
HP-UX make.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-26 06:57:18 +01:00
Ralf Wildenhues
e3b2543cbf docs: new section about whitespace trimmmed from make command-lines.
* doc/autoconf.texi (Command-line Macros and whitespace): New
section, document trimming of whitespace from macros set on the
command line and from the environment.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-23 12:45:09 +01:00
Ralf Wildenhues
80ca89f803 docs: document how to use comment characters in rules.
* doc/autoconf.texi (Comments in Make Rules): Explain how to
produce a `#' in a rule.
(Comments in Make Macros): Add cross reference.
Suggestion from Eric Blake.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-22 19:39:29 +01:00
Ralf Wildenhues
f02c72e46b docs: new sections about comments and whitespace in make macros.
* doc/autoconf.texi (Top, Portable Make): Adjust menus.
(Comments in Make Macros, Trailing whitespace in Make Macros):
New sections.
Suggestion by Stefano Lattarini.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-22 15:37:45 +01:00
Ralf Wildenhues
73c280a825 docs: do not use AIX 5.3 cp -R.
* doc/autoconf.texi (Limitations of Usual Tools): Document one
instance of the cp -R bug on AIX 5.3.  This seems to have been
fixed in 6.1 and newer releases.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-22 14:56:52 +01:00
Ralf Wildenhues
f272870140 docs: update entry about unset.
* doc/autoconf.texi (Limitations of Builtins): NetBSD sh unset
also fails upon `unset' of a variable that is not set.  Bash 2.01
could also dump core over `unset MAILPATH'.
Suggestion by Eric Blake.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-22 14:45:56 +01:00
Ralf Wildenhues
ac9c534e65 docs: Tru64/OSF sh treats read as special builtin
* doc/autoconf.texi (Limitations of Builtins): read may exit
upon unreadable or non-existent file with Tru64/OSF 5.1 sh.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-17 07:26:35 +01:00
Eric Blake
65cdbf1393 docs: fix description of m4_ifval
* doc/autoconf.texi (Conditional constructs) <m4_ifval>: Use
correct argument order.
* THANKS: Update.
Reported by Mostafa.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-01-12 07:50:17 -07:00
Ralf Wildenhues
b85c2ea606 docs: link to Gnulib configmake documentation.
* doc/autoconf.texi (Defining Directories): Use proper crossref,
now that the Gnulib manual has a configmake section.
Thanks to Karl Berry.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-10 07:26:54 +01:00
Ralf Wildenhues
30f435ac03 docs: link to 'set -e' shell behavior overview.
* doc/autoconf.texi (Limitations of Builtins): Add link to
Sven Mascheck's 'set -e' page.  Replace broken Opengroup link.
Suggestion by Eric Blake.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-09 07:24:01 +01:00
Ralf Wildenhues
71371cf6ae docs: mention configmake module for defining directories.
* doc/autoconf.texi (Defining Directories): Mention configmake
gnulib module.
Suggestion by Karl Berry and Eric Blake.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-09 07:16:22 +01:00
Eric Blake
b4b41c0c80 doc: improve install.texi texinfo markup
This partially reverts commit 02fa53b195.

* doc/install.texi: Don't force @firstparagraphindent on all
clients; instead, add it only when building INSTALL.  Compress
copyright.
* Makefile.am (INSTALL): Match gnulib's formatting.
Reported by Karl Berry.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-01-04 17:02:55 -07:00
Eric Blake
1864b1a3c4 maint: update copyright year
All files changed to add 2011, via 'make update-copyright'.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-01-04 16:34:06 -07:00
Eric Blake
7420ce3483 maint: resync upstream files
* GNUmakefile: Regenerated by 'make fetch'.
* build-aux/config.guess: Likewise.
* build-aux/config.sub: Likewise.
* build-aux/gendocs.sh: Likewise.
* build-aux/git-version-gen: Likewise.
* build-aux/texinfo.tex: Likewise.
* doc/make-stds.texi: Likewise.
* lib/Autom4te/Channels.pm: Likewise.
* lib/Autom4te/Configure_ac.pm: Likewise.
* lib/Autom4te/FileUtils.pm: Likewise.
* lib/Autom4te/Struct.pm: Likewise.
* lib/Autom4te/XFile.pm: Likewise.

Signed-off-by: Eric Blake <eblake@redhat.com>
2011-01-04 16:33:35 -07:00
Karl Berry
ed8d454684 Avoid using @acronym in install.texi.
* doc/install.texi (Basic Installation, Multiple Architectures)
(Installation Names): Write `GNU' instead of `@acronym{GNU}'.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2011-01-03 03:50:26 +01:00
Reuben Thomas
5668bc9791 docs: avoid first person, and credit history to David MacKenzie
* doc/autoconf.texi (History): Add credit.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-11-10 15:08:00 -07:00
Paul Eggert
89ce53b3a0 docs: Posix now says "((cat))" isn't portable
* doc/autoconf.texi (Parenthesis): Update documentation to reflect
what Posix 1003.1-2008 says about "((".
2010-10-26 16:13:34 -07:00
Eric Blake
b42491e323 docs: document dash bug in <>
* doc/autoconf.texi (File Descriptors): Dash 0.5.5 truncates on
<>; at least this was fixed in dash 0.5.6.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-10-20 17:01:19 -06:00
Eric Blake
efa127444a doc: suggest a few more workarounds
* doc/autoconf.texi (Limitations of Usual Tools) <tr>: Mention
that 'redundant' brackets can work around Solaris bug.
(File Descriptors): Mention that {} works as well as () for
silencing file-not-found warnings.
* THANKS: Update.
Suggested by Pádraig Brady.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-10-05 10:20:43 -06:00
Joshua G. Hale
de12b68dc2 docs: fix typo in AC_CONFIG_FILES example code.
* doc/autoconf.texi (Configuration Actions): Fix typo.
* THANKS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-09-24 21:00:12 +02:00
Eric Blake
d07f81f1ce tests: XFAIL in the face of a MacOS X bug
* doc/autoconf.texi (Limitations of Usual Tools) <sed>: Mention
the issue.
* tests/torture.at (Substitute and define special characters):
Detect if sed cannot process 8-bit bytes in the C locale.
* THANKS: Update.
Reported by Rochan.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-21 14:16:30 -06:00
Eric Blake
842807af6c build: support autobuild
* cfg.mk (gnulib-update): Add autobuild.m4.
* configure.ac (AB_INIT): Output autobuild header.
* m4/autobuild.m4: New file, from gnulib.
* build-aux/config.guess: Resync from upstream.
* build-aux/config.sub: Likewise.
* build-aux/texinfo.tex: Likewise.
* doc/fdl.texi: Likewise.
* doc/gnu-oids.texi: Likewise.
* doc/make-stds.texi: Likewise.
* doc/standards.texi: Likewise.
* build-aux/gendocs.sh: Likewise.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-17 16:58:26 -06:00
Bruno Haible
b99695da25 docs: mark several macros obsolete
* doc/autoconf.texi (Particular Functions): Mark AC_FUNC_ERROR_AT_LINE,
AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK, AC_FUNC_MKTIME, AC_FUNC_STRTOD
as obsolete and refer to Gnulib.
* NEWS: Mention the change.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-17 09:56:27 -06:00
Eric Blake
0cca574572 autotest: work around zsh bug
* lib/autotest/general.m4 (AT_DATA): Special case an empty data
file, since zsh botches empty here-docs.
* doc/autoconf.texi (Writing Testsuites) <AT_DATA>: Document that
this allows empty contents.
* tests/autotest.at (AT_DATA): New test.
Reported by Ralf Wildenhues.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-13 13:28:35 -06:00
Eric Blake
793b3a74c4 docs: mention gnulib portability docs
* doc/autoconf.texi (Function Portability, Header Portability):
Add external links to gnulib.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-13 13:28:16 -06:00
Ralf Wildenhues
97d209ddb1 docs: document zsh specialty with empty here-documents.
* doc/autoconf.texi (Here-Documents): zsh 4.3.10 adds a newline
to empty here-docs.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-09-13 20:27:31 +02:00
Ralf Wildenhues
23a2c336ad docs: document zsh special array $options.
* doc/autoconf.texi (Special Shell Variables): Add entry for
`options'.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-09-13 20:21:31 +02:00
Ralf Wildenhues
cb093133b5 doc: minor updates.
* doc/autoconf.texi (Generic Compiler Characteristics): Use
second argument of @uref consistently, for nicer OpenMP link.
(Polymorphic Variables): Restore font-lock.
(Debugging): Add item for bashdb.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-09-13 20:21:00 +02:00
Ralf Wildenhues
37b43561c5 Document and test AT_CHECK args shell execution environment.
* doc/autoconf.texi (Writing Testsuites): Document that COMMANDS
is run in a subshell, but RUN-IF-FAIL and RUN-IF-PASS are not.
* tests/autotest.at (AT@&t@_CHECK execution environment): New
test.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-09-13 20:19:51 +02:00
Ralf Wildenhues
d85369c9bf autotest: document and test at_status semantics.
* doc/autoconf.texi (Writing Testsuites): Document $at_status.
* tests/autotest.at (at_status): New test.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-09-13 20:19:20 +02:00
Ralf Wildenhues
88eeae7588 doc: index entries for non-environment, non-output variables.
* doc/autoconf.texi: Clarify the meaning of the various variable
indices.  Merge variable index `vr' into concept index using
syncodeindex.
(Configuration Actions, Generic Programs, Generic Functions)
(Writing Testsuites): Add index entries for documented shell
variables used during in configure and testsuite scripts.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-09-13 20:18:10 +02:00
Fernando Carrijo
dfa02369c4 docs: fix minor typo and 'See See foo' instances
* doc/autoconf.texi (Buffer Overruns and Subscript Errors): Fix
usage of TeX superscript notation to correctly represent number
exponent.
(Shell Functions): s/[Ss]ee @xref/@xref/
(Limitations of Shell Builtins, Canonicalizing): Likewise.
* THANKS: Update.

Signed-off-by: Fernando Carrijo <fcarrijo@freedesktop.org>
Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-13 10:20:05 -06:00
Ralf Wildenhues
b8e54a39f0 doc: minor indexing update.
(Shell Substitutions, Site Defaults): Fix markup for indexed
entried, using @code and @file as appropriate.
(M4 Macro Index): Clarify which of the indexed macros have m4_
and which have AS_ prefix.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-09-12 09:40:20 +02:00
Eric Blake
e10883c0df docs: update alloca recommendations
* doc/autoconf.texi (Particular Functions): Don't redeclare alloca
on FreeBSD.
* THANKS: Update.
Reported by Giorgos Keramidas.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-08 09:42:56 -06:00
Eric Blake
0569949c61 docs: link to GNU Coding Standards in intro
* doc/autoconf.texi (Introduction): Actually link to the
standards.  Make other references consistent.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-08 09:13:38 -06:00
Eric Blake
10adce65fe docs: mention traditional awk limitation
* doc/autoconf.texi (Limitations of Usual Tools) <awk>: Mention
that traditional awk lacks ENVIRON.  Add reference to awk manual.
(Particular Programs) <AC_PROG_AWK>: Add reference to awk section.
Reported by Ralf Wildenhues.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-08 08:23:13 -06:00
Eric Blake
4416ea8d25 docs: mention bash vs. POSIXLY_CORRECT
* doc/autoconf.texi (Special Shell Variables) <POSIXLY_CORRECT>:
Document bash behavior.
* THANKS: Update.
Reported by Dustin J. Mitchell, via bug-gnulib list.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-07 13:52:44 -06:00
Eric Blake
d46804252a docs: enhance recommendations on test usage
* doc/autoconf.texi (Limitations of Builtins) <test (strings)>:
Mention yet another Solaris issue.
Reported by Stefano Lattarini.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-09-07 08:40:46 -06:00
Eric Blake
2626155d5c docs: mention Solaris here-docs vs. ${a-"b c"}
* doc/autoconf.texi (Shell Substitutions) <${var:=value}>:
Document problem of "" within here-docs.
Reported by Ralf Wildenhues.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-30 11:16:17 -06:00
Eric Blake
6284d1bef7 docs: avoid use of $tmp outside of config.status use
* doc/autoconf.texi (Polymorphic Variables, Shell Substitutions):
Use $var or $t instead.
(Limitations of Usual Tools): Use $dir instead.
(Initialization Macros) <AS_TMPDIR>: Make good on the NEWS
regarding AS_TMPDIR being documented as consuming $tmp.
Suggested by Ralf Wildenhues.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-30 09:56:41 -06:00
Ralf Wildenhues
e9cceec734 Try to update config.cache atomically; respect symlinks.
* lib/autoconf/general.m4 (AC_CACHE_SAVE): Use `mv -f' to update
the cache file if it is a regular file and not a symlink.  Move
first to temporary name in the target directory if not in the
current directory for atomicity across mount points.
* tests/base.at (AC_CACHE_CHECK): Try symlinked cache file.
* doc/autoconf.texi (Cache Files): Leftover temporary cache
files may be deleted by the user.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-08-27 19:49:28 +02:00
Eric Blake
d1bea5123b m4sh: assume ${a:-b} support
* tests/m4sh.at (Null variable substitution): New test.
* doc/autoconf.texi (Shell Substitutions) <${var:-value}>: Mention
that m4sh guarantees support.
(Limitations of Usual Tools) <mktemp>: Use it.
* lib/m4sugar/m4sh.m4 (AS_LINENO_POP, AS_VAR_IF, AS_TMPDIR):
Exploit use of colon for smaller files.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-27 10:05:10 -06:00
Eric Blake
270b834086 docs: document m4_define_default
* doc/autoconf.texi (Conditional constructs) <m4_define_default>:
Document it, since gnulib wants to use it.
* NEWS: Mention this.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-26 16:24:41 -06:00
Eric Blake
1e604ecfb2 autoconf: warn if AC_*_IFELSE lacks complete program
* lib/autoconf/lang.m4 (AC_LANG_DEFINES_PROVIDED): New macro.
(AC_LANG_SOURCE): Call it.
(AC_LANG_CONFTEST): Add warning if new macro is not called.
* lib/autoconf/c.m4 (_AC_LANG_OPENMP): Add missing AC_LANG_SOURCE.
* lib/autoconf/fortran.m4 (AC_FC_FREEFORM, AC_FC_FIXEDFORM)
(AC_FC_LINE_LENGTH, __AC_FC_NAME_MANGLING): Intentionally bypass
AC_LANG_SOURCE.
* lib/autoconf/programs.m4 (_AC_PROG_LEX_YYTEXT_DECL): Likewise.
* tests/compile.at (AC_COMPILE_IFELSE): New test.
* doc/autoconf.texi (Generating Sources) <AC_LANG_CONFTEST>:
Document new warning.
<AC_LANG_DEFINES_PROVIDED>: Document new macro.
<AC_LANG_SOURCE>: Document use of new macro.
* NEWS: Document the improvement.
Suggested by Bruno Haible.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-26 15:24:13 -06:00
Eric Blake
b292f282e2 docs: mention another issue with variable expansion
In particular, see http://austingroupbugs.net/view.php?id=221
and http://austingroupbugs.net/view.php?id=255.

* doc/autoconf.texi (Shell Substitutions) <${var+value}>: New
subsection.
<${var=literal}>: Tweak wording.  Add mention of an ambiguity
allowed by POSIX.
* tests/torture.at (Substitute and define special characters):
Make test more robust; here, the outer "" is in a here-doc, and
does not violate the quoting rules of thumb just documented.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-26 11:27:49 -06:00
Eric Blake
cb27df430d docs: mention cost of globbing during variable expansion
* doc/autoconf.texi (Shell Substitutions) <${var=literal}>:
Recommend quoting substitutions that might trigger globbing.
(Limitations of Builtins) <:>: Likewise.
* bin/autoconf.as: Follow our own advice.
* lib/autoconf/functions.m4 (AC_FUNC_SELECT_ARGTYPES): Likewise.
* lib/autoconf/general.m4 (_AC_INIT_PARSE_ARGS): Likewise.
* lib/autoconf/status.m4 (AC_OUTPUT): Likewise.
* lib/autotest/general.m4 (_AT_FINISH): Likewise.
* lib/m4sugar/m4sh.m4 (AS_TMPDIR): Likewise.
* tests/autotest.at (parallel autotest and signal handling):
Likewise.
* tests/c.at (AC_OPENMP and C, AC_OPENMP and C++): Likewise.
* tests/foreign.at (shtool): Likewise.
* tests/fortran.at: Likewise.
* tests/tools.at (autom4te preselections): Likewise.
* tests/torture.at (VPATH): Likewise.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-25 17:22:18 -06:00
Ralf Wildenhues
3b418ae86b doc: AIX sed dislikes indented comments.
* doc/autoconf.texi (Limitations of Usual Tools) <sed>: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-08-22 15:58:32 +02:00
Stefano Lattarini
1027010dcd autoreconf: mention the AUTOM4TE environment variable
* doc/autoconf.texi (Using autoreconf to Update configure
Scripts): List `AUTOM4TE' among the environment variables
honored by autoreconf.
* bin/autoreconf.in ($help): Likewise.
2010-08-19 10:55:53 -06:00
Eric Blake
6c2fe4a197 doc: improve AS_VAR_IF details
* doc/autoconf.texi (Polymorphic Variables) <AS_VAR_IF>: Make it
clear that user must supply quotes as needed.
* THANKS: Update.
Suggested by Randall Cotton.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-17 08:19:39 -06:00
Eric Blake
64000cf1f8 AC_INIT: allow bugreport to contain '?'
* lib/autoconf/general.m4 (_AC_INIT_PACKAGE): Relax check.
* tests/base.at (AC_INIT with unusual version strings): Enhance
test.
* doc/autoconf.texi (Initializing configure): Document this.
* NEWS: Likewise.
* THANKS: Update.
Reported by Yavor Doganov and others.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-14 13:24:53 -06:00
Ralf Wildenhues
3fdd727caa Fix description of AC_CONFIG_TESTDIR to not mention atconfig.in.
* doc/autoconf.texi (Making testsuite Scripts): atconfig is not
created from an input template.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-08-06 23:00:46 +02:00
Eric Blake
5adc15b7b6 docs: mention bash bug with word splitting
* doc/autoconf.texi (Shell Substitutions): Document bash bug, and
zsh default behavior difference.
Reported by Ralf Wildenhues.
2010-08-03 16:10:04 -06:00
Eric Blake
608c89c8c6 docs: mention ksh bug with function syntax
* doc/autoconf.texi (Shell Functions): Document ksh93 limitation.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-08-03 16:05:16 -06:00
Ralf Wildenhues
a5e9aa68b7 Ensure unnamed test group categories are separated from previous.
* doc/autoconf.texi (Writing Testsuites) <AT_BANNER>: Update
description.
* lib/autotest/general.m4 (AT_INIT) <at_fn_banner>: Set banner
to single space, not empty line, once printed.  For empty
banners, print a single empty line to separate them from a
previous test group category.
* tests/autotest.at (Banners): Insert another test group; adjust
tests accordingly.  Extend test to cover semantic change.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-08-02 22:17:50 +02:00
Eric Blake
14f352e388 docs: mention ksh file descriptor limitation
* doc/autoconf.texi (File Descriptors): Document issue with fd 10
and above.
Reported by Ralf Wildenhues.
2010-07-29 16:22:19 -06:00
Eric Blake
4e7b9effea docs: mention cd limitation
* doc/autoconf.texi (Limitations of Builtins) <cd>: Document
issues with empty argument.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-29 16:21:20 -06:00
Ralf Wildenhues
0262e7e7d1 Add missing index entries to manual.
* doc/autoconf.texi (Fortran Compiler, Language Choice): Add
index entries for AC_FC_DUMMY_MAIN, AC_LANG; reformat entry for
AC_LANG_ASSERT.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-07-29 22:04:00 +02:00
Eric Blake
9571a4b323 Avoid spurious testsuite failures.
* doc/autoconf.texi (Generating Sources): Don't mix gcc '-E' and
'-o -', since the former already implies stdout, while the latter
creates -.exe on cygwin.
* tests/compile.at (AC_LANG_SOURCE example)
(AC_LANG_PROGRAM example): Likewise.  Also prevent any config.site
interference.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-21 16:13:05 -06:00
Eric Blake
fbd1b9e4fb Close job control fd before running tests.
* doc/autoconf.texi (File Descriptors): Clarify limitations.
* lib/autotest/general.m4 (AT_CLEANUP): Avoid leaking job control
fifo fd to user tests.
(AT_INIT): Delete comment, now that close is done elsewhere.
Suggested by Ralf Wildenhues.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-20 22:11:14 -06:00
Eric Blake
a759826d21 Also reject ' and newline from AC_INIT strings.
* lib/autoconf/general.m4 (_AC_INIT_LITERAL): Reject a couple more
problematic characters.
* tests/base.at (AC_INIT with unusual version strings): Enhance
test.
* doc/autoconf.texi (Initializing configure) <AC_INIT>: Further
clarifications, and clean up wording about use of m4_esyscmd.
* NEWS: Update previous news entry.
Suggested by Paolo Bonzini.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-20 08:01:15 -06:00
Ralf Wildenhues
e4d629f5b5 Fix typo in the manual.
* doc/autoconf.texi (AC_ACT_IFELSE vs AC_TRY_ACT): Fix typo.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-07-20 07:06:55 -06:00
Eric Blake
77469e1b54 Fix up AC_INIT vs. " issues, and document it.
* doc/autoconf.texi (Initializing configure): Improve
documentation on argument restrictions.
* NEWS: Tweak information.
* lib/autoconf/general.m4 (_AC_INIT_GENERAL): New macro, that also
rejects literal ".
(_AC_INIT_PACKAGE): Use it to plug hole in last patch.
* tests/base.at (AC_INIT with unusual version strings): Enhance
test.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-19 17:32:04 -06:00
Ralf Wildenhues
2fd37d5d0a Allow inspecting AC_PREPROC_IFELSE output in true branch.
* lib/autoconf/general.m4 (_AC_PREPROC_IFELSE_BODY): Redirect
preprocessor output to conftest.i rather than /dev/null.
(_AC_PREPROC_IFELSE): Remove conftest.i in the postprocessing.
* tests/compile.at (Order of user actions and cleanup): Extend
test in the ACTION-IF-TRUE branch.
* doc/autoconf.texi (Running the Preprocessor): Document new
feature.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-07-19 20:03:27 +02:00
Ralf Wildenhues
d847c5d01b manual: compiler flags -D and -L should not be followed by space
* doc/autoconf.texi (Preset Output Variables): Remove space
between -D and -L flags and their arguments, traditional cpp
implementations like Solaris 10, IRIX 6.5, OSF Tru64 5.1D,
AIX 5.3 do not accept it.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-19 08:05:40 -06:00
Ralf Wildenhues
a90f3e25cc Fix comment typo in the manual.
* doc/autoconf.texi (Generic Compiler Characteristics): Refer
to the right test in the example marker comment.
Spotted by Eric Blake.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-07-10 18:41:21 +02:00
Ralf Wildenhues
06089e7f3c New Fortran macro AC_FC_LINE_LENGTH.
* lib/autoconf/fortran.m4 (AC_FC_LINE_LENGTH): New macro.
* doc/autoconf.texi (Fortran Compiler): Document it.
* tests/fortran.at (AC_FC_LINE_LENGTH): New test.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-07-10 18:40:55 +02:00
Ralf Wildenhues
66fd9a3750 Fix wording about AC_CONFIG_SUBDIRS warning.
* doc/autoconf.texi (Subdirectories): We warn, not error, about
nonexistent config subdirs, but only at configure run time.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-07-10 18:40:04 +02:00
Eric Blake
dfda440255 Fix regression of AC_CHECK_SIZEOF on pointer types.
* lib/autoconf/types.m4 (AC_CHECK_SIZEOF): Translate `*' to `p'
when checking literal-ness of the type, for pointer types.
* lib/m4sugar/m4sh.m4 (_AS_TR_SH): Also consider `*' as literal.
(_AS_TR_CPP): Likewise.
* tests/semantics.at (AC_CHECK_ALIGNOF struct): When checking
for numeric answer, be sure to not allow variable references.
(AC_CHECK_SIZEOF struct): Likewise.  Also, test the
`AC_CHECK_SIZEOF([int *])' example from the manual.
* doc/autoconf.texi (Generic Compiler Characteristics): Add
example marker.
* NEWS: Update.
Reports by Nishio Futoshi and Roberto Bagnara.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-07-10 08:16:35 +02:00
Ralf Wildenhues
49a6f8a8b5 Fix regression of AC_CONFIG_SUBDIRS with multiple arguments.
* lib/autoconf/status.m4 (AC_CONFIG_SUBDIRS): Do not assume the
argument is a single word.
* tests/torture.at (Deep Package): Extend test to cover this.
(Non-literal AC_CONFIG_SUBDIRS): New test.
* doc/autoconf.texi (Subdirectories): Add example marker.
* NEWS: Update.
Report by Bruno Haible.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-07-08 06:43:33 +02:00
Eric Blake
cee5094186 Resync upstream files.
* GNUmakefile: Run 'make fetch'.
* build-aux/announce-gen: Likewise.
* build-aux/config.guess: Likewise.
* build-aux/config.sub: Likewise.
* build-aux/gendocs.sh: Likewise.
* build-aux/git-version-gen: Likewise.
* build-aux/gnupload: Likewise.
* build-aux/texinfo.tex: Likewise.
* build-aux/vc-list-files: Likewise.
* doc/gendocs_template: Likewise.
* doc/gnu-oids.texi: Likewise.
* doc/make-stds.texi: Likewise.
* doc/standards.texi: Likewise.
* lib/Autom4te/Channels.pm: Likewise.
* lib/Autom4te/Configure_ac.pm: Likewise.
* lib/Autom4te/FileUtils.pm: Likewise.
* lib/Autom4te/XFile.pm: Likewise.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-02 15:58:07 -06:00
Ralf Wildenhues
0da057e20a New macro AC_FC_FIXEDFORM, improved AC_FC_FREEFORM, coverage.
* lib/autoconf/fortran.m4 (_AC_FC_DIALECT_YEAR): Fix typo in
comment.
(AC_FC_FREEFORM): Update list of known options for Sun, HP,
Lahey/Fujitsu Fortran compilers.  Use M4 quoting consistently.
(AC_FC_FIXEDFORM): New macro.
* tests/fortran.at (AC_FC_DUMMY_MAIN usage, AC_FC_MAIN usage):
Use AC_FC_FIXEDFORM, to avoid testsuite failure with FC=xlf95.
(AC_FC_FREEFORM with AC_FC_SRCEXT, AC_FC_FIXEDFORM)
(AC_FC_FIXEDFORM with AC_FC_SRCEXT): New tests.
* tests/mktests.sh: No need to exclude AC_FC_FREEFORM, it uses
AC_LANG_PUSH/AC_LANG_POP.
* doc/autoconf.texi (Fortran Compiler): Document it.
* NEWS: Update.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-02 13:45:04 -06:00
Eric Blake
64954f9188 Optimize AS_BOX.
* lib/m4sugar/m4sh.m4 (AS_BOX): Use less m4 time.
(_AS_BOX_LITERAL): Use fewer forks in the common case.
* doc/autoconf.texi (Common Shell Constructs) <AS_BOX>: Document
the macro.
* NEWS: Mention it.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-02 12:11:17 -06:00
Eric Blake
ac6824d442 Add tests for AS_BOX.
* tests/m4sugar.at (m4@&t@_text_box): New test.
* tests/m4sh.at (AS@&t@_BOX): Likewise.
* lib/m4sugar/m4sugar.m4 (m4_text_box): Support comma.
* doc/autoconf.texi (Text processing Macros) <m4_text_box>:
Document further limitations.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-02 12:10:36 -06:00
Eric Blake
e960d7be02 Add optional argument to AS_LITERAL_IF.
* lib/m4sugar/m4sh.m4 (_AS_LITERAL_IF): Rewrite to generate macro
name, without using m4_cond.
(_AS_LITERAL_IF_, _AS_LITERAL_IF_YES, _AS_LITERAL_IF_NO): New
helpers.
(AS_LITERAL_IF, AS_LITERAL_WORD_IF, _AS_TR_SH, _AS_TR_CPP)
(_AS_VAR_PUSHDEF): Adjust callers.
* lib/autoconf/types.m4 (AC_CHECK_ALIGNOF): Relax restrictions on
invalid bytes, since this allows inline struct layouts.
(_AC_CHECK_ALIGNOF): New helper macro.
* tests/m4sh.at (AS@&t@_LITERAL_IF): Update test.
* doc/autoconf.texi (Polymorphic Variables) <AS_LITERAL_IF>:
Update documentation.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-02 12:10:09 -06:00
Eric Blake
07263c965a Add AS_LITERAL_WORD_IF.
* lib/m4sugar/m4sh.m4 (_AS_LITERAL_IF): Also reject shell quoting
characters as non-literal, and provide way to reject space.
(AS_LITERAL_WORD_IF): New macro.
* doc/autoconf.texi (Polymorphic Variables) <AS_LITERAL_IF>:
Document new macro.  Fix example to match reality.
* NEWS: Document change and new macro.
* tests/m4sh.at (AS@&t@_LITERAL_IF): Update test.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-02 11:35:34 -06:00
Stefano Lattarini
b6a515746a Describe a Solaris /bin/sh bug w.r.t. for loops.
Fix the commit (forgot to 'git add .').

* doc/autoconf.texi (Limitations of Shell Builtins) <for>:
Document a bug of the 'for' builtin in Solaris /bin/sh, w.r.t.
tokens seeming variable assignment in the list of arguments.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-02 10:41:49 -06:00
Stefano Lattarini
a20b49a348 Describe a Solaris /bin/sh bug w.r.t. for loops.
* doc/autoconf.texi (Limitations of Shell Builtins) <for>:
Document a bug of the 'for' builtin in Solaris /bin/sh, w.r.t.
tokens seeming variable assignment in the list of arguments.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-07-02 10:36:15 -06:00
Ralf Wildenhues
d11a65ced6 Further improve docs about nested double-quotes and backquotes.
* doc/autoconf.texi (Shellology): Remove anchor for pdksh.
Move quoting bug example to ...
(Shell Substitutions): ... here.  Document which behavior is
specified by Posix.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-23 20:41:34 +02:00
Ralf Wildenhues
c14e7a1c8a Coverage for Fortran compiler macros.
* tests/fortran.at (AC_OPENMP and Fortran 77)
(AC_OPENMP and Fortran): Simplify, using AT_CHECK_CONFIGURE.
(AC_F77_DUMMY_MAIN usage, AC_FC_DUMMY_MAIN usage)
(AC_F77_MAIN usage, AC_FC_MAIN usage, AC_F77_FUNC usage)
(AC_FC_FUNC usage, AC_FC_SRCEXT usage, AC_FC_FREEFORM): New
tests.
* doc/autoconf.texi (Fortran Compiler): Use GNU coding style
on C code snippets.  Add markers for tested examples.
Suggest AC_FC_FREEFORM for source file extensions which the
compiler might not natively support but which are accepted
with help from AC_FC_SRCEXT.  Suggest AC_CONFIG_HEADERS for
setups using one of the AC_*MAIN macros.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-23 19:18:14 +02:00
Ralf Wildenhues
0fc8e49cd5 Further clarification on sed -e portability.
See also http://austingroupbugs.net/view.php?id=262 and
http://austingroupbugs.net/view.php?id=264.

* doc/autoconf.texi (Limitations of Usual Tools) <sed>: Clarify
more about sed -e and Posix limitations.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-06-22 21:31:39 -06:00
Bruno Haible
60e32aa3fc Document how to use literal newlines in makefile rules.
* doc/autoconf.texi (Newlines in Make Rules): New section.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-06-22 20:42:47 -06:00
Bruno Haible
85b2b2056e Document how to write comments in makefile rules.
* doc/autoconf.texi (Comments in Make Rules): Mention a workaround
syntax.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-06-22 20:40:53 -06:00
Ben Pfaff
eb1ca4966a Document how to propogate variables to submakes.
On bug-gnulib, archived at
     http://permalink.gmane.org/gmane.comp.lib.gnulib.bugs/22132
Ralf Wildenhues taught me a bit about how Automake propagates
variables to submakes.  I thought that it would good to document
this in the Autoconf manual, which currently has no detail at
all.

* doc/autoconf.texi: Describe technique used by Automake to
propagate variables to submakes in more detail.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-06-22 20:29:05 -06:00
Peter Johansson
bea3f1684a Be consistent in doc example.
* doc/autoconf.texi: (Polymorphic Variables) be consistent in code
example and output

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-06-22 20:26:16 -06:00
Ralf Wildenhues
de8b1ecbdb Add comments for vim syntax highlighting.
* doc/autoconf.texi: Restore font-lock in some examples using
$$, for vim.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-22 23:50:33 +02:00
Ralf Wildenhues
f4012a626e Formatting cleanups for optional arguments.
* doc/autoconf.texi (Configuration Actions, Help Formatting)
(External Software): Use @r{} for brackets denoting optional
arguments, where @ovar is not safe to use.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-22 23:50:03 +02:00
Ralf Wildenhues
bba5963d58 Clarify nested double-quotes and backquotes shell issues.
* doc/autoconf.texi (Shellology): New anchor for pdksh.
(Shell Substitutions): Link to it for escaped double-quotes
within double-quoted backquotes; add ksh example for unescaped
inner double-quotes problem.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-22 20:28:12 +02:00
Ralf Wildenhues
fda8d216db Mention Tru64 5.1 fgrep limitation with emtpy patterns.
* doc/autoconf.texi (Limitations of Usual Tools): Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-22 20:27:31 +02:00
Ralf Wildenhues
c4cb4ffa1d Overhaul the manual, esp. the Autotest chapter.
* doc/autoconf.texi (Installation Directory Variables):
Replace some uses of @var with @code.
(Special Shell Variables): Fix misordered paragraph about IFS.
(Writing Testsuites): Include paragraph following AT_TESTED in
the macro definition.
(testsuite Invocation): Failed tests are not rerun.
(testsuite Scripts, Autotest Logs, testsuite Invocation)
(Making testsuite Scripts): Minor edits for consistency and
language.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-22 20:26:33 +02:00
Bruno Haible
f08d6f4f9f Document sed -e limitation.
* doc/autoconf.texi (Limitations of Usual Tools): Mention portability
problem of sed -e option with script fragments.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-06-18 09:11:09 -06:00
Ralf Wildenhues
eace0e6fec Document, test, and fix AT_ARG_OPTION, AT_ARG_OPTION_ARG.
* lib/autotest/general.m4 (_AT_ARG_OPTION): Fix translation of
hyphens to underscores when turning option names to variables.
Avoid macro name concatenation garbage with trailing `dnl'.
(AT_ARG_OPTION, AT_ARG_OPTION_ARG): Overhaul macro description.
The OPTIONS are space-separated, not comma-separated.  The
negative form of AT_ARG_OPTION is prefixed with `--no-'.
* tests/autotest.at (AT@&t@_ARG_OPTION, AT@&t@_ARG_OPTION_ARG):
New tests.
* NEWS: Update.
* doc/autoconf.texi (Writing Testsuites): Document AT_ARG_OPTION
and AT_ARG_OPTION_ARG.
(testsuite Invocation): Call the thingies passed to the
testsuite options, not arguments.  Note that the testsuite
author may add further package-specific options.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-17 22:44:02 +02:00
Ralf Wildenhues
b426665e77 Autotest: enable colored test results.
* lib/autotest/general.m4 (HELP_TUNING_BEGIN): New diversion.
(HELP_TUNING, HELP_OTHER, HELP_END): Bump diversion numbers.
(AT_INIT): Accept
--color and --color=never|auto|always.  If desired, colorize
test results and testsuite summary on standard output.
[HELP_TUNING]: Divert content instead to ...
[HELP_TUNING_BEGIN]: ... this diversion, m4_wrapped until the
end, when we know whether AT_COLOR_TESTS has been specified.
(AT_COLOR_TESTS): New macro, set the default for color to auto.
* doc/autoconf.texi (Writing Testsuites): Document it.
(testsuite Invocation): Document --color* options.
* tests/local.at: Call AT_COLOR_TESTS for Autoconf's testsuite.
* tests/autotest.at (color test results): New test, mirroring
color.test from Automake.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-17 22:36:01 +02:00
Ralf Wildenhues
7f65b3b009 Avoid texinfo bug with backslashes in macro arguments.
* doc/autoconf.texi (Text processing Macros)
(Common Shell Constructs): Do not use @dvar with backslashes.
2010-06-15 19:12:26 +02:00
Eric Blake
5941816dd9 Make CONFIG_SITE handling more robust.
* lib/autoconf/general.m4 (AC_SITE_LOAD): Avoid leading - and path
search, and check for failure to load.
* tests/base.at (AC_CACHE_CHECK): Enhance test.
* doc/autoconf.texi (Site Defaults): Mention that CONFIG_SITE
works best as an absolute path.
* NEWS: Document the semantic change.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-06-14 14:40:49 -06:00
Bruno Haible
ee0ecf0c37 Allow plus signs in AC_ARG_ENABLE and AC_ARG_WITH.
* doc/autoconf.texi (External Software): Mention that AC_ARG_WITH
accepts packages with a + sign in it.
(Package Options): Likewise for AC_ARG_ENABLE.
* lib/autoconf/general.m4 (_AC_ENABLE_IF): Also replace '+' with '_'.
* tests/base.at (AC_ARG_ENABLE and AC_ARG_WITH): New test.
* NEWS: Update.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-06-14 13:56:46 -06:00
Ralf Wildenhues
41bd1b25dc New Autotest testsuite option --recheck.
* lib/autotest/general.m4 (AT_INIT): New variable $at_recheck.
Escape hyphen in $at_dir early.  Accept command line switch
--recheck.  Set $at_suite_log early, based on --directory
switch; with --recheck, include the list of FAILed and XPASSed
tests from old testsuite.log file in $at_groups.  Document
--recheck in --help output.
* tests/autotest.at (recheck): New test.
* doc/autoconf.texi (testsuite Invocation): Document --recheck.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-14 20:37:38 +02:00
Ralf Wildenhues
c106e61216 Coverage and doc fixes for AC_LANG_SOURCE and AC_LANG_PROGRAM.
* tests/compile.at (AC_LANG_SOURCE, AC_LANG_SOURCE(C++))
(AC_LANG_SOURCE example, AC_LANG_PROGRAM example): New tests.
* doc/autoconf.texi (Generating Sources): Add markers for tested
examples; update quoting, and update AC_INIT usage to also set
optional URL arguments.  Mention that the examples require gcc.
Prompted by report from Brian J. Murrell.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-08 06:56:43 +02:00
Ralf Wildenhues
cddfaa966c Make AS_SET_CATFILE polymorphic, and add testsuite coverage.
* lib/m4sugar/m4sh.m4 (AS_SET_CATFILE): Use AS_VAR_SET to set
the variable.
* tests/m4sh.at (AS@&t@_SET_CATFILE): New test.
* doc/autoconf.texi (Common Shell Constructs): Document that
AS_SET_CATFILE is polymorphic in its VAR argument now.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-08 06:55:10 +02:00
Ralf Wildenhues
a535b586ad Testsuite coverage for AC_CACHE_VAL and caching semantics.
* tests/base.at (AC_CACHE_CHECK): Extend test.
(AC_CACHE_LOAD): New test.
* tests/torture.at (Configuring subdirectories): Also test
--config-cache with AC_CONFIG_SUBDIRS.
* doc/autoconf.texi (Caching Results): Annotate code snippets
which are tested in the test suite.
(Cache Files): Documented cache variables may be used on the
configure command line to override individual entries in the
cache file.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-08 06:49:55 +02:00
Ralf Wildenhues
521a461557 Clarify OpenBSD sh errexit issue with compound commands.
* doc/autoconf.texi (Limitations of Builtins): Only the last
command in a compound list is problematic.
Tested on OpenBSD 4.4.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-08 06:48:34 +02:00
Ralf Wildenhues
ebc0ae4a4c Documentation and tests for the AC_CHECK_DECL change.
* lib/autoconf/general.m4 (_AC_CHECK_DECL_BODY): Squash trailing
spaces in as_decl_name.
(_AC_CHECK_DECLS): Likewise for the define.
* tests/semantics.at (AC_CHECK_DECLS): Extend test.
* doc/autoconf.texi (Generic Declarations): Update.
* NEWS: Update.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-06-01 22:47:56 +02:00
Stefano Lattarini
f44e1243ec Don't expose AC_{COMPILE,LINK}_IFELSE internals in documentation.
* doc/autoconf.texi (Runtime) <AC_LINK_IFELSE>: Suggest to use
`conftest$EXEEXT' rather than `conftest$ac_exeext' to acces the
just-linked program file.
(Runtime) <AC_COMPILE_IFELSE>: Suggest to use `conftest.$OBJEXT'
rather than `conftest.$ac_object' to access the just-compiled
object file.  Also, refer to the object file as "just-compiled"
rather than "just-linked".
2010-06-01 09:34:16 +02:00
Eric Blake
f91e8dbe6d Mention another line-counting alternative.
GCS lists sed but not wc as a portable app for Makefile.

* doc/autoconf.texi (Limitations of Usual Tools) <grep>: Mention
how to use sed to count lines.
Suggested by Paolo Bonzini.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-05-20 15:08:05 -06:00
Eric Blake
64f8fde40c Document the grep workaround.
* doc/autoconf.texi (Limitations of Usual Tools) <grep>: Document
the bug.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-05-12 08:39:58 -06:00
David Reiss
0139d1718c Improve Erlang documentation.
* doc/autoconf.texi (Erlang Libraries): Document actual default
values.
* THANKS: Update.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-05-11 14:32:02 -06:00
Eric Blake
9254d2978b Fix typo in previous patch.
* doc/autoconf.texi (File Descriptors): Add end '.
Reported by Ralf Wildenhues.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-05-11 14:13:32 -06:00
Eric Blake
41a163620f Mention how to silence program probes.
* doc/autoconf.texi (File Descriptors): Document how to silence a
program probe.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-05-11 08:02:59 -06:00
Ralf Wildenhues
5dc7189c00 Error and warning message formatting cleanups.
* doc/autoconf.texi (Autoconf Language, Generic Structures):
Do not capitalize the first word in error messages, do not end
them with a period.
* lib/autoconf/general.m4 (_AC_INIT_PARSE_ARGS, AC_MSG_FAILURE):
Likewise.
* lib/autoconf/status.m4 (_AC_OUTPUT_FILE): Likewise.
* lib/autotest/general.m4 (AT_INIT, at_fn_group_prepare):
Likewise.
* m4/m4.m4 (AC_PROG_GNU_M4): Likewise.
* tests/base.at (AC_TRY_COMMAND): Likewise.
* tests/torture.at (datarootdir workaround): Adjust expected
message.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-04-26 20:34:14 +02:00
Eric Blake
a7902d0d7f Clarify octal escapes with tr.
* doc/autoconf.texi (Limitations of Usual Tools): Carriage return
is portable in octal, but not newline.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-04-26 09:35:18 -06:00
Joel James Adamson
df346df6a0 Add a paragraph to FAQ on Debugging configure scripts.
* doc/autoconf.texi (Debugging): Mention inspecting config.log.
* THANKS: Update.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-04-22 11:57:25 -06:00
Mike Frysinger
f2298ccb8f manual: fix minor typo in AC_CONFIG_SUBDIRS example
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
2010-04-21 08:03:56 -06:00
Ralf Wildenhues
c22b5e03a9 Do not use @acronym in the manual.
* doc/autoconf.texi: Remove all usage of @acronym.
Suggested by Karl Berry.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-03-28 17:55:44 +02:00
Ralf Wildenhues
6bfa3fe3e0 Do not use @sc in the manual.
* doc/autoconf.texi: Remove all usage of @sc in the manual.
Suggested by Karl Berry.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-03-28 17:54:39 +02:00
Ralf Wildenhues
07156c06ae manual: index strings containing colon in non-info outputs.
* doc/autoconf.texi (Quadrigraphs, Shell Substitutions): Produce
index entries for concepts containing a colon in output formats
other than info.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-03-06 00:09:52 +01:00
Eric Blake
d93bd4bfbb Document AC_LANG_CONFTEST semantic change.
* doc/autoconf.texi (Generating Sources) <AC_LANG_CONFTEST>:
Enhance documentation, to show that semantic change in 2.63b was
intentional.
* THANKS: Update.
Reported by Brian J. Murrell, analyzed by Ralf Wildenhues.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-03-04 08:58:51 -07:00
Peter Johansson
2f018ebb04 Autoconf Macro Archive URL has changed.
* doc/autoconf.texi (Introduction, Coding Style, Defining
Directories): The Autoconf Macro Archive is officially `GNU'.
Update URL.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-03-04 08:54:32 -07:00
Eric Blake
d174a5362e Fix shell code in AS_TR_SH documentation.
* doc/autoconf.texi (Common Shell Constructs) <AS_TR_SH>: Fix
example to expand to valid shell code.
Reported by Ralf Wildenhues.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-03-02 15:39:58 -07:00
Eric Blake
026070fea8 Improve documentation on AC_{COMPILE,LINK}_IFELSE.
* doc/autoconf.texi (Running the Compiler): Mention that the
object file is available after a successful compile.
(Running the Linker): Likewise for the linker output.
Suggested by Paolo Bonzini.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-03-02 14:32:07 -07:00
Eric Blake
dcd879464e Fix typo in docs.
* doc/autoconf.texi (Conditional constructs) <m4_ifblank>: Fix
typo.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-03-02 14:31:09 -07:00
Ralf Wildenhues
475ccc750c Fix Autotest tracing of shell pipelines for FreeBSD sh.
* lib/autotest/general.m4 (_AT_DECIDE_TRACEABLE): Do not trace
commands that contain [^|]|[^|], a likely shell pipeline.
* tests/local.at (_AT_CHECK_ENV): Turn off tracing for egrep |
grep pipeline.
* doc/autoconf.texi (File Descriptors): Document limitation.
* tests/autotest.at (Trace output): New test.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2010-03-02 07:48:42 +01:00
Eric Blake
346e5876eb Update file flow diagram to mention Automake.
* doc/autoconf.texi (Making configure Scripts): Avoid confusion
with listing Makefile.in twice on one line.  Add a diagram showing
how automake fits into the picture.
Reported by santilín.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-03-01 10:56:06 -07:00
Eric Blake
534a64aef3 Document how to safely override CFLAGS default.
* doc/autoconf.texi (C Compiler) <AC_PROG_CC>: Document a way to
change the default CFLAGS.
(C++ Compiler) <AC_PROG_CXX>: Likewise, for CXXFLAGS.
Reported by Monty Taylor; wording suggested by Paolo Bonzini.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-02-26 10:00:45 -07:00
Eric Blake
41ec811b56 Document that Autoconf relies on IFS.
* doc/autoconf.texi (Special Shell Variables) <IFS>: Add details
about use of IFS within configure script.
* THANKS: Update.
Reported by Arkadiusz Miskiewicz.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-02-26 09:48:24 -07:00
Eric Blake
4a8168ae1e Recommend latest m4 release.
* README: Bump recommendation to m4 1.4.14 (minimum remains
1.4.6).
* doc/autoconf.texi (Introduction): Likewise.
* m4/m4.m4 (AC_PROG_GNU_M4): Likewise.

Signed-off-by: Eric Blake <eblake@redhat.com>
2010-02-26 09:47:10 -07:00
Paolo Bonzini
e51c9919f2 Add recommendation on (not) unsetting IFS.
* doc/autoconf.texi (Special shell variables): Explain why it's
better not to unset IFS.
2010-01-21 12:16:42 +01:00
Eric Blake
56f5b9bc6a Fix previous example.
* doc/autoconf.texi (Here-Documents): Touch up the example to
match output to sample command line.

Signed-off-by: Eric Blake <ebb9@byu.net>
2010-01-14 06:55:49 -07:00
Eric Blake
f4fc1ad9bb Document here-doc pitfall.
* doc/autoconf.texi (Here-Documents): Mention problem with <<-
operator.
Reported by Jim Meyering.

Signed-off-by: Eric Blake <ebb9@byu.net>
2010-01-13 06:10:31 -07:00
Eric Blake
a21c6c2ea6 Typo fix in earlier commit.
* doc/autoconf.texi (Autoconf Language): Fix typo.

Signed-off-by: Eric Blake <ebb9@byu.net>
2010-01-12 20:52:31 -07:00