diff options
| author |   Michał Górny <mgorny@gentoo.org> | 2018-11-01 10:42:08 +0100 |
|---|---|---|
| committer | Michał Górny <mgorny@gentoo.org> | 2018-11-05 19:48:28 +0100 |
| commit | 3f50bfc1ae5bb211135d1c9286087ca39626ddf9 (patch) | |
| tree | b511341b2e10f68ca97d2907f1636b1486f3d8e5 /man/make.conf.5 | |
| parent | misc-functions.sh: Inline and reflow __prepall (diff) | |
| download | portage-3f50bfc1ae5bb211135d1c9286087ca39626ddf9.tar.gz portage-3f50bfc1ae5bb211135d1c9286087ca39626ddf9.tar.bz2 portage-3f50bfc1ae5bb211135d1c9286087ca39626ddf9.zip | |
Support disabling docompress for binary package builds
Add FEATURES=binpkg-docompress that can be used whether docompress
compression is performed before or after creating binary packages. With
the feature enabled (the default), the current behavior of storing
compressed files in binpkg is preserved. With it disabled, uncompressed
files are stored inside binary package and are compressed when
installing.
Storing uncompressed files in binary packages has two advantages:
1. Avoids the double-compression penalty, effectively improving binary
package compression speed and compression ratio.
2. Allows the same packages to be reused on systems with different
docompress configurations.
The option is roughly backwards compatible. Old Portage versions will
install packages created with FEATURES=-binpkg-docompress correctly,
albeit without compression. Portage with FEATURES=binpkg-docompress
should install old binpackages semi-correctly, potentially recompressing
them (and throwing already-compressed warnings on format mismatch).
The new behavior is left off by default to avoid those problems.
Signed-off-by: Michał Górny <mgorny@gentoo.org>
Reviewed-by: Zac Medico <zmedico@gentoo.org>
Diffstat (limited to 'man/make.conf.5')
| -rw-r--r-- | man/make.conf.5 | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5 index a33929143..ec03c93ca 100644 --- a/man/make.conf.5 +++ b/man/make.conf.5 @@ -275,6 +275,12 @@ existing digest, the digest will be regenerated regardless of whether or not \fIassume\-digests\fR is enabled. The \fBebuild\fR(1) \fBdigest\fR command has a \fB\-\-force\fR option that can be used to force regeneration of digests. .TP +.B binpkg\-docompress +Perform \fBdocompress\fR (controllable file compression) before creating binary +package. When this option is enabled (the default), documentation files are +already compressed inside binary packages. When it is disabled, binary packages +contain uncompressed documentation and Portage compresses it before installing. +.TP .B binpkg\-logs Keep logs from successful binary package merges. This is relevant only when \fBPORT_LOGDIR\fR is set. |