/[tar]/tar/doc/tar.texi
ViewVC logotype

Diff of /tar/doc/tar.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.40 by gray, Sun Oct 19 19:17:39 2003 UTC revision 1.41 by gray, Tue Nov 11 15:02:27 2003 UTC
# Line 1050  The following issues need mentioning: Line 1050  The following issues need mentioning:
1050  @table @asis  @table @asis
1051  @item Use of short option @option{-o}.  @item Use of short option @option{-o}.
1052  Earlier versions of @GNUTAR{} understood @option{-o} command line  Earlier versions of @GNUTAR{} understood @option{-o} command line
1053  option as a synonim for @option{--old-archive}.  option as a synonym for @option{--old-archive}.
1054    
1055  @GNUTAR{} starting from version 1.13.90 understands this option as  @GNUTAR{} starting from version 1.13.90 understands this option as
1056  a synonim for @option{--no-same-owner}. This is compatible with  a synonym for @option{--no-same-owner}. This is compatible with
1057  UNIX98 @command{tar} implementations.  UNIX98 @command{tar} implementations.
1058    
1059  However, to facilitate transition, @option{-o} option retains its  However, to facilitate transition, @option{-o} option retains its
# Line 1061  old semantics when it is used with one o Line 1061  old semantics when it is used with one o
1061  Users are encouraged to use @value{op-format-oldgnu} instead.  Users are encouraged to use @value{op-format-oldgnu} instead.
1062    
1063  Future versions of @GNUTAR{} will understand @option{-o} only as a  Future versions of @GNUTAR{} will understand @option{-o} only as a
1064  synonim for @option{--no-same-owner}.  synonym for @option{--no-same-owner}.
1065    
1066  @item Use of short option @option{-l}  @item Use of short option @option{-l}
1067  Earlier versions of @GNUTAR{} understood @option{-l} option as a  Earlier versions of @GNUTAR{} understood @option{-l} option as a
1068  synonim for @samp{--one-file-system}. Such usage is deprecated.  synonym for @samp{--one-file-system}. Such usage is deprecated.
1069  For compatiblity with other implementations future versions of  For compatibility with other implementations future versions of
1070  @GNUTAR{} will understand this option as a synonim for  @GNUTAR{} will understand this option as a synonym for
1071  @option{--check-links}.  @option{--check-links}.
1072    
1073  @item Use of options @option{--portability} and @option{--old-archive}  @item Use of options @option{--portability} and @option{--old-archive}
# Line 1116  For version 1.12, Daniel Hagerty contrib Line 1116  For version 1.12, Daniel Hagerty contrib
1116  consulting.  In particular, he is the primary author of @ref{Backups}.  consulting.  In particular, he is the primary author of @ref{Backups}.
1117    
1118  In July, 2003 @GNUTAR{} was put on CVS at @url{savannah.gnu.org}, and  In July, 2003 @GNUTAR{} was put on CVS at @url{savannah.gnu.org}, and
1119  an active development and maintainance work has started  an active development and maintenance work has started
1120  again. Currently @GNUTAR{} is being maintained by Paul Eggert, Sergey  again. Currently @GNUTAR{} is being maintained by Paul Eggert, Sergey
1121  Poznyakoff and Jeff Bailey.  Poznyakoff and Jeff Bailey.
1122    
# Line 2299  optionally take an argument} Line 2299  optionally take an argument}
2299  @node Mnemonic Options  @node Mnemonic Options
2300  @subsection Mnemonic Option Style  @subsection Mnemonic Option Style
2301    
2302  @FIXME{have to decide whether or ot to replace other occurrences of  @FIXME{have to decide whether or not to replace other occurrences of
2303  "mnemonic" with "long", or *ugh* vice versa.}  "mnemonic" with "long", or *ugh* vice versa.}
2304    
2305  Each option has at least one long (or mnemonic) name starting with two  Each option has at least one long (or mnemonic) name starting with two
# Line 2945  and group IDs when creating a @command{t Line 2945  and group IDs when creating a @command{t
2945  @FIXME-xref{}  @FIXME-xref{}
2946    
2947  @item -o  @item -o
2948  When extracting files, this option is a synonim for  When extracting files, this option is a synonym for
2949  @option{--no-same-owner}, i.e. it prevents @command{tar} from  @option{--no-same-owner}, i.e. it prevents @command{tar} from
2950  restoring ownership of files being extracted.  restoring ownership of files being extracted.
2951    
2952  When creating an archive, @option{-o} is a synonim for  When creating an archive, @option{-o} is a synonym for
2953  @option{--old-archive}. This behavior is for compatibility  @option{--old-archive}. This behavior is for compatibility
2954  with previous versions of @GNUTAR{}, and will be  with previous versions of @GNUTAR{}, and will be
2955  removed in the future releases.  removed in the future releases.
# Line 2975  will extract the first occurrence of @fi Line 2975  will extract the first occurrence of @fi
2975  and will terminate without scanning to the end of the archive.  and will terminate without scanning to the end of the archive.
2976    
2977  @item --old-archive  @item --old-archive
2978  Synonim for @option{--format=v7}.  Synonym for @option{--format=v7}.
2979    
2980  @item --one-file-system  @item --one-file-system
2981  @itemx -l  @itemx -l
# Line 2984  directories that are on different file s Line 2984  directories that are on different file s
2984  directory.  directory.
2985    
2986  Earlier versions of @GNUTAR{} understood @option{-l} as a  Earlier versions of @GNUTAR{} understood @option{-l} as a
2987  synonim for @option{--one-file-system}. Although such usage is still  synonym for @option{--one-file-system}. Although such usage is still
2988  allowed in the present version, it is @emph{strongly discouraged}.  allowed in the present version, it is @emph{strongly discouraged}.
2989  The future versions of @GNUTAR{} will use @option{-l} as  The future versions of @GNUTAR{} will use @option{-l} as
2990  a synonim for @option{--check-links}.  a synonym for @option{--check-links}.
2991    
2992  @xref{Current status}, for more information.  @xref{Current status}, for more information.
2993    
# Line 3018  This option does not affect extraction f Line 3018  This option does not affect extraction f
3018    
3019  @item --portability  @item --portability
3020  @itemx --old-archive  @itemx --old-archive
3021  Synonim for @option{--format=v7}.  Synonym for @option{--format=v7}.
3022    
3023  @item --posix  @item --posix
3024  Same as @option{--format=posix}.  Same as @option{--format=posix}.
# Line 3645  common errors are: Line 3645  common errors are:
3645  @item  @item
3646  Mistakingly using @code{create} instead of @code{extract}, when the  Mistakingly using @code{create} instead of @code{extract}, when the
3647  intent was to extract the full contents of an archive.  This error  intent was to extract the full contents of an archive.  This error
3648  is likely: keys @kbd{c} and @kbd{x} are right next ot each other on  is likely: keys @kbd{c} and @kbd{x} are right next to each other on
3649  the QWERTY keyboard.  Instead of being unpacked, the archive then  the QWERTY keyboard.  Instead of being unpacked, the archive then
3650  gets wholly destroyed.  When users speak about @dfn{exploding} an  gets wholly destroyed.  When users speak about @dfn{exploding} an
3651  archive, they usually mean something else :-).  archive, they usually mean something else :-).
# Line 4774  files to store names of other files whic Line 4774  files to store names of other files whic
4774  arguments to @command{tar} (this can help you save time if you expect to  arguments to @command{tar} (this can help you save time if you expect to
4775  archive the same list of files a number of times), and so forth.  archive the same list of files a number of times), and so forth.
4776  @FIXME{in case it's not obvious, i'm making this up in some sense  @FIXME{in case it's not obvious, i'm making this up in some sense
4777  based on my imited memory of what the next chapter *really* does.  i  based on my limited memory of what the next chapter *really* does.  i
4778  just wanted to flesh out this final section a little bit so i'd  just wanted to flesh out this final section a little bit so i'd
4779  remember to sitck it in here. :-)}  remember to stick it in here. :-)}
4780    
4781  If there are too many files to conveniently list on the command line,  If there are too many files to conveniently list on the command line,
4782  you can list the names in a file, and @command{tar} will read that file.  you can list the names in a file, and @command{tar} will read that file.
# Line 6397  compatibility with previous versions of Line 6397  compatibility with previous versions of
6397  and is discouraged.  and is discouraged.
6398    
6399  Notice, that currently @acronym{GNU} extensions are not  Notice, that currently @acronym{GNU} extensions are not
6400  alowed with this format. Following is the list of options that  allowed with this format. Following is the list of options that
6401  cannot be used with @value{op-format-posix}:  cannot be used with @value{op-format-posix}:
6402    
6403  @itemize @bullet  @itemize @bullet
# Line 6700  the file for consecutive stretches of ze Line 6700  the file for consecutive stretches of ze
6700  archive for the file where the consecutive stretches of zeros are, and  archive for the file where the consecutive stretches of zeros are, and
6701  only archives the ``real contents'' of the file.  On extraction (using  only archives the ``real contents'' of the file.  On extraction (using
6702  @value{op-sparse} is not needed on extraction) any such files have  @value{op-sparse} is not needed on extraction) any such files have
6703  hols created wherever the continuous stretches of zeros were found.  holes created wherever the continuous stretches of zeros were found.
6704  Thus, if you use @value{op-sparse}, @command{tar} archives won't take  Thus, if you use @value{op-sparse}, @command{tar} archives won't take
6705  more space than the original.  more space than the original.
6706    
# Line 7822  updating the archive. Line 7822  updating the archive.
7822    
7823  Apparently, Exabyte drives have a physical block size of 8K bytes.  Apparently, Exabyte drives have a physical block size of 8K bytes.
7824  If we choose our blocksize as a multiple of 8k bytes, then the problem  If we choose our blocksize as a multiple of 8k bytes, then the problem
7825  seems to dissapper.  Id est, we are using block size of 112 right  seems to disappear.  Id est, we are using block size of 112 right
7826  now, and we haven't had the problem since we switched@dots{}  now, and we haven't had the problem since we switched@dots{}
7827    
7828  With @GNUTAR{} the blocking factor is limited only  With @GNUTAR{} the blocking factor is limited only

Legend:
Removed from v.1.40  
changed lines
  Added in v.1.41

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26