doc: Suggest the use of out-of-source builds.

--

GnuPG-bug-id:  6313
This commit is contained in:
Werner Koch 2023-03-21 09:15:20 +01:00
parent 625aeb65b0
commit 658daae34a
No known key found for this signature in database
GPG Key ID: E3FDFF218E45B72B
2 changed files with 21 additions and 14 deletions

28
INSTALL
View File

@ -42,10 +42,12 @@ may remove or edit it.
you want to change it or regenerate `configure' using a newer version you want to change it or regenerate `configure' using a newer version
of `autoconf'. of `autoconf'.
The simplest way to compile this package is: The suggested way to compile this package is:
1. `cd' to the directory containing the package's source code and type 1. `cd' to the directory containing the package's source code and
`./configure' to configure the package for your system. create a new directory named `build'. Then `cd' to that
directory and type `../configure' to configure the package for
your system.
Running `configure' might take a while. While running, it prints Running `configure' might take a while. While running, it prints
some messages telling which features it is checking for. some messages telling which features it is checking for.
@ -58,14 +60,17 @@ The simplest way to compile this package is:
4. Type `make install' to install the programs and any data files and 4. Type `make install' to install the programs and any data files and
documentation. documentation.
5. You can remove the program binaries and object files from the 5. You can remove the program binaries and object files by deleting
source code directory by typing `make clean'. To also remove the all files from the `build' directory. In case you did not used a
files that `configure' created (so you can compile the package for dedicated build directory but build the software directly in the
a different kind of computer), type `make distclean'. There is source tree, you can remove the program binaries and object files
also a `make maintainer-clean' target, but that is intended mainly from the source code directory by typing `make clean'. To also
for the package's developers. If you use it, you may have to get remove the files that `configure' created (so you can compile the
all sorts of other programs in order to regenerate files that came package for a different kind of computer), type `make distclean'.
with the distribution. There is also a `make maintainer-clean' target, but that is
intended mainly for the package's developers. If you use it, you
may have to get all sorts of other programs in order to
regenerate files that came with the distribution.
Compilers and Options Compilers and Options
===================== =====================
@ -231,4 +236,3 @@ an Autoconf bug. Until the bug is fixed you can use this workaround:
`configure' also accepts some other, not widely useful, options. Run `configure' also accepts some other, not widely useful, options. Run
`configure --help' for more details. `configure --help' for more details.

7
README
View File

@ -53,7 +53,9 @@
As with all packages, you just have to do As with all packages, you just have to do
./configure mkdir build
cd build
../configure
make make
make check make check
make install make install
@ -81,7 +83,8 @@
To quickly build all required software without installing it, the To quickly build all required software without installing it, the
Speedo method may be used: Speedo method may be used:
make -f build-aux/speedo.mk native cd build
make -f ../build-aux/speedo.mk native
This method downloads all required libraries and does a native build This method downloads all required libraries and does a native build
of GnuPG to PLAY/inst/. GNU make is required and you need to set of GnuPG to PLAY/inst/. GNU make is required and you need to set