Various fixes in the documentation

* doc/tar.1: Add missing dots, use plural when necessary,
tweak a wording.  Remove an incorrect observation, three times.
Add some missing articles, correct some formatting,
and expand the opaque descriptions of two options.
* doc/tar.texi: Drop a stray `cd` command from an example.
Correct two cross references, correct the paragraph
about the manpage, and unbreak a URL.
* src/names.c: Correct and shorten an error message: "non-optional"
means "mandatory", but "non-option" is what was meant.  And the
phrase "in archive create or update mode" was both unneeded and
incomplete.
* tests/positional01.at: Change expected error text.
* tests/positional02.at: Likewise.
* tests/positional03.at: Likewise.
This commit is contained in:
Benno Schulenberg
2023-07-10 10:39:48 +03:00
committed by Sergey Poznyakoff
parent cf16a23945
commit b3a71dbdb9
6 changed files with 57 additions and 60 deletions

View File

@@ -45,7 +45,7 @@ dir/A.a
dir/A.b
dir/B.a
],
[tar: The following options were used after any non-optional arguments in archive create or update mode. These options are positional and affect only arguments that follow them. Please, rearrange them properly.
[tar: The following options were used after non-option arguments. These options are positional and affect only arguments that follow them. Please, rearrange them properly.
tar: --exclude '*.b' has no effect
tar: Exiting with failure status due to previous errors
])

View File

@@ -40,7 +40,7 @@ tar -cf a.tar . -C dir
./B.a
],
[tar: ./a.tar: archive cannot contain itself; not dumped
tar: The following options were used after any non-optional arguments in archive create or update mode. These options are positional and affect only arguments that follow them. Please, rearrange them properly.
tar: The following options were used after non-option arguments. These options are positional and affect only arguments that follow them. Please, rearrange them properly.
tar: -C 'dir' has no effect
tar: Exiting with failure status due to previous errors
])

View File

@@ -37,7 +37,7 @@ tar -vcf ../a.tar --exclude '*.b' . -C dir --exclude '*.c' | sort
./dir/A.a
./dir/B.a
],
[tar: The following options were used after any non-optional arguments in archive create or update mode. These options are positional and affect only arguments that follow them. Please, rearrange them properly.
[tar: The following options were used after non-option arguments. These options are positional and affect only arguments that follow them. Please, rearrange them properly.
tar: -C 'dir' has no effect
tar: --exclude '*.c' has no effect
tar: Exiting with failure status due to previous errors