1
0
mirror of https://git.tukaani.org/xz.git synced 2025-03-25 18:00:45 +00:00

xz: Update the man page about the environment variables again

This commit is contained in:
Lasse Collin 2025-03-08 14:22:28 +02:00
parent 99c584891b
commit db9827dc38
No known key found for this signature in database
GPG Key ID: 38EE757D69184620

View File

@ -4,7 +4,7 @@
.\" Authors: Lasse Collin .\" Authors: Lasse Collin
.\" Jia Tan .\" Jia Tan
.\" .\"
.TH XZ 1 "2025-03-06" "Tukaani" "XZ Utils" .TH XZ 1 "2025-03-08" "Tukaani" "XZ Utils"
. .
.SH NAME .SH NAME
xz, unxz, xzcat, lzma, unlzma, lzcat \- Compress or decompress .xz and .lzma files xz, unxz, xzcat, lzma, unlzma, lzcat \- Compress or decompress .xz and .lzma files
@ -2603,21 +2603,21 @@ one is effectively modifying programs and scripts that run
.BR xz . .BR xz .
Most of the time it is safe to set memory usage limits, number of threads, Most of the time it is safe to set memory usage limits, number of threads,
and compression options via the environment variables. and compression options via the environment variables.
However, some options can break scripts subtly or completely. However, some options can break scripts.
An obvious example is An obvious example is
.B \-\-help .B \-\-help
which makes which makes
.B xz .B xz
show the help text instead of compressing or decompressing a file. show the help text instead of compressing or decompressing a file.
A more subtle example is More subtle examples are
.B \-\-verbose
which undoes the effect of
.B \-\-quiet .B \-\-quiet
and also affects the behavior of and
.BR \-\-list , .BR \-\-verbose .
thus In many cases it works well to enable the progress indicator using
.B \-\-verbose .BR \-\-verbose ,
isn't safe to use all the time. but in some situations the extra messages create problems.
The verbosity level also affects the behavior of
.BR \-\-list .
.TP .TP
.B XZ_DEFAULTS .B XZ_DEFAULTS
User-specific or system-wide default options. User-specific or system-wide default options.
@ -2625,7 +2625,7 @@ Typically this is set in a shell initialization script to enable
.BR xz 's .BR xz 's
memory usage limiter by default or set the default number of threads. memory usage limiter by default or set the default number of threads.
Excluding shell initialization scripts Excluding shell initialization scripts
and similar special cases, scripts must never set or unset and similar special cases, scripts should never set or unset
.BR XZ_DEFAULTS . .BR XZ_DEFAULTS .
.TP .TP
.B XZ_OPT .B XZ_OPT