doc/manual.txt: clarify pkg build phases, document XBPS_BUILDDIR.

This commit is contained in:
Juan RP 2014-02-13 17:23:33 +01:00
parent f5827d8b4b
commit db87820b07

View file

@ -119,12 +119,13 @@ function, which is the directory to be used to compile the `source package`.
*build*:: *build*::
This phase compiles/prepares the `source files` via `make` or any other compatible method. This phase compiles/prepares the `source files` via `make` or any other compatible method.
*install-destdir*:: *install*::
This phase installs the `package files` into a `fake destdir`, via `make install` or This phase installs the `package files` into a `fake destdir`, via `make install` or
any other compatible method. any other compatible method.
*build-pkg*:: *package*::
This phase builds the `binary packages` with files stored in the `package destdir`. This phase builds the `binary packages` with files stored in the `package destdir`
and registers them into the local repository.
`xbps-src` supports running just the specified phase, and if it ran `xbps-src` supports running just the specified phase, and if it ran
successfully, the phase will be skipped later (unless its work directory successfully, the phase will be skipped later (unless its work directory
@ -188,6 +189,11 @@ rather than additional binary package names.
Full path to the fake destdir used by the `pkg_install()` function in Full path to the fake destdir used by the `pkg_install()` function in
`subpackages`, set to `${XBPS_MASTERDIR}/destdir/${pkgname}-${version}`. `subpackages`, set to `${XBPS_MASTERDIR}/destdir/${pkgname}-${version}`.
*XBPS_BUILDDIR*::
Directory to store the `source code` of the source package being processed.
Usually this follows the `${pkgname}-${version}` naming. The `wrksrc`
variable has the full path to the package source code directory.
*XBPS_MACHINE*:: *XBPS_MACHINE*::
The machine architecture as returned by `uname -m`. The machine architecture as returned by `uname -m`.