aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2018-11-01 10:42:08 +0100
committerMichał Górny <mgorny@gentoo.org>2018-11-05 19:48:28 +0100
commit3f50bfc1ae5bb211135d1c9286087ca39626ddf9 (patch)
treeb511341b2e10f68ca97d2907f1636b1486f3d8e5 /man
parentmisc-functions.sh: Inline and reflow __prepall (diff)
downloadportage-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')
-rw-r--r--man/ebuild.15
-rw-r--r--man/make.conf.56
2 files changed, 11 insertions, 0 deletions
diff --git a/man/ebuild.1 b/man/ebuild.1
index 1d48844da..5893c3df6 100644
--- a/man/ebuild.1
+++ b/man/ebuild.1
@@ -130,6 +130,11 @@ the \fIsrc_install()\fR function. When completed, the
will contain all the files that should either be merged to the local
filesystem or included in a binary package.
.TP
+.BR instprep
+Performs the additional post-install/pre-merge preparations inside
+the temporary \fIinstall directory\fR. This is intended to be called
+\fBafter\fR building binary package but before executing \fBpreinst\fR.
+.TP
.BR postinst
Runs package-specific actions that need to be done after the package
is installed into the live filesystem. Usually helpful messages are
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.