Commit Graph

62 Commits

Author SHA1 Message Date
Eric Blake
97b5046ccd Improve INSTALL wording.
* doc/install.texi (Basic Installation): Clarify installcheck
behavior.
(Installation Names): Mention that --prefix only overrides
directory locations not specified on the command line.  Prefer
/alternate/directory over /path/to.  Remove a sentence targeted to
the developer, not the user.
* THANKS: Update.
Suggested by Alfred M. Szmidt.

Signed-off-by: Eric Blake <ebb9@byu.net>
2009-10-15 07:01:07 -06:00
Eric Blake
4f8ae51842 Document some optional features in INSTALL.
* doc/install.texi (Basic Installation): Mention that INSTALL is
generic, and that not all packages implement all features.
Mention 'make distcheck' for maintainers, and 'make installcheck'
for users.  Mention the GNU Coding Standards.
(Installation Names): Mention DESTDIR vs. 'make prefix= install'
as ways to alter the configuration, with caveats of each.  Move
--program-prefix discussion...
(Optional Features): ...here.  Mention --enable-silent-rules and
use of make V=0.

Signed-off-by: Eric Blake <ebb9@byu.net>
2009-07-26 21:03:09 -06:00
Eric Blake
9b7d3d1676 Basic improvements to INSTALL.
* doc/install.texi (Basic Installation): Use better markup.
(Multiple Architectures): Introduce the term VPATH.
(Installation Names): Mention that --prefix must be absolute.
* doc/autoconf.texi (Preset Output Variables)
(Installation Directory Variables): Consistently refer to GNU
Coding Standards.

Signed-off-by: Eric Blake <ebb9@byu.net>
2009-07-26 21:02:38 -06:00
Eric Blake
6382b687fd Update uses of all-permissive license.
* ChangeLog: Relicense under GPL.
* ChangeLog.0: Likewise.
* ChangeLog.1: Likewise.
* ChangeLog.2: Likewise.
* THANKS: Likewise.
* m4/m4.m4: Use latest wording of FSF all-permissive license.
* m4/make-case.m4: Likewise.
* doc/install.texi: Likewise.
* tests/statesave.m4: Relicense to match rest of testsuite; this
file does not need all-permissive license since it is not designed
for reuse by other packages.
* BUGS: Relicense under all-permissive license.
* HACKING: Likewise.
* NEWS: Likewise.
* README: Likewise.
* README-alpha: Likewise.
* README-hacking: Likewise.
* TODO: Likewise.

Signed-off-by: Eric Blake <ebb9@byu.net>
2009-05-20 06:02:49 -06:00
Eric Blake
e5f657f31e Improve confusing section names.
* doc/autoconf.texi (Specifying Names): Rename node...
(Specifying Target Triplets): ...to this.
(Generic Programs): Adjust references.
* doc/install.texi (System Type): Touch up formatting.
* THANKS: Update.
Reported by Tim Freeman, in http://bugs.debian.org/312873.

Signed-off-by: Eric Blake <ebb9@byu.net>
2009-03-17 06:38:07 -06:00
Bruno Haible
0b31661907 Improve INSTALL for HP-UX.
* doc/install.texi (Particular Systems): For HP-UX, also recommend
-D_XOPEN_SOURCE=500. Needed for the declaration of mbstate_t on
HP-UX 11.11.

Signed-off-by: Eric Blake <ebb9@byu.net>
2008-12-23 21:09:21 -07:00
Bruno Haible
192ecc0b05 Improve INSTALL for Haiku.
* doc/install.texi (Particular Systems): Add a recommendation
which prefix to use on Haiku.

Signed-off-by: Eric Blake <ebb9@byu.net>
2008-12-22 22:08:59 -07:00
Bruno Haible
5917ea5541 Warn about /usr/ucb on Solaris.
* doc/install.texi (Particular Systems): Recommend putting
/usr/ucb late in PATH, if at all.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2008-10-06 21:48:28 +02:00
Eric Blake
02fa53b195 Improve INSTALL formatting.
* doc/install.texi [!autoconf]: Ensure first paragraphs are
indented like all others in a plain text rendering.
* Makefile.am ($(srcdir)/INSTALL): Ensure plaintext formatting.
Reported by Bruno Haible.

Signed-off-by: Eric Blake <ebb9@byu.net>
2008-08-26 15:29:17 -06:00
Eric Blake
f4df9b9b40 Update invocation documentation.
* doc/autoconf.texi (autoscan Invocation): Mention --debug.
(autoreconf Invocation): Mention -v.
(autom4te Invocation): Tie --freeze to -F, not -f.
(autoupdate Invocation): Mention --prepend-include.
* doc/install.texi (configure Invocation): Mention --help=short,
--help=recursive, -n/--no-create, --prefix.  Avoid TABs.
* bin/autoscan.in ($help): Omit space before `...'.
* bin/ifnames.in ($help): Likewise.
* bin/autoconf.as (Usage): Likewise.
* bin/autoreconf.in ($help): Likewise.
* bin/autoheader.in ($help): Likewise.
* bin/autom4te.in ($help): Likewise.
* bin/autoupdate.in ($help): Likewise.
* lib/autoconf/status.m4 (_AC_OUTPUT_CONFIG_STATUS): Use
`[OPTION]...', rather than `[OPTIONS]'.  Mention --silent.  Indent
--file correctly.

Signed-off-by: Eric Blake <ebb9@byu.net>
2008-08-26 09:28:15 -06:00
Bruno Haible
60974b5558 Add section to INSTALL about particular systems.
* doc/install.texi (Particular systems): New node.
* doc/autoconf.texi: Adjust menus.

Signed-off-by: Eric Blake <ebb9@byu.net>
2008-08-20 07:26:30 -06:00
Bruno Haible
0b0c80f560 Mention universal binaries in INSTALL.
* doc/install.texi (Compiling For Multiple Architectures): Explain
how to create universal binaries on MacOS X.

Signed-off-by: Eric Blake <ebb9@byu.net>
2008-08-19 22:17:24 -06:00
Ralf Wildenhues
fefcc77fea Fix copyright years.
* Makefile.am, doc/install.texi, lib/autoconf/fortran.m4,
lib/autoconf/lang.m4, lib/freeze.mk: Likewise.
2007-12-04 22:30:33 +01:00
Ralf Wildenhues
037693bc20 Document `uninstall' in INSTALL.
* doc/install.texi (Basic Installation): Document `uninstall'.
* INSTALL: Regenerate.
Suggestion by Roberto Bagnara.
2007-10-09 21:24:39 +02:00
Paul Eggert
5051b263e0 * doc/install.texi (Compilers and Options): Weaken the
suggestion to use GNU make for VPATH builds.
2006-06-14 03:41:56 +00:00
Paul Eggert
f0c7c42553 * NEWS: GNU make now recommended for VPATH builds.
Mention that some macros are now documented to be obsolescent.
* doc/autoconf.texi:
Prefer "current" to "modern" to describe
currently-used (albeit perhaps old-fashioned) hosts.
Mention which ancient features no longer need to be worried about.
setgid -> set-group-ID
setuid -> set-user-ID (these are the Posix terms)
Fix some misuses of "only".
(AC_C_BACKSLASH_A, AC_C_CONST, AC_C_PROTOTYPES):
(AC_C_STRINGIZE, AC_C_VOLATILE, AC_FUNC_CLOSEDIR_VOID):
(AC_FUNC_GETPGRP, AC_FUNC_LSTAT, AC_FUNC_MEMCMP):
(AC_FUNC_SELECT_ARGTYPES, AC_FUNC_SETPGRP):
(AC_FUNC_SETVBUF_REVERSED, AC_FUNC_STAT, AC_FUNC_STRFTIME):
(AC_FUNC_STRNLEN, AC_FUNC_UTIME_NULL, AC_FUNC_VPRINTF):
(AC_HEADER_DIRENT, AC_HEADER_STAT, AC_HEADER_STDC):
(AC_HEADER_SYS_WAIT, AC_HEADER_TIME, AC_ISC_POSIX):
(AC_PROG_GCC_TRADITIONAL, AC_STRUCT_TM):
Mention that these macros are obsolescent.
(Installation Directory Variables): shall -> should
(File Descriptors): Mention that 0, 1, 2 might get reopened.
Mention that it's now safe to use 3 and 4.
(Limitations of Usual Tools): cp -r is now specified by Posix.
Omit longwinded and obsolescent discussion of cp -f.
Modernize discussion of expr, ls.
(Limitations of Make): Modernize discussion of VPATH builds.
Mention $? as a workaround in some cases.
* doc/install.texi (Basic Installation):
Mention "./configure; make; make install" first.  Be more
specific about why this file is generic.  Remove unnecessary
parens.  Remove misleading "only".  Remove obsolete advice
about csh.  Don't say "configure" takes awhile; say it
might take a while.  Suggest CFLAGS=-g rather than CFLAGS=-O2,
and CC=c99 rather than CC=c89, as these are blessed by current
Posix.  Recommend GNU make if doing a VPATH build.
2006-06-04 07:38:28 +00:00
Paul Eggert
25ca4c3c70 * doc/install.texi (Defining Variables): Tighten up the
CONFIG_SHELL wording.
2006-02-13 07:59:10 +00:00
Stepan Kasal
32629b44f8 Call the CONFIG_SHELL hint a workaround. 2006-02-04 14:10:46 +00:00
Ralf Wildenhues
0b9bb6512e * doc/install.texi (Defining Variables): Put `CONFIG_SHELL'
in environment of `configure', not the command line.
Reported by Howard Chu <hyc@highlandsun.com>.
2006-01-31 12:03:32 +00:00
Paul Eggert
2fa1c5c37e * README: Recommend GNU M4 1.4.3 or later.
* doc/autoconf.texi (Introduction): Likewise.
Reword to avoid some formatting glitches.
Use "#!/bin/sh", not "#! /bin/sh"; the space isn't needed these days.
Clarify explanation of HP compiler bug.
Redo example output tp match current CVS snapshot.
Use @example.org in email addresses when the examples
might get inadvertently cut-and-pasted into user code.
Remove example of autom4te usage that doesn't seem to work now.
Use modern AC_INIT (except when the example is meant to be
shown with Autoconf 2.13).
Update ksh info for Solaris 9 and later.
KB -> kB.
Modernize description of Automake versions a bit.
Don't claim a future version of Autoconf is near.
Add [] to examples, so that the manual
follows its own advice about quoting better.
* doc/install.texi: Reword to avoid some formatting glitches.
2005-06-08 07:13:50 +00:00
Paul Eggert
3a397dcbfe (Defining Variables): Warn about CONFIG_SHELL problems. 2005-02-01 00:32:44 +00:00
Paul Eggert
6b1c07685a Use "file name" rather than "filename" or "path",
to be consistent with the terminology of the GNU coding standards.
2004-08-20 19:58:06 +00:00
Paul Eggert
e3306391ef Include copyright symbol in copyright notice. 2002-07-29 08:20:52 +00:00
Akim Demaille
e00977c735 * doc/install.texi: Better wording for setting variables when
running configure.
From Christian Cornelssen.
2002-04-29 13:33:22 +00:00
Akim Demaille
cfe347de96 * doc/autoconf.texi (Transforming Names): Equality between target
and host is irrelevant.
(Specifying Names, Canonicalizing): Remove all references to the
backward compatibility hooks.  Rather, collect them all into...
(Hosts and Cross-Compilation): this new section.
* doc/install.texi (System Type): Ditto.
* lib/autoconf/general.m4 (AC_CANONICAL_HOST): Explicitly state
that `--host' implies cross-compilation.
2002-03-04 15:06:44 +00:00
Akim Demaille
cdb311dd14 * doc/install.texi, doc/autoconf.texi: Use `autoconf', not
`autoconf_manual', as texinfo.tex 2001-06-21.10 chokes on it.
2001-08-17 14:54:14 +00:00
Paul Eggert
7582d2a4f4 Put INSTALL copyright notice at start, not at end. 2001-08-17 00:42:44 +00:00
Akim Demaille
ab19ca36ae * doc/autoconf.texi (pr): New index.
(prindex, findex): Use, merge, and output them.
(Environment Variable Index, Output Variable Index)
(Preprocessor Symbol Index, Autoconf Macro Index, M4 Macro Index)
(Autotest Macro Index): Rename as...
(Environment Variables, Output Variables,Preprocessor Symbols)
(Autoconf Macros, M4 Macros, Autotest Macros): these.
* doc/install.texi: Use @command.
(Environment Variables): Rename as...
(Defining Variables): this.
2001-08-15 12:34:16 +00:00
Alexandre Duret-Lutz
c3de1bb1e5 * doc/autoconf.texi, doc/install.texi: Add a copyright notice
to the INSTALL file.
2001-08-12 13:17:35 +00:00
Akim Demaille
5058e82d54 * acgeneral.m4: Last changes for `configure.ac'.
(_AC_INIT_HELP, _AC_OUTPUT_SUBDIRS): Take `configure.ac' into
account.
* autoreconf.sh: Likewise.
2001-01-12 09:19:59 +00:00
Pavel Roskin
b33c492dd7 * doc/install.texi: Minor changes to eliminate TeX warnings.
* doc/autoconf.texi: Likewise. Typo fixes.
2000-11-28 16:53:56 +00:00
Akim Demaille
dc6d1f912a * acgeneral.m4 (AC_CACHE_LOAD): Be ready to read the cache even
when `.' is not in the PATH.
* doc/install.texi (configure Invocation): Adjust.
2000-07-04 10:34:21 +00:00
Akim Demaille
2e1fabcd1b * acgeneral.m4 (_AC_INIT_PARSE_ARGS) <-C>: Use `./config.cache', not
`config.cache'.
* doc/install.texi (configure Invocation): Adjust.
2000-07-03 10:41:30 +00:00
Akim Demaille
cb2e761b8e Re-enable the old behavior of --host and --build.
* acgeneral.m4 (build_alias): Set to host_alias if --build is not
given but --host is, and enable cross-compile auto-detection.  If
both are, and are different, enable cross compilation.
(AC_CANONICAL_HOST): Adjust help message.
(cross_compiling): Enclose in quotes when testing.
* aclang.m4 (_AC_LANG_COMPILER_WORKS): If cross_compiling is
maybe, set it to yes or no depending on the result of the
execution test.
* doc/autoconf.texi: Document the change.
* doc/install.texi: Likewise.
2000-06-30 13:34:37 +00:00
Akim Demaille
9eb70531a8 * doc/autoconf.texi: Use @option' for options, not @samp' nor
`@code'.
* doc/install.texi: Likewise.
2000-06-09 11:37:15 +00:00
Akim Demaille
0e26510db8 Fix the archive: some parts of the following patches were missing:
- CC < aCC
- unquote the argument of case
- AC_FUNC_STRERROR_R
- AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK
- typos in autoconf.texi
2000-05-26 17:12:01 +00:00
Akim Demaille
be64229cfa Add configure --config-cache', -C' as a shortcut for
`--cache-file=config.cache'.

* acgeneral.m4 (_AC_INIT_PARSE_ARGS): Let `configure' support
`--config-cache' and `-C'.
Report them in `--help'.
Fix the display of missing argument.
(_AC_OUTPUT_SUBDIRS): Adjust.
* doc/install.texi (Invoking configure): Rename the node as
(Running configure scripts): this, the name of the chapter.
(Operation Controls): Rename as...
(Invoking configure): this.
Document the new options.
* doc/autoconf.texi (direntry): Huh?  What is this `aclocal' doing
here?  Point to `Invoking configure'.
(Cache Files): No need to document the disabling of the cache.
2000-05-22 13:31:00 +00:00
Akim Demaille
907e198f7f Either we cross-compile the whole package, or we don't.
Using --host enables cross-compilation.

* acgeneral.m4 (_AC_INIT_PARSE_ARGS): `--host' enables cross
compilation.
(AC_CANONICAL_BUILD): The help string should explicitly mention
cross compilation.
* aclang.m4 (AC_LANG(C), AC_LANG(C++), AC_LANG(Fortran 77)): Don't
set `cross_compiling'.
(AC_PROG_CC, AC_PROG_CXX, AC_PROG_F77): Run your `WORK' partner
only if not cross-compiling.
(AC_PROG_CC_WORKS, AC_PROG_CXX_WORKS, AC_PROG_F77_WORKS):
If does not work, don't assume an implicit cross-compilation:
fail.
* doc/autoconf.texi: Adjust.
2000-05-19 12:40:45 +00:00
Akim Demaille
0d167edfd6 Update and polish the documentation.
* doc/autoconf.texi: Use @sc where upper case names were used.
Remove a few useless `dnl'.
Convert some `dnl' into comments.
Promote `$(foo)' in Makefiles, not `${foo}'.
Promote `$foo' in shell scripts, not `${foo}'.
Promote `foo = bar' in Makefiles, not `foo=bar'.
(Language Choice): Document `AC_LANG', move `AC_LANG_C',
`AC_LANG_CPLUSPLUS' and `AC_LANG_FORTRAN77' to
(Old Macros): here.
* doc/install.texi: Fix a typo in the specification of the system
quadruples.
2000-05-10 16:52:35 +00:00
Akim Demaille
b2c5b8a278 Provide a macro to canonicalize a configuration name.
Suggested by Ralf Corsepius.

*  acgeneral.m4 (AC_CANONICALIZE): New macro.
(_AC_CANONICAL_THING): Use it.
2000-05-03 09:53:55 +00:00
Akim Demaille
5ae14bc8c0 Disable caching by default, so as not to cause problems when
newbies accidentally use a stale cache file.

* acgeneral.m4 (_AC_INIT_PARSE_ARGS): Set cache_file to /dev/null
to disable caching by default.
(_AC_INIT_HELP): Adjust the --help message.
(AC_CACHE_LOAD, AC_CACHE_SAVE): Don't print "loading/updating
/dev/null" messages.
* autoconf.texi: Note that caching is disabled, how to enable it,
and that `./config.cache' is the traditional name of the cache file.
* install.texi: Likewise.
2000-04-05 07:42:06 +00:00
Akim Demaille
ab07ba8e08 The whole family supports -V = --version.
* acgeneral.m4 (AC_INIT_PARSE_ARGS): Report and support -V.
* autoconf.sh: Likewise.
* autoreconf.sh: Likewise.
* autoupdate.sh: Likewise.
* autoheader.sh: Likewise.
* autoscan.pl: Likewise.
* ifnames.sh: Likewise.
In addition, don't dump --help on invalid options.
* doc/autoconf.texi: Adjusted.
* doc/install.texi: Likewise.
2000-03-02 18:17:26 +00:00
Akim Demaille
c60a188814 Resynchronize INSTALL' with the current configure', and
conversely...

* acgeneral.m4 (AC_INIT_PARSE_ARGS): Let `configure' support `-h =
--help' and `-n = --no-create'.
Document -h, -n and -q in configure's help message.
* install.texi (Operation Controls): Formatting changes.
Document `configure -h'.
2000-02-09 18:19:58 +00:00
Ben Elliston
c4245421c8 * merged from the experimental branch.
1999-10-26  Ben Elliston  <bje@cygnus.com>

	* INSTALL: Regenerate.

1999-09-22  Akim Demaille  <akim@epita.fr>

	* install.texi: Give more details on envvar handling.
1999-10-26 03:54:59 +00:00
Ben Elliston
751c85fe2a 1999-09-24 Ben Elliston <bje@cygnus.com>
* install.texi: Replace `can not' with `cannot'.
1999-09-24 04:24:32 +00:00
David MacKenzie
e579d06b61 many bug fixes and a few additions, mostly derived from bug-gnu-utils 1996-11-09 22:19:24 +00:00
David MacKenzie
75ac961424 add --bindir, --libdir, etc. 1995-06-27 19:09:03 +00:00
David MacKenzie
77caa43c94 various bug fixes 1995-02-07 22:41:14 +00:00
David MacKenzie
f5cee52491 various bug fixes 1995-02-06 23:31:34 +00:00
David MacKenzie
b7b6179f38 config.site moved 1994-10-19 00:30:09 +00:00