tar-manpage.patch

   1 --- /dev/null   Mon Dec 31 23:00:00 1979
   2 +++ tar-1.11.8/tar.1    Sun Jul 23 21:28:52 1995
   3 @@ -0,0 +1,335 @@
   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 --ignore-failed-read
  52 +]
  53 +[
  54 +.B -k, --keep-old-files
  55 +]
  56 +[
  57 +.B -K, --starting-file F
  58 +]
  59 +[
  60 +.B -l, --one-file-system
  61 +]
  62 +[
  63 +.B -L, --tape-length N
  64 +]
  65 +[
  66 +.B -m, --modification-time
  67 +]
  68 +[
  69 +.B -M, --multi-volume
  70 +]
  71 +[
  72 +.B -N, --after-date DATE, --newer DATE
  73 +]
  74 +[
  75 +.B -o, --old-archive, --portability
  76 +]
  77 +[
  78 +.B -O, --to-stdout
  79 +]
  80 +[
  81 +.B -p, --same-permissions, --preserve-permissions
  82 +]
  83 +[
  84 +.B -P, --absolute-paths
  85 +]
  86 +[
  87 +.B --preserve
  88 +]
  89 +[
  90 +.B -R, --record-number
  91 +]
  92 +[
  93 +.B --remove-files
  94 +]
  95 +[
  96 +.B -s, --same-order, --preserve-order
  97 +]
  98 +[
  99 +.B --same-owner
 100 +]
 101 +[
 102 +.B -S, --sparse
 103 +]
 104 +[
 105 +.B -T, --files-from F
 106 +]
 107 +[
 108 +.B --null
 109 +]
 110 +[
 111 +.B --totals
 112 +]
 113 +[
 114 +.B -v, --verbose
 115 +]
 116 +[
 117 +.B -V, --label NAME
 118 +]
 119 +[
 120 +.B --version
 121 +]
 122 +[
 123 +.B -w, --interactive, --confirmation
 124 +]
 125 +[
 126 +.B -W, --verify
 127 +]
 128 +[
 129 +.B --exclude FILE
 130 +]
 131 +[
 132 +.B -X, --exclude-from FILE
 133 +]
 134 +[
 135 +.B -Z, --compress, --uncompress
 136 +]
 137 +[
 138 +.B -z, --gzip, --ungzip
 139 +]
 140 +[
 141 +.B --use-compress-program PROG
 142 +]
 143 +[
 144 +.B --block-compress
 145 +]
 146 +[
 147 +.B -[0-7][lmh]
 148 +]
 149 +.TP
 150 +.I filename1 [ filename2, ... filenameN ]
 151 +.TP
 152 +.I directory1 [ directory2, ...directoryN ]
 153 +.SH DESCRIPTION
 154 +.LP
 155 +This manual page documents the GNU version of
 156 +.B tar
 157 +, an archiving program designed to store and extract files from
 158 +an archive file known as a
 159 +.IR tarfile.
 160 +A
 161 +.IR tarfile
 162 +may be made on a tape drive, however, it is also common
 163 +to write a
 164 +.IR tarfile
 165 +to a normal file.
 166 +The first argument to
 167 +.B tar
 168 +must be one of the options:
 169 +.BR Acdrtux ,
 170 +followed by any optional functions.
 171 +The final arguments to
 172 +.B tar
 173 +are the names of the files or directories which should be archived. The use
 174 +of a directory name always implies that the subdirectories below should be
 175 +included in the archive.
 176 +.SH "FUNCTION LETTERS"
 177 +.TP
 178 +.B One of the following options must be used:
 179 +.TP
 180 +.B -A, --catenate, --concatenate
 181 +append tar files to an archive
 182 +.TP
 183 +.B -c, --create
 184 +create a new archive
 185 +.TP
 186 +.B -d, --diff, --compare
 187 +find differences between archive and file system
 188 +.TP
 189 +.B --delete
 190 +delete from the archive (not for use on mag tapes!)
 191 +.TP
 192 +.B -r, --append
 193 +append files to the end of an archive
 194 +.TP
 195 +.B -t, --list
 196 +list the contents of an archive
 197 +.TP
 198 +.B -u, --update
 199 +only append files that are newer than copy in archive
 200 +.TP
 201 +.B -x, --extract, --get
 202 +extract files from an archive
 203 +.SH "OTHER OPTIONS"
 204 +.TP
 205 +.B --atime-preserve
 206 +don't change access times on dumped files
 207 +.TP
 208 +.B -b, --block-size N
 209 +block size of Nx512 bytes (default N=20)
 210 +.TP
 211 +.B -B, --read-full-blocks
 212 +reblock as we read (for reading 4.2BSD pipes)
 213 +.TP
 214 +.B -C, --directory DIR
 215 +change to directory DIR
 216 +.TP
 217 +.B --checkpoint
 218 +print directory names while reading the archive
 219 +.TP
 220 +.B -f, --file [HOSTNAME:]F
 221 +use archive file or device F (default /dev/rmt0)
 222 +.TP
 223 +.B --force-local
 224 +archive file is local even if has a colon
 225 +.TP
 226 +.B -F, --info-script F --new-volume-script F
 227 +run script at end of each tape (implies -M)
 228 +.TP
 229 +.B -G, --incremental
 230 +create/list/extract old GNU-format incremental backup
 231 +.TP
 232 +.B -g, --listed-incremental F
 233 +create/list/extract new GNU-format incremental backup
 234 +.TP
 235 +.B -h, --dereference
 236 +don't dump symlinks; dump the files they point to
 237 +.TP
 238 +.B -i, --ignore-zeros
 239 +ignore blocks of zeros in archive (normally mean EOF)
 240 +.TP
 241 +.B --ignore-failed-read
 242 +don't exit with non-zero status on unreadable files
 243 +.TP
 244 +.B -k, --keep-old-files
 245 +keep existing files; don't overwrite them from archive
 246 +.TP
 247 +.B -K, --starting-file F
 248 +begin at file F in the archive
 249 +.TP
 250 +.B -l, --one-file-system
 251 +stay in local file system when creating an archive
 252 +.TP
 253 +.B -L, --tape-length N
 254 +change tapes after writing N*1024 bytes
 255 +.TP
 256 +.B -m, --modification-time
 257 +don't extract file modified time
 258 +.TP
 259 +.B -M, --multi-volume
 260 +create/list/extract multi-volume archive
 261 +.TP
 262 +.B -N, --after-date DATE, --newer DATE
 263 +only store files newer than DATE
 264 +.TP
 265 +.B -o, --old-archive, --portability
 266 +write a V7 format archive, rather than ANSI format
 267 +.TP
 268 +.B -O, --to-stdout
 269 +extract files to standard output
 270 +.TP
 271 +.B -p, --same-permissions, --preserve-permissions
 272 +extract all protection information
 273 +.TP
 274 +.B -P, --absolute-paths
 275 +don't strip leading `/'s from file names
 276 +.TP
 277 +.B --preserve
 278 +like -p -s
 279 +.TP
 280 +.B -R, --record-number
 281 +show record number within archive with each message
 282 +.TP
 283 +.B --remove-files
 284 +remove files after adding them to the archive
 285 +.TP
 286 +.B -s, --same-order, --preserve-order
 287 +list of names to extract is sorted to match archive
 288 +.TP
 289 +.B --same-owner
 290 +create extracted files with the same ownership
 291 +.TP
 292 +.B -S, --sparse
 293 +handle sparse files efficiently
 294 +.TP
 295 +.B -T, --files-from F
 296 +get names to extract or create from file F
 297 +.TP
 298 +.B --null
 299 +-T reads null-terminated names, disable -C
 300 +.TP
 301 +.B --totals
 302 +print total bytes written with --create
 303 +.TP
 304 +.B -v, --verbose
 305 +verbosely list files processed
 306 +.TP
 307 +.B -V, --label NAME
 308 +create archive with volume name NAME
 309 +.TP
 310 +.B --version
 311 +print tar program version number
 312 +.TP
 313 +.B -w, --interactive, --confirmation
 314 +ask for confirmation for every action
 315 +.TP
 316 +.B -W, --verify
 317 +attempt to verify the archive after writing it
 318 +.TP
 319 +.B --exclude FILE
 320 +exclude file FILE
 321 +.TP
 322 +.B -X, --exclude-from FILE
 323 +exclude files listed in FILE
 324 +.TP
 325 +.B -Z, --compress, --uncompress
 326 +filter the archive through compress
 327 +.TP
 328 +.B -z, --gzip, --ungzip
 329 +filter the archive through gzip
 330 +.TP
 331 +.B --use-compress-program PROG
 332 +filter the archive through PROG (which must accept -d)
 333 +.TP
 334 +.B --block-compress
 335 +block the output of compression program for tapes
 336 +.TP
 337 +.B -[0-7][lmh]
 338 +specify drive and density