Bug 416661 - Meaning of --occurrence wrong in man page
Summary: Meaning of --occurrence wrong in man page
Alias: None
Product: Fedora
Classification: Fedora
Component: tar
Version: 8
Hardware: All
OS: Linux
Target Milestone: ---
Assignee: Radek Brich
QA Contact: Fedora Extras Quality Assurance
Depends On:
Blocks: 429522
TreeView+ depends on / blocked
Reported: 2007-12-08 18:04 UTC by Jonathan Wakely
Modified: 2008-02-17 12:05 UTC (History)
0 users

Fixed In Version: 1.17-6.fc8
Doc Type: Bug Fix
Doc Text:
Clone Of:
Last Closed: 2008-02-17 12:05:25 UTC

Attachments (Terms of Use)
patch for tar.1 man page (693 bytes, patch)
2007-12-08 18:04 UTC, Jonathan Wakely
no flags Details | Diff

Description Jonathan Wakely 2007-12-08 18:04:00 UTC
Description of problem:
The man page shipped with RH/Fedora tar (which doesn't exist upstream) gives the
wrong semantics for --occurrence.  It claims --occurrence N will process the
first N occurrences, whereas it should be --occurrences=N and it only processes
the Nth, not 1-N.

Version-Release number of selected component (if applicable):
tar-1.17-4.fc8 and older versions

How reproducible:

Steps to Reproduce:
Compare what "man tar" says about --occurrence with "info tar" or try this:

mkdir tmp || exit 
cd tmp
touch bug

tar cvf bugs.tar bug bug bug
tar --delete -f bugs.tar --occurrence 2 bug
tar tvf bugs.tar

tar cvf bugs.tar bug bug bug
tar --delete -f bugs.tar --occurrence=2 bug
tar tvf bugs.tar

none of the --delete commands do what you would expect from the man page.

Patch attached.

Comment 1 Jonathan Wakely 2007-12-08 18:04:00 UTC
Created attachment 282061 [details]
patch for tar.1 man page

Comment 2 Radek Brich 2008-01-21 12:34:36 UTC
It will be fixed in F8 and Fdevel. I also cloned this bug for RHEL5.
Thanks for reporting.

Comment 3 Fedora Update System 2008-01-22 15:39:28 UTC
tar-1.17-6.fc8 has been pushed to the Fedora 8 testing repository.  If problems still persist, please make note of it in this bug report.
 If you want to test the update, you can install it with 
 su -c 'yum --enablerepo=updates-testing update tar'

Note You need to log in before you can comment on or make changes to this bug.