From: Eric Blake Date: Wed, 21 Oct 2009 02:27:20 +0000 (-0600) Subject: doc: regenerate INSTALL X-Git-Tag: v0.1~5295 X-Git-Url: http://erislabs.net/gitweb/?a=commitdiff_plain;h=e94df9f0f603d84f87e4dc12d0e6eb24ad1c062a;p=gnulib.git doc: regenerate INSTALL * doc/INSTALL: Reflect recent autoconf update. * doc/INSTALL.ISO: Likewise. * doc/INSTALL.UTF-8: Likewise. Signed-off-by: Eric Blake --- diff --git a/ChangeLog b/ChangeLog index ef2a152a1..20dd1a148 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2009-10-20 Eric Blake + + doc: regenerate INSTALL + * doc/INSTALL: Reflect recent autoconf update. + * doc/INSTALL.ISO: Likewise. + * doc/INSTALL.UTF-8: Likewise. + 2009-10-20 Pádraig Brady acl: warn if ACL support is not detected diff --git a/doc/INSTALL b/doc/INSTALL index 35602c21d..7d1c323be 100644 --- a/doc/INSTALL +++ b/doc/INSTALL @@ -69,6 +69,10 @@ of `autoconf'. 5. Optionally, type `make installcheck' to repeat any self-tests, but this time using the binaries in their final installed location. + This target does not install anything. Running this target as a + regular user, particularly if the prior `make install' required + root privileges, verifies that the installation completed + correctly. 6. You can remove the program binaries and object files from the source code directory by typing `make clean'. To also remove the @@ -141,7 +145,7 @@ Installation Names `/usr/local/bin', include files under `/usr/local/include', etc. You can specify an installation prefix other than `/usr/local' by giving `configure' the option `--prefix=PREFIX', where PREFIX must be an -absolute path. +absolute file name. You can specify separate installation prefixes for architecture-specific files and architecture-independent files. If you @@ -155,7 +159,7 @@ kinds of files. Run `configure --help' for a list of the directories you can set and what kinds of files go in them. In general, the default for these options is expressed in terms of `${prefix}', so that specifying just `--prefix' will affect all of the other directory -specifications. +specifications that were not explicitly provided. The most portable way to affect installation locations is to pass the correct locations to `configure'; however, many packages provide one or @@ -165,28 +169,25 @@ having to reconfigure or recompile. The first method involves providing an override variable for each affected directory. For example, `make install -prefix=/path/to/alternate' will choose an alternate location, as well as -influencing all other directory configuration variables that were -expressed in terms of `${prefix}' (or, put another way, all directories -specified during `configure' but not in terms of the common prefix must -each be overridden at install time for the entire installation to be -relocated). The approach of makefile variable overrides for each -directory variable is required by the GNU Coding Standards, and ideally -causes no recompilation. However, some platforms have known -limitations with the semantics of shared libraries that end up -requiring recompilation when using this method, particularly noticeable -in packages that use GNU Libtool. +prefix=/alternate/directory' will choose an alternate location for all +directory configuration variables that were expressed in terms of +`${prefix}'. Any directories that were specified during `configure', +but not in terms of `${prefix}', must each be overridden at install +time for the entire installation to be relocated. The approach of +makefile variable overrides for each directory variable is required by +the GNU Coding Standards, and ideally causes no recompilation. +However, some platforms have known limitations with the semantics of +shared libraries that end up requiring recompilation when using this +method, particularly noticeable in packages that use GNU Libtool. The second method involves providing the `DESTDIR' variable. For -example, `make install DESTDIR=/path/to/alternate' will prepend -`/path/to/alternate' before all installation paths. The approach of +example, `make install DESTDIR=/alternate/directory' will prepend +`/alternate/directory' before all installation names. The approach of `DESTDIR' overrides is not required by the GNU Coding Standards, and does not work on platforms that have drive letters. On the other hand, it does better at avoiding recompilation issues, and works well even when some directory options were not specified in terms of `${prefix}' -at `configure' time. For packages which support `DESTDIR', the -variable should remain undefined during `configure' and `make all', and -only be specified during `make install'. +at `configure' time. Optional Features ================= diff --git a/doc/INSTALL.ISO b/doc/INSTALL.ISO index f81fd5985..9db309c29 100644 --- a/doc/INSTALL.ISO +++ b/doc/INSTALL.ISO @@ -69,6 +69,10 @@ of 'autoconf'. 5. Optionally, type 'make installcheck' to repeat any self-tests, but this time using the binaries in their final installed location. + This target does not install anything. Running this target as a + regular user, particularly if the prior 'make install' required + root privileges, verifies that the installation completed + correctly. 6. You can remove the program binaries and object files from the source code directory by typing 'make clean'. To also remove the @@ -141,7 +145,7 @@ Installation Names '/usr/local/bin', include files under '/usr/local/include', etc. You can specify an installation prefix other than '/usr/local' by giving 'configure' the option '--prefix=PREFIX', where PREFIX must be an -absolute path. +absolute file name. You can specify separate installation prefixes for architecture-specific files and architecture-independent files. If you @@ -155,7 +159,7 @@ kinds of files. Run 'configure --help' for a list of the directories you can set and what kinds of files go in them. In general, the default for these options is expressed in terms of '${prefix}', so that specifying just '--prefix' will affect all of the other directory -specifications. +specifications that were not explicitly provided. The most portable way to affect installation locations is to pass the correct locations to 'configure'; however, many packages provide one or @@ -165,28 +169,25 @@ having to reconfigure or recompile. The first method involves providing an override variable for each affected directory. For example, `make install -prefix=/path/to/alternate' will choose an alternate location, as well as -influencing all other directory configuration variables that were -expressed in terms of '${prefix}' (or, put another way, all directories -specified during 'configure' but not in terms of the common prefix must -each be overridden at install time for the entire installation to be -relocated). The approach of makefile variable overrides for each -directory variable is required by the GNU Coding Standards, and ideally -causes no recompilation. However, some platforms have known -limitations with the semantics of shared libraries that end up -requiring recompilation when using this method, particularly noticeable -in packages that use GNU Libtool. +prefix=/alternate/directory' will choose an alternate location for all +directory configuration variables that were expressed in terms of +'${prefix}'. Any directories that were specified during 'configure', +but not in terms of '${prefix}', must each be overridden at install +time for the entire installation to be relocated. The approach of +makefile variable overrides for each directory variable is required by +the GNU Coding Standards, and ideally causes no recompilation. +However, some platforms have known limitations with the semantics of +shared libraries that end up requiring recompilation when using this +method, particularly noticeable in packages that use GNU Libtool. The second method involves providing the 'DESTDIR' variable. For -example, 'make install DESTDIR=/path/to/alternate' will prepend -'/path/to/alternate' before all installation paths. The approach of +example, 'make install DESTDIR=/alternate/directory' will prepend +'/alternate/directory' before all installation names. The approach of 'DESTDIR' overrides is not required by the GNU Coding Standards, and does not work on platforms that have drive letters. On the other hand, it does better at avoiding recompilation issues, and works well even when some directory options were not specified in terms of '${prefix}' -at 'configure' time. For packages which support 'DESTDIR', the -variable should remain undefined during 'configure' and 'make all', and -only be specified during 'make install'. +at 'configure' time. Optional Features ================= diff --git a/doc/INSTALL.UTF-8 b/doc/INSTALL.UTF-8 index 4f988caf5..5c394f1a9 100644 --- a/doc/INSTALL.UTF-8 +++ b/doc/INSTALL.UTF-8 @@ -69,6 +69,10 @@ of ‘autoconf’. 5. Optionally, type ‘make installcheck’ to repeat any self-tests, but this time using the binaries in their final installed location. + This target does not install anything. Running this target as a + regular user, particularly if the prior ‘make install’ required + root privileges, verifies that the installation completed + correctly. 6. You can remove the program binaries and object files from the source code directory by typing ‘make clean’. To also remove the @@ -141,7 +145,7 @@ Installation Names ‘/usr/local/bin’, include files under ‘/usr/local/include’, etc. You can specify an installation prefix other than ‘/usr/local’ by giving ‘configure’ the option ‘--prefix=PREFIX’, where PREFIX must be an -absolute path. +absolute file name. You can specify separate installation prefixes for architecture-specific files and architecture-independent files. If you @@ -155,7 +159,7 @@ kinds of files. Run ‘configure --help’ for a list of the directories you can set and what kinds of files go in them. In general, the default for these options is expressed in terms of ‘${prefix}’, so that specifying just ‘--prefix’ will affect all of the other directory -specifications. +specifications that were not explicitly provided. The most portable way to affect installation locations is to pass the correct locations to ‘configure’; however, many packages provide one or @@ -165,28 +169,25 @@ having to reconfigure or recompile. The first method involves providing an override variable for each affected directory. For example, `make install -prefix=/path/to/alternate' will choose an alternate location, as well as -influencing all other directory configuration variables that were -expressed in terms of ‘${prefix}’ (or, put another way, all directories -specified during ‘configure’ but not in terms of the common prefix must -each be overridden at install time for the entire installation to be -relocated). The approach of makefile variable overrides for each -directory variable is required by the GNU Coding Standards, and ideally -causes no recompilation. However, some platforms have known -limitations with the semantics of shared libraries that end up -requiring recompilation when using this method, particularly noticeable -in packages that use GNU Libtool. +prefix=/alternate/directory' will choose an alternate location for all +directory configuration variables that were expressed in terms of +‘${prefix}’. Any directories that were specified during ‘configure’, +but not in terms of ‘${prefix}’, must each be overridden at install +time for the entire installation to be relocated. The approach of +makefile variable overrides for each directory variable is required by +the GNU Coding Standards, and ideally causes no recompilation. +However, some platforms have known limitations with the semantics of +shared libraries that end up requiring recompilation when using this +method, particularly noticeable in packages that use GNU Libtool. The second method involves providing the ‘DESTDIR’ variable. For -example, ‘make install DESTDIR=/path/to/alternate’ will prepend -‘/path/to/alternate’ before all installation paths. The approach of +example, ‘make install DESTDIR=/alternate/directory’ will prepend +‘/alternate/directory’ before all installation names. The approach of ‘DESTDIR’ overrides is not required by the GNU Coding Standards, and does not work on platforms that have drive letters. On the other hand, it does better at avoiding recompilation issues, and works well even when some directory options were not specified in terms of ‘${prefix}’ -at ‘configure’ time. For packages which support ‘DESTDIR’, the -variable should remain undefined during ‘configure’ and ‘make all’, and -only be specified during ‘make install’. +at ‘configure’ time. Optional Features =================