root
/
xz
mirror of https://git.tukaani.org/xz.git
1
0
Fork 0
Code Issues Releases Wiki Activity

xz man page: Describe the source file deletion in -z and -d options 

The DESCRIPTION section always explained it, and the OPTIONS section
only described the differences to the default behavior. However, new
users in a hurry may skip reading DESCRIPTION. The default behavior
is a bit dangerous, thus it's good to repeat in --compress and
--decompress docs that source file is removed after successful operation.

Fixes: https://github.com/tukaani-project/xz/issues/150
This commit is contained in:
Lasse Collin 2024-12-30 10:51:26 +02:00
parent bb79f79b27
commit 653732bd6f
No known key found for this signature in database
GPG Key ID: 38EE757D69184620
1 changed files with 16 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
src/xz/xz.1
View File

@ -4,7 +4,7 @@
.\" Authors: Lasse Collin .\" Authors: Lasse Collin
.\" Jia Tan .\" Jia Tan
.\" .\"
.TH XZ 1 "2024-04-08" "Tukaani" "XZ Utils" .TH XZ 1 "2024-12-30" "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
@ -351,9 +351,24 @@ the command name (for example,
.B unxz .B unxz
implies implies
.BR \-\-decompress ). .BR \-\-decompress ).
.IP ""
.\" The DESCRIPTION section already says this but it's good to repeat it
.\" here because the default behavior is a bit dangerous and new users
.\" in a hurry may skip reading the DESCRIPTION section.
After successful compression, the source file is removed
unless writing to standard output or
.B \-\-keep
was specified.
.TP .TP
.BR \-d ", " \-\-decompress ", " \-\-uncompress .BR \-d ", " \-\-decompress ", " \-\-uncompress
Decompress. Decompress.
.\" The DESCRIPTION section already says this but it's good to repeat it
.\" here because the default behavior is a bit dangerous and new users
.\" in a hurry may skip reading the DESCRIPTION section.
After successful decompression, the source file is removed
unless writing to standard output or
.B \-\-keep
was specified.
.TP .TP
.BR \-t ", " \-\-test .BR \-t ", " \-\-test
Test the integrity of compressed Test the integrity of compressed