commit:     6edb8eac940f0bdd538a59cc8f1070efba161b53
Author:     Kerin Millar <kfm <AT> plushkava <DOT> net>
AuthorDate: Mon Nov 10 17:04:09 2025 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Mon Nov 10 18:09:15 2025 +0000
URL:        https://gitweb.gentoo.org/proj/portage.git/commit/?id=6edb8eac

man: make.conf(5): mention that PORTAGE_COMPRESS="" inhibits compression

Some define PORTAGE_COMPRESS as "true" or ":" to inhibit compression but
the correct way to go about it is to define the compressor as the empty
string. Document the fact that it may be defined in this way.

Further, clarify that its value is treated as the name of a command.

See-also: 3498e0f1c1fe6c7f23707d0e56462fbc8dfb487d
Bug: https://bugs.gentoo.org/965903
Signed-off-by: Kerin Millar <kfm <AT> plushkava.net>
Signed-off-by: Sam James <sam <AT> gentoo.org>

 man/make.conf.5 | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/man/make.conf.5 b/man/make.conf.5
index e45113775b..2c8d83a9d1 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -1087,8 +1087,9 @@ PORTAGE_CHECKSUM_FILTER="\-* sha256"
 .fi
 .TP
 \fBPORTAGE_COMPRESS\fR = \fI"bzip2"\fR
-This variable contains the command used to compress documentation during the
-install phase.
+This variable contains the name of the command used to compress documentation
+during the install phase. If set as an empty string, the documentation shall
+not be compressed.
 .TP
 \fBPORTAGE_COMPRESS_EXCLUDE_SUFFIXES\fR = \fI"gif htm[l]? jp[e]?g pdf png"\fR
 This variable contains a space delimited list of file suffixes for which

Reply via email to