tar-man_from_debian_tar_1.13.25-2.patch

   1 --- tar-1.13.25.orig/debian/tar.1
   2 +++ tar-1.13.25/debian/tar.1
   3 @@ -0,0 +1,376 @@
   4 +.\" @(#)tar.1 1.11.1 93/19/22 PJV;
   5 +.TH TAR 1 "22 September 1993"
   6 +.SH NAME
   7 +tar \- The GNU version of the tar archiving utility
   8 +.SH SYNOPSIS
   9 +.B tar
  10 +[
  11 +.B \-
  12 +]
  13 +.B A --catenate --concatenate \||\| c --create \||\| d --diff --compare \||\| r --append \||\| t --list \||\| u --update \||\| x -extract --get
  14 +[
  15 +.B --atime-preserve
  16 +]
  17 +[
  18 +.B -b, --block-size N
  19 +]
  20 +[
  21 +.B -B, --read-full-blocks
  22 +]
  23 +[
  24 +.B -C, --directory DIR
  25 +]
  26 +[
  27 +.B --checkpoint
  28 +]
  29 +[
  30 +.B -f, --file [HOSTNAME:]F
  31 +]
  32 +[
  33 +.B --force-local
  34 +]
  35 +[
  36 +.B -F, --info-script F --new-volume-script F
  37 +]
  38 +[
  39 +.B -G, --incremental
  40 +]
  41 +[
  42 +.B -g, --listed-incremental F
  43 +]
  44 +[
  45 +.B -h, --dereference
  46 +]
  47 +[
  48 +.B -i, --ignore-zeros
  49 +]
  50 +[
  51 +.B -j, --bzip2
  52 +]
  53 +[
  54 +.B --ignore-failed-read
  55 +]
  56 +[
  57 +.B -k, --keep-old-files
  58 +]
  59 +[
  60 +.B -K, --starting-file F
  61 +]
  62 +[
  63 +.B -l, --one-file-system
  64 +]
  65 +[
  66 +.B -L, --tape-length N
  67 +]
  68 +[
  69 +.B -m, --modification-time
  70 +]
  71 +[
  72 +.B -M, --multi-volume
  73 +]
  74 +[
  75 +.B -N, --after-date DATE, --newer DATE
  76 +]
  77 +[
  78 +.B -o, --old-archive, --portability
  79 +]
  80 +[
  81 +.B -O, --to-stdout
  82 +]
  83 +[
  84 +.B -p, --same-permissions, --preserve-permissions
  85 +]
  86 +[
  87 +.B -P, --absolute-names
  88 +]
  89 +[
  90 +.B --preserve
  91 +]
  92 +[
  93 +.B -R, --record-number
  94 +]
  95 +[
  96 +.B --remove-files
  97 +]
  98 +[
  99 +.B -s, --same-order, --preserve-order
 100 +]
 101 +[
 102 +.B --same-owner
 103 +]
 104 +[
 105 +.B --numeric-owner
 106 +]
 107 +[
 108 +.B -S, --sparse
 109 +]
 110 +[
 111 +.B -T, --files-from F
 112 +]
 113 +[
 114 +.B --null
 115 +]
 116 +[
 117 +.B --totals
 118 +]
 119 +[
 120 +.B -v, --verbose
 121 +]
 122 +[
 123 +.B -V, --label NAME
 124 +]
 125 +[
 126 +.B --version
 127 +]
 128 +[
 129 +.B -w, --interactive, --confirmation
 130 +]
 131 +[
 132 +.B -W, --verify
 133 +]
 134 +[
 135 +.B --exclude=FILE
 136 +]
 137 +[
 138 +.B -X, --exclude-from FILE
 139 +]
 140 +[
 141 +.B -Z, --compress, --uncompress
 142 +]
 143 +[
 144 +.B -z, --gzip, --ungzip
 145 +]
 146 +[
 147 +.B --use-compress-program PROG
 148 +]
 149 +[
 150 +.B --block-compress
 151 +]
 152 +[
 153 +.B --rsh-command=CMD
 154 +]
 155 +[
 156 +.B -[0-7][lmh]
 157 +]
 158 +.TP
 159 +.I filename1 [ filename2, ... filenameN ]
 160 +.TP
 161 +.I directory1 [ directory2, ...directoryN ]
 162 +.SH DESCRIPTION
 163 +.LP
 164 +This manual page documents the GNU version of
 165 +.B tar
 166 +, an archiving program designed to store and extract files from
 167 +an archive file known as a
 168 +.IR tarfile.
 169 +A
 170 +.IR tarfile
 171 +may be made on a tape drive, however, it is also common
 172 +to write a
 173 +.IR tarfile
 174 +to a normal file.
 175 +The first argument to
 176 +.B tar
 177 +must be one of the options:
 178 +.BR Acdrtux ,
 179 +followed by any optional functions.
 180 +The final arguments to
 181 +.B tar
 182 +are the names of the files or directories which should be archived. The use
 183 +of a directory name always implies that the subdirectories below should be
 184 +included in the archive.
 185 +.SH EXAMPLES
 186 +.TP
 187 +.B tar -xvvf foo.tar
 188 +extract foo.tar
 189 +.TP
 190 +.B tar -xvvzf foo.tar.gz
 191 +extract gzipped foo.tar.gz
 192 +.TP
 193 +.B tar -cvvf foo.tar foo/
 194 +tar contents of folder foo in foo.tar
 195 +.SH "FUNCTION LETTERS"
 196 +.TP
 197 +.B One of the following options must be used:
 198 +.TP
 199 +.B -A, --catenate, --concatenate
 200 +append tar files to an archive
 201 +.TP
 202 +.B -c, --create
 203 +create a new archive
 204 +.TP
 205 +.B -d, --diff, --compare
 206 +find differences between archive and file system
 207 +.TP
 208 +.B --delete
 209 +delete from the archive (not for use on mag tapes!)
 210 +.TP
 211 +.B -r, --append
 212 +append files to the end of an archive
 213 +.TP
 214 +.B -t, --list
 215 +list the contents of an archive
 216 +.TP
 217 +.B -u, --update
 218 +only append files that are newer than copy in archive
 219 +.TP
 220 +.B -x, --extract, --get
 221 +extract files from an archive
 222 +.SH "OTHER OPTIONS"
 223 +.TP
 224 +.B --atime-preserve
 225 +don't change access times on dumped files
 226 +.TP
 227 +.B -b, --block-size N
 228 +block size of Nx512 bytes (default N=20)
 229 +.TP
 230 +.B -B, --read-full-blocks
 231 +reblock as we read (for reading 4.2BSD pipes)
 232 +.TP
 233 +.B -C, --directory DIR
 234 +change to directory DIR
 235 +.TP
 236 +.B --checkpoint
 237 +print directory names while reading the archive
 238 +.TP
 239 +.B -f, --file [HOSTNAME:]F
 240 +use archive file or device F (default "-", meaning stdin/stdout)
 241 +.TP
 242 +.B --force-local
 243 +archive file is local even if has a colon
 244 +.TP
 245 +.B -F, --info-script F --new-volume-script F
 246 +run script at end of each tape (implies -M)
 247 +.TP
 248 +.B -G, --incremental
 249 +create/list/extract old GNU-format incremental backup
 250 +.TP
 251 +.B -g, --listed-incremental F
 252 +create/list/extract new GNU-format incremental backup
 253 +.TP
 254 +.B -h, --dereference
 255 +don't dump symlinks; dump the files they point to
 256 +.TP
 257 +.B -i, --ignore-zeros
 258 +ignore blocks of zeros in archive (normally mean EOF)
 259 +.TP
 260 +.B -j, --bzip2
 261 +filter archive through bzip2, use to decompress .bz2 files
 262 +.TP
 263 +.B --ignore-failed-read
 264 +don't exit with non-zero status on unreadable files
 265 +.TP
 266 +.B -k, --keep-old-files
 267 +keep existing files; don't overwrite them from archive
 268 +.TP
 269 +.B -K, --starting-file F
 270 +begin at file F in the archive
 271 +.TP
 272 +.B -l, --one-file-system
 273 +stay in local file system when creating an archive
 274 +.TP
 275 +.B -L, --tape-length N
 276 +change tapes after writing N*1024 bytes
 277 +.TP
 278 +.B -m, --modification-time
 279 +don't extract file modified time
 280 +.TP
 281 +.B -M, --multi-volume
 282 +create/list/extract multi-volume archive
 283 +.TP
 284 +.B -N, --after-date DATE, --newer DATE
 285 +only store files newer than DATE
 286 +.TP
 287 +.B -o, --old-archive, --portability
 288 +write a V7 format archive, rather than ANSI format
 289 +.TP
 290 +.B -O, --to-stdout
 291 +extract files to standard output
 292 +.TP
 293 +.B -p, --same-permissions, --preserve-permissions
 294 +extract all protection information
 295 +.TP
 296 +.B -P, --absolute-paths
 297 +don't strip leading `/'s from file names
 298 +.TP
 299 +.B --preserve
 300 +like -p -s
 301 +.TP
 302 +.B -R, --record-number
 303 +show record number within archive with each message
 304 +.TP
 305 +.B --remove-files
 306 +remove files after adding them to the archive
 307 +.TP
 308 +.B -s, --same-order, --preserve-order
 309 +list of names to extract is sorted to match archive
 310 +.TP
 311 +.B --same-owner
 312 +create extracted files with the same ownership
 313 +.TP
 314 +.B --numeric-owner
 315 +always use numbers for user/group names
 316 +.TP
 317 +.B -S, --sparse
 318 +handle sparse files efficiently
 319 +.TP
 320 +.B -T, --files-from F
 321 +get names to extract or create from file F
 322 +.TP
 323 +.B --null
 324 +-T reads null-terminated names, disable -C
 325 +.TP
 326 +.B --totals
 327 +print total bytes written with --create
 328 +.TP
 329 +.B -v, --verbose
 330 +verbosely list files processed
 331 +.TP
 332 +.B -V, --label NAME
 333 +create archive with volume name NAME
 334 +.TP
 335 +.B --version
 336 +print tar program version number
 337 +.TP
 338 +.B -w, --interactive, --confirmation
 339 +ask for confirmation for every action
 340 +.TP
 341 +.B -W, --verify
 342 +attempt to verify the archive after writing it
 343 +.TP
 344 +.B --exclude=FILE
 345 +exclude file FILE
 346 +.TP
 347 +.B -X, --exclude-from FILE
 348 +exclude files listed in FILE
 349 +.TP
 350 +.B -Z, --compress, --uncompress
 351 +filter the archive through compress
 352 +.TP
 353 +.B -z, --gzip, --ungzip
 354 +filter the archive through gzip
 355 +.TP
 356 +.B --use-compress-program PROG
 357 +filter the archive through PROG (which must accept -d)
 358 +.TP
 359 +.B --block-compress
 360 +block the output of compression program for tapes
 361 +.TP
 362 +.B --rsh-command=CMD
 363 +Use remote COMMAND instead of `rsh'.  This option exists so that
 364 +people who use something other than the standard `rsh' (e.g., a
 365 +Kerberized `rsh') can access a remote device.
 366 +.TP
 367 +.B -[0-7][lmh]
 368 +specify drive and density
 369 +.SH BUGS
 370 +.LP
 371 +The GNU folks, in general, abhor man pages, and create info documents instead.
 372 +The maintainer of tar falls into this category.  This man page is neither
 373 +complete, nor current, and was included in the Debian Linux packaging of tar
 374 +entirely to reduce the frequency with which the lack of a man page gets
 375 +reported as a bug in our defect tracking system.
 376 +
 377 +If you really want to understand tar, then you should run info and read the
 378 +tar info pages, or use the info mode in emacs.
 379 +