tar-manpage.patch

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