Commit Graph

1903 Commits

Author SHA1 Message Date
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