Dogcows Code - chaz/tar/blob - doc/value.texi

   1 @c This is part of GNU tar manual.
   2 @c Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001,
   3 @c 2003, 2004 Free Software Foundation, Inc.
   4 @c See file tar.texi for copying conditions.
   5
   6 @macro GNUTAR
   7 @acronym{GNU} @command{tar}
   8 @end macro
   9
  10 @set op-absolute-names @option{--absolute-names} (@option{-P})
  11 @set ref-absolute-names @ref{absolute}
  12 @set xref-absolute-names @xref{absolute}
  13 @set pxref-absolute-names @pxref{absolute}
  14
  15 @set op-after-date @option{--after-date=@var{date}} (@option{--newer=@var{date}}, @option{-N @var{date}})
  16 @set ref-after-date @ref{after}
  17 @set xref-after-date @xref{after}
  18 @set pxref-after-date @pxref{after}
  19
  20 @set op-append @option{--append} (@option{-r})
  21 @set ref-append @ref{add}
  22 @set xref-append @xref{add}
  23 @set pxref-append @pxref{add}
  24
  25 @set op-atime-preserve @option{--atime-preserve}
  26 @set ref-atime-preserve @ref{Attributes}
  27 @set xref-atime-preserve @xref{Attributes}
  28 @set pxref-atime-preserve @pxref{Attributes}
  29
  30 @set op-backup @option{--backup}
  31 @set ref-backup @ref{Backup options}
  32 @set xref-backup @xref{Backup options}
  33 @set pxref-backup @pxref{Backup options}
  34
  35 @set op-block-number @option{--block-number} (@option{-R})
  36 @set ref-block-number @ref{verbose}
  37 @set xref-block-number @xref{verbose}
  38 @set pxref-block-number @pxref{verbose}
  39
  40 @set op-blocking-factor @option{--blocking-factor=@var{512-size}} (@option{-b @var{512-size}})
  41 @set ref-blocking-factor @ref{Blocking Factor}
  42 @set xref-blocking-factor @xref{Blocking Factor}
  43 @set pxref-blocking-factor @pxref{Blocking Factor}
  44
  45 @set op-bzip2 @option{--bzip2} (@option{-j})
  46 @set ref-bzip2 @ref{gzip}
  47 @set xref-bzip2 @xref{gzip}
  48 @set pxref-bzip2 @pxref{gzip}
  49
  50 @set op-check-links @option{--check-links} (@option{-l})
  51 @set ref-check-links @ref{--check-links}
  52 @set xref-check-links @xref{--check-links}
  53 @set pxref-check-links @pxref{--check-links}
  54
  55 @set op-checkpoint @option{--checkpoint}
  56 @set ref-checkpoint @ref{verbose}
  57 @set xref-checkpoint @xref{verbose}
  58 @set pxref-checkpoint @pxref{verbose}
  59
  60 @set op-check-links @option{--check-links}
  61
  62 @set op-compare @option{--compare} (@option{--diff}, @option{-d})
  63 @set ref-compare @ref{compare}
  64 @set xref-compare @xref{compare}
  65 @set pxref-compare @pxref{compare}
  66
  67 @set op-compress @option{--compress} (@option{--uncompress}, @option{-Z})
  68 @set ref-compress @ref{gzip}
  69 @set xref-compress @xref{gzip}
  70 @set pxref-compress @pxref{gzip}
  71
  72 @set op-concatenate @option{--concatenate} (@option{--catenate}, @option{-A})
  73 @set ref-concatenate @ref{concatenate}
  74 @set xref-concatenate @xref{concatenate}
  75 @set pxref-concatenate @pxref{concatenate}
  76
  77 @set op-create @option{--create} (@option{-c})
  78 @set ref-create @ref{create}
  79 @set xref-create @xref{create}
  80 @set pxref-create @pxref{create}
  81
  82 @set op-delete @option{--delete}
  83 @set ref-delete @ref{delete}
  84 @set xref-delete @xref{delete}
  85 @set pxref-delete @pxref{delete}
  86
  87 @set op-dereference @option{--dereference} (@option{-h})
  88 @set ref-dereference @ref{dereference}
  89 @set xref-dereference @xref{dereference}
  90 @set pxref-dereference @pxref{dereference}
  91
  92 @set op-directory @option{--directory=@var{directory}} (@option{-C @var{directory}})
  93 @set ref-directory @ref{directory}
  94 @set xref-directory @xref{directory}
  95 @set pxref-directory @pxref{directory}
  96
  97 @set op-exclude @option{--exclude=@var{pattern}}
  98 @set ref-exclude @ref{exclude}
  99 @set xref-exclude @xref{exclude}
 100 @set pxref-exclude @pxref{exclude}
 101
 102 @set op-exclude-from @option{--exclude-from=@var{file-of-patterns}} (@option{-X @var{file-of-patterns}})
 103 @set ref-exclude-from @ref{exclude}
 104 @set xref-exclude-from @xref{exclude}
 105 @set pxref-exclude-from @pxref{exclude}
 106
 107 @set op-exclude-caches @option{--exclude-caches}
 108 @set ref-exclude-from @ref{exclude-caches}
 109 @set xref-exclude-from @xref{exclude-caches}
 110 @set pxref-exclude-from @pxref{exclude-caches}
 111
 112 @set op-extract @option{--extract} (@option{--get}, @option{-x})
 113 @set ref-extract @ref{extract}
 114 @set xref-extract @xref{extract}
 115 @set pxref-extract @pxref{extract}
 116
 117 @set op-file @option{--file=@var{archive-name}} (@option{-f @var{archive-name}})
 118 @set ref-file @ref{file}
 119 @set xref-file @xref{file}
 120 @set pxref-file @pxref{file}
 121
 122 @set op-files-from @option{--files-from=@var{file-of-names}} (@option{-T @var{file-of-names}})
 123 @set ref-files-from @ref{files}
 124 @set xref-files-from @xref{files}
 125 @set pxref-files-from @pxref{files}
 126
 127 @set op-force-local @option{--force-local}
 128 @set ref-force-local @ref{file}
 129 @set xref-force-local @xref{file}
 130 @set pxref-force-local @pxref{file}
 131
 132 @set op-group @option{--group=@var{group}}
 133 @set ref-group @ref{Option Summary}
 134 @set xref-group @xref{Option Summary}
 135 @set pxref-group @pxref{Option Summary}
 136
 137 @set op-gzip @option{--gzip} (@option{--gunzip}, @option{--ungzip}, @option{-z})
 138 @set ref-gzip @ref{gzip}
 139 @set xref-gzip @xref{gzip}
 140 @set pxref-gzip @pxref{gzip}
 141
 142 @set op-help @option{--help}
 143 @set ref-help @ref{help}
 144 @set xref-help @xref{help}
 145 @set pxref-help @pxref{help}
 146
 147 @set op-ignore-failed-read @option{--ignore-failed-read}
 148 @set ref-ignore-failed-read @ref{create options}
 149 @set xref-ignore-failed-read @xref{create options}
 150 @set pxref-ignore-failed-read @pxref{create options}
 151
 152 @set op-ignore-zeros @option{--ignore-zeros} (@option{-i})
 153 @set ref-ignore-zeros @ref{Reading}
 154 @set xref-ignore-zeros @xref{Reading}
 155 @set pxref-ignore-zeros @pxref{Reading}
 156
 157 @set op-incremental @option{--incremental} (@option{-G})
 158 @set ref-incremental @ref{Incremental Dumps}
 159 @set xref-incremental @xref{Incremental Dumps}
 160 @set pxref-incremental @pxref{Incremental Dumps}
 161
 162 @set op-info-script @option{--info-script=@var{script-name}} (@option{--new-volume-script=@var{script-name}}, @option{-F @var{script-name}})
 163 @set ref-info-script @ref{Multi-Volume Archives}
 164 @set xref-info-script @xref{Multi-Volume Archives}
 165 @set pxref-info-script @pxref{Multi-Volume Archives}
 166
 167 @set op-interactive @option{--interactive} (@option{-w})
 168 @set ref-interactive @ref{interactive}
 169 @set xref-interactive @xref{interactive}
 170 @set pxref-interactive @pxref{interactive}
 171
 172 @set op-keep-old-files @option{--keep-old-files} (@option{-k})
 173 @set ref-keep-old-files @ref{Keep Old Files}
 174 @set xref-keep-old-files @xref{Keep Old Files}
 175 @set pxref-keep-old-files @pxref{Keep Old Files}
 176
 177 @set op-keep-newer-files @option{--keep-old-files}
 178 @set ref-keep-newer-files @ref{Keep Newer Files}
 179 @set xref-keep-newer-files @xref{Keep Newer Files}
 180 @set pxref-keep-newer-files @pxref{Keep Newer Files}
 181
 182 @set op-label @option{--label=@var{archive-label}} (@option{-V @var{archive-label}})
 183 @set ref-label @ref{label}
 184 @set xref-label @xref{label}
 185 @set pxref-label @pxref{label}
 186
 187 @set op-list @option{--list} (@option{-t})
 188 @set ref-list @ref{list}
 189 @set xref-list @xref{list}
 190 @set pxref-list @pxref{list}
 191
 192 @set op-listed-incremental @option{--listed-incremental=@var{snapshot-file}} (@option{-g @var{snapshot-file}})
 193 @c No special refs for this option, use {*ref-incremental} instead.
 194
 195 @set op-mode @option{--mode=@var{permissions}}
 196 @set ref-mode @ref{Option Summary}
 197 @set xref-mode @xref{Option Summary}
 198 @set pxref-mode @pxref{Option Summary}
 199
 200 @set op-multi-volume @option{--multi-volume} (@option{-M})
 201 @set ref-multi-volume @ref{Multi-Volume Archives}
 202 @set xref-multi-volume @xref{Multi-Volume Archives}
 203 @set pxref-multi-volume @pxref{Multi-Volume Archives}
 204
 205 @set op-newer-mtime @option{--newer-mtime=@var{date}}
 206 @set ref-newer-mtime @ref{after}
 207 @set xref-newer-mtime @xref{after}
 208 @set pxref-newer-mtime @pxref{after}
 209
 210 @set op-no-recursion @option{--no-recursion}
 211 @set ref-no-recursion @ref{recurse}
 212 @set xref-no-recursion @xref{recurse}
 213 @set pxref-no-recursion @pxref{recurse}
 214
 215 @set op-no-same-owner @option{--no-same-owner} (@option{-o})
 216 @set ref-no-same-owner @ref{Attributes}
 217 @set xref-no-same-owner @xref{Attributes}
 218 @set pxref-no-same-owner @pxref{Attributes}
 219
 220 @set op-no-same-permissions @option{--no-same-permissions}
 221 @set ref-no-same-permissions @ref{Attributes}
 222 @set xref-no-same-permissions @xref{Attributes}
 223 @set pxref-no-same-permissions @pxref{Attributes}
 224
 225 @set op-null @option{--null}
 226 @set ref-null @ref{files}
 227 @set xref-null @xref{files}
 228 @set pxref-null @pxref{files}
 229
 230 @set op-numeric-owner @option{--numeric-owner}
 231 @set ref-numeric-owner @ref{Attributes}
 232 @set xref-numeric-owner @xref{Attributes}
 233 @set pxref-numeric-owner @pxref{Attributes}
 234
 235 @set op-occurrence @option{--occurrence}
 236 @set ref-occurrence @ref{--occurrence}
 237 @set xref-occurrence @xref{--occurrence}
 238 @set pxref-occurrence @pxref{--occurrence}
 239
 240 @set op-old-archive @option{--old-archive} (@option{-o})
 241 @set ref-old-archive @ref{old}
 242 @set xref-old-archive @xref{old}
 243 @set pxref-old-archive @pxref{old}
 244
 245 @set op-one-file-system @option{--one-file-system} (@option{-l})
 246 @set ref-one-file-system @ref{one}
 247 @set xref-one-file-system @xref{one}
 248 @set pxref-one-file-system @pxref{one}
 249
 250 @set op-overwrite @option{--overwrite}
 251 @set ref-overwrite @ref{Overwrite Old Files}
 252 @set xref-overwrite @xref{Overwrite Old Files}
 253 @set pxref-overwrite @pxref{Overwrite Old Files}
 254
 255 @set op-owner @option{--owner=@var{user}}
 256 @set ref-owner @ref{Option Summary}
 257 @set xref-owner @xref{Option Summary}
 258 @set pxref-owner @pxref{Option Summary}
 259
 260 @set op-format @option{--format} (@option{-H})
 261 @set ref-format @ref{format}
 262 @set xref-format @xref{format}
 263 @set pxref-format @pxref{format}
 264
 265 @set op-format-v7 @option{--format=v7}
 266 @set op-format-gnu @option{--format=gnu}
 267 @set op-format-oldgnu @option{--format=oldgnu}
 268 @set op-format-posix @option{--format=posix}
 269 @set op-format-ustar @option{--format=ustar}
 270
 271 @set op-posix @option{--posix}
 272 @set ref-posix @ref{posix}
 273 @set xref-posix @xref{posix}
 274 @set pxref-posix @pxref{posix}
 275
 276 @set op-preserve @option{--preserve}
 277 @set ref-preserve @ref{Attributes}
 278 @set xref-preserve @xref{Attributes}
 279 @set pxref-preserve @pxref{Attributes}
 280
 281 @set op-record-size @option{--record-size=@var{size}}
 282 @set ref-record-size @ref{Blocking}
 283 @set xref-record-size @xref{Blocking}
 284 @set pxref-record-size @pxref{Blocking}
 285
 286 @set op-recursive-unlink @option{--recursive-unlink}
 287 @set ref-recursive-unlink @ref{Writing}
 288 @set xref-recursive-unlink @xref{Writing}
 289 @set pxref-recursive-unlink @pxref{Writing}
 290
 291 @set op-read-full-records @option{--read-full-records} (@option{-B})
 292 @set ref-read-full-records @ref{Blocking}
 293 @set xref-read-full-records @xref{Blocking}
 294 @set pxref-read-full-records @pxref{Blocking}
 295 @c FIXME: or should it be Reading, or Blocking Factor
 296
 297 @set op-remove-files @option{--remove-files}
 298 @set ref-remove-files @ref{Writing}
 299 @set xref-remove-files @xref{Writing}
 300 @set pxref-remove-files @pxref{Writing}
 301
 302 @set op-rmt-command @option{rmt-command=@var{command}}
 303 @set op-rsh-command @option{rsh-command=@var{command}}
 304
 305 @set op-same-order @option{--same-order} (@option{--preserve-order}, @option{-s})
 306 @set ref-same-order @ref{Scarce}
 307 @set xref-same-order @xref{Scarce}
 308 @set pxref-same-order @pxref{Scarce}
 309 @c FIXME: or should it be Reading, or Attributes?
 310
 311 @set op-same-owner @option{--same-owner}
 312 @set ref-same-owner @ref{Attributes}
 313 @set xref-same-owner @xref{Attributes}
 314 @set pxref-same-owner @pxref{Attributes}
 315
 316 @set op-same-permissions @option{--same-permissions} (@option{--preserve-permissions}, @option{-p})
 317 @set ref-same-permissions @ref{Attributes}
 318 @set xref-same-permissions @xref{Attributes}
 319 @set pxref-same-permissions @pxref{Attributes}
 320 @c FIXME: or should it be Writing?
 321
 322 @set op-show-omitted-dirs @option{--show-omitted-dirs}
 323 @set ref-show-omitted-dirs @ref{verbose}
 324 @set xref-show-omitted-dirs @xref{verbose}
 325 @set pxref-show-omitted-dirs @pxref{verbose}
 326
 327 @set op-sparse @option{--sparse} (@option{-S})
 328 @set ref-sparse @ref{sparse}
 329 @set xref-sparse @xref{sparse}
 330 @set pxref-sparse @pxref{sparse}
 331
 332 @set op-starting-file @option{--starting-file=@var{name}} (@option{-K @var{name}})
 333 @set ref-starting-file @ref{Scarce}
 334 @set xref-starting-file @xref{Scarce}
 335 @set pxref-starting-file @pxref{Scarce}
 336
 337 @set op-strip-components @option{--strip-components}
 338 @set ref-strip-components @ref{--strip-components}
 339 @set xref-strip-components @xref{--strip-components}
 340 @set pxref-strip-components @pxref{--strip-components}
 341
 342 @set op-suffix @option{--suffix=@var{suffix}}
 343 @set ref-suffix @ref{Backup options}
 344 @set xref-suffix @xref{Backup options}
 345 @set pxref-suffix @pxref{Backup options}
 346
 347 @set op-tape-length @option{--tape-length=@var{1024-size}} (@option{-L @var{1024-size}})
 348 @set ref-tape-length @ref{Using Multiple Tapes}
 349 @set xref-tape-length @xref{Using Multiple Tapes}
 350 @set pxref-tape-length @pxref{Using Multiple Tapes}
 351
 352 @set op-to-stdout @option{--to-stdout} (@option{-O})
 353 @set ref-to-stdout @ref{Writing}
 354 @set xref-to-stdout @xref{Writing}
 355 @set pxref-to-stdout @pxref{Writing}
 356
 357 @set op-totals @option{--totals}
 358 @set ref-totals @ref{verbose}
 359 @set xref-totals @xref{verbose}
 360 @set pxref-totals @pxref{verbose}
 361
 362 @set op-touch @option{--touch} (@option{-m})
 363 @set ref-touch @ref{Writing}
 364 @set xref-touch @xref{Writing}
 365 @set pxref-touch @pxref{Writing}
 366
 367 @set op-unlink-first @option{--unlink-first} (@option{-U})
 368 @set ref-unlink-first @ref{Writing}
 369 @set xref-unlink-first @xref{Writing}
 370 @set pxref-unlink-first @pxref{Writing}
 371
 372 @set op-update @option{--update} (@option{-u})
 373 @set ref-update @ref{update}
 374 @set xref-update @xref{update}
 375 @set pxref-update @pxref{update}
 376
 377 @set op-use-compress-prog @option{--use-compress-prog=@var{program}}
 378 @set ref-use-compress-prog @ref{gzip}
 379 @set xref-use-compress-prog @xref{gzip}
 380 @set pxref-use-compress-prog @pxref{gzip}
 381
 382 @set op-verbose @option{--verbose} (@option{-v})
 383 @set ref-verbose @ref{verbose}
 384 @set xref-verbose @xref{verbose}
 385 @set pxref-verbose @pxref{verbose}
 386
 387 @set op-verify @option{--verify} (@option{-W})
 388 @set ref-verify @ref{verify}
 389 @set xref-verify @xref{verify}
 390 @set pxref-verify @pxref{verify}
 391
 392 @set op-version @option{--version}
 393 @set ref-version @ref{help}
 394 @set xref-version @xref{help}
 395 @set pxref-version @pxref{help}
 396
 397 @set op-volno-file @option{--volno-file=@var{file-of-number}}
 398 @set ref-volno-file @ref{Using Multiple Tapes}
 399 @set xref-volno-file @xref{Using Multiple Tapes}
 400 @set pxref-volno-file @pxref{Using Multiple Tapes}
 401
 402 @set op-seek @option{--seek}
 403 @set ref-seek @ref{seek}
 404 @set xref-seek @xref{seek}
 405 @set pxref-seek @pxref{seek}