Sergey Poznyakoff 21 years ago
parent
commit
35d44a05eb
1 changed files with 5 additions and 3 deletions
  1. 5 3
      NEWS

+ 5 - 3
NEWS

@@ -34,11 +34,13 @@ version 1.13.26
   with previous releases, however such usage is strongly deprecated as
   with previous releases, however such usage is strongly deprecated as
   the option will change to its UNIX98 semantics in the future releases.
   the option will change to its UNIX98 semantics in the future releases.
 
 
-* New option --first-copy can be used in conjunction with one of 
+* New option --occurrence[=N] can be used in conjunction with one of 
   the subcommands --delete, --diff, --extract or --list when a list of
   the subcommands --delete, --diff, --extract or --list when a list of
   files is given either on the command line or via -T option. This
   files is given either on the command line or via -T option. This
-  option instructs tar to terminate when all of the filenames from
-  the list were processed.
+  option instructs tar to process only the Nth occurence of each named
+  file. N defaults to 1, so `tar -x -f archive --occurence filename'
+  extracts the first occurence of `filename' from `archive'
+  and terminates without scanning to the end of the archive.
 
 
 * Removed obsolete command line options:
 * Removed obsolete command line options:
 ** --absolute-paths superseeded by --absolute-names
 ** --absolute-paths superseeded by --absolute-names