Bug 988713

Summary: gzip "--rsyncable" option is not documented in man page
Product: Red Hat Enterprise Linux 6 Reporter: Eduardo Minguez <eminguez>
Component: man-pages-overridesAssignee: Jan Chaloupka <jchaloup>
Status: CLOSED ERRATA QA Contact: Iveta Wiedermann <isenfeld>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.6CC: eminguez, isenfeld, jchaloup, ovasik, pschiffe
Target Milestone: rcKeywords: ManPageChange, Patch
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Cause: --rsyncable options was not documented Consequence: incomplete documentation Fix: description of --rsyncable option added Result: updated documentation
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-10-14 03:26:14 EDT Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---
Bug Depends On:    
Bug Blocks: 1106360    
Description Flags
--rsyncable missing in gzip.1 man page
--rsyncable missing in gzip.1 man page none

Description Eduardo Minguez 2013-07-26 04:24:15 EDT
Description of problem:
gzip "--rsyncable" option is not documented in the man, but appears in the "-h" included help (and should be in the code itself)

Version-Release number of selected component (if applicable):
gzip-1.3.12-18.el6.x86_64 (but I think it's never included, so it maybe applies to gzip-*)

How reproducible:
Find "rsyncable" in man pages of gzip

Steps to Reproduce:
1. install gzip
2. man gzip
3. search for rsyncable

Actual results:
No "rsyncable" found

Expected results:
rsyncable flag explanation

Additional info:
Comment 2 RHEL Product and Program Management 2013-10-13 19:20:18 EDT
This request was evaluated by Red Hat Product Management for
inclusion in the current release of Red Hat Enterprise Linux.
Because the affected component is not scheduled to be updated
in the current release, Red Hat is unable to address this
request at this time.

Red Hat invites you to ask your support representative to
propose this request, if appropriate, in the next release of
Red Hat Enterprise Linux.
Comment 3 Jan Chaloupka 2014-06-05 03:56:20 EDT
After reading:




this could be the solution:

	Having a compressed file and synchronized between two computers using rsync, this option allows after changing a file not to sent an entire new archive but just a small portion of it. Normally, after a change in any file of an archive, compressing algorithm can generate completelly diffrent archive that differ from the old one. This causes rsync to transmit entirely new version to the remote computer. With this option, rsync is able to transmit just the changed portions (plus some minimal padding in the area of the archive that necessarily changed as a result of the changes in the file).

After grammar correction of course :)

What do you think, Petr, Eduardo? Is it sufficient explanation?
Comment 4 Eduardo Minguez 2014-06-05 04:03:02 EDT
It's pretty explanatory for me.
Comment 5 pstodulk 2014-06-05 04:22:56 EDT
Yes, this could be the solution.
Comment 6 Jan Chaloupka 2014-06-05 06:00:39 EDT
Comment 7 Jan Chaloupka 2014-06-06 03:30:46 EDT
Created attachment 902787 [details]
--rsyncable missing in gzip.1 man page

From upstream, --rsyncable is only RH/Fedora feature.
Comment 8 pstodulk 2014-06-06 04:13:07 EDT
Thank you Jan. I will apply your patch
Comment 11 Jan Chaloupka 2014-06-06 07:55:28 EDT
Created attachment 902891 [details]
--rsyncable missing in gzip.1 man page

Man page text checked and corrected by mariel@redhat.com. Thanks again.

Now it is applicable, Petr.
Comment 19 errata-xmlrpc 2014-10-14 03:26:14 EDT
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.