update manpage #52241 ... when will GNU people learn that info sucks

1 files changed, 138 insertions, 25 deletions

diff --git a/app-arch/tar/files/tar.1 b/app-arch/tar/files/tar.1
index f7de1ec5be5e..a57a42def30b 100644
--- a/app-arch/tar/files/tar.1
+++ b/app-arch/tar/files/tar.1
@@ -4,116 +4,230 @@
 tar \- The GNU version of the tar archiving utility
 .SH SYNOPSIS
 .B tar
+.I [operation] [options]
+
+.I Operations:
+.nf
+.B [-]A --catenate --concatenate
+.B [-]c --create
+.B [-]d --diff --compare
+.B [-]r --append
+.B [-]t --list
+.B [-]u --update
+.B [-]x --extract --get
+.B --delete
+.fi
+
+.I Options:
+.br
 [
-.B \-
+.B --atime-preserve
 ]
-.B A --catenate --concatenate \||\| c --create \||\| d --diff --compare \||\| r --append \||\| t --list \||\| u --update \||\| x -extract --get
 [
-.B --atime-preserve
+.B --backup=BACKUP-TYPE
 ]
 [
-.B -b, --block-size N
+.B -b, --blocking-factor N
 ]
 [
-.B -B, --read-full-blocks
+.B -B, --read-full-records
 ]
 [
 .B -C, --directory DIR
 ]
 [
+.B --check-links
+]
+[
 .B --checkpoint	
 ]
 [
 .B -f, --file [HOSTNAME:]F
 ]
 [
+.B -F, --info-script F --new-volume-script F
+]
+[
 .B --force-local	
 ]
 [
-.B -F, --info-script F --new-volume-script F
+.B --format FORMAT
+]
+[
+.B -g, --listed-incremental F
 ]
 [
 .B -G, --incremental
 ]
 [
-.B -g, --listed-incremental F
+.B --group GROUP
 ]
 [
 .B -h, --dereference
 ]
 [
+.B --help
+]
+[
 .B -i, --ignore-zeros
 ]
 [
-.B -j, --bzip2
+.B --ignore-case
 ]
 [
 .B --ignore-failed-read
 ]
 [
+.B --index-file FILE
+]
+[
+.B -j, --bzip2
+]
+[
 .B -k, --keep-old-files
 ]
 [
 .B -K, --starting-file F
 ]
 [
+.B --keep-newer-files
+]
+[
 .B -l, --one-file-system
 ]
 [
 .B -L, --tape-length N
 ]
 [
-.B -m, --modification-time
+.B -m, --touch, --modification-time
 ]
 [
 .B -M, --multi-volume
 ]
 [
+.B --mode PERMISSIONS
+]
+[
 .B -N, --after-date DATE, --newer DATE
 ]
 [
-.B -o, --old-archive, --portability
+.B --newer-mtime DATE
+]
+[
+.B --no-anchored
+]
+[
+.B --no-ignore-case
+]
+[
+.B --no-recursion
+]
+[
+.B --no-same-permissions
+]
+[
+.B --no-wildcards
+]
+[
+.B --no-wildcards-match-slash
+]
+[
+.B --null	
+]
+[
+.B -o, --old-archive, --portability, --no-same-owner
 ]
 [
 .B -O, --to-stdout
 ]
 [
+.B --occurrence NUM
+]
+[
+.B --overwrite
+]
+[
+.B --overwrite-dir
+]
+[
+.B --owner USER
+]
+[
 .B -p, --same-permissions, --preserve-permissions
 ]
 [
 .B -P, --absolute-names
 ]
 [
+.B --pax-option KEYWORD-LIST
+]
+[
+.B --posix
+]
+[
 .B --preserve	
 ]
 [
-.B -R, --record-number
+.B -R, --block-number
+]
+[
+.B --record-size
+]
+[
+.B --recursion
+]
+[
+.B --recursive-unlink
 ]
 [
 .B --remove-files
 ]
 [
+.B --rmt-command CMD
+]
+[
+.B --rsh-command=CMD
+]
+[
 .B -s, --same-order, --preserve-order
 ]
 [
+.B -S, --sparse
+]
+[
 .B --same-owner
 ]
 [
 .B --numeric-owner
 ]
 [
-.B -S, --sparse
+.B --show-defaults
 ]
 [
-.B -T, --files-from F
+.B --show-omitted-dirs
 ]
 [
-.B --null	
+.B --strip-path NUMBER
+]
+[
+.B --suffix SUFFIX
+]
+[
+.B -T, --files-from F
 ]
 [
 .B --totals	
 ]
 [
+.B -U, --unlink-first
+]
+[
+.B --use-compress-program PROG
+]
+[
+.B --utc
+]
+[
 .B -v, --verbose
 ]
 [
@@ -123,39 +237,38 @@ tar \- The GNU version of the tar archiving utility
 .B --version	
 ]
 [
+.B --volno-file FILE
+]
+[
 .B -w, --interactive, --confirmation
 ]
 [
 .B -W, --verify	
 ]
 [
-.B --exclude=FILE
+.B --wildcards
 ]
 [
-.B -X, --exclude-from FILE
+.B --wildcards-match-slash
 ]
 [
-.B -Z, --compress, --uncompress
+.B --exclude PATTERN
 ]
 [
-.B -z, --gzip, --ungzip	
+.B -X, --exclude-from FILE
 ]
 [
-.B --use-compress-program PROG
+.B -Z, --compress, --uncompress
 ]
 [
-.B --block-compress
+.B -z, --gzip, --gunzip, --ungzip	
 ]
 [
-.B --rsh-command=CMD
+.B --block-compress
 ]
 [
 .B -[0-7][lmh]	
 ]
-.TP
-.I filename1 [ filename2, ... filenameN ] 
-.TP
-.I directory1 [ directory2, ...directoryN ]
 .SH DESCRIPTION
 .LP
 This manual page documents the GNU version of