Bug 904353
Summary: | Provide swift man page for the command line interface. | ||||||||
---|---|---|---|---|---|---|---|---|---|
Product: | Red Hat OpenStack | Reporter: | Stephen Gordon <sgordon> | ||||||
Component: | python-swiftclient | Assignee: | Pete Zaitcev <zaitcev> | ||||||
Status: | CLOSED ERRATA | QA Contact: | Martina Kollarova <mkollaro> | ||||||
Severity: | low | Docs Contact: | |||||||
Priority: | medium | ||||||||
Version: | 2.1 | CC: | afazekas, derekh, markmc, ncredi, zaitcev | ||||||
Target Milestone: | snapshot5 | Keywords: | Triaged | ||||||
Target Release: | 2.1 | ||||||||
Hardware: | Unspecified | ||||||||
OS: | Unspecified | ||||||||
Whiteboard: | |||||||||
Fixed In Version: | Doc Type: | Bug Fix | |||||||
Doc Text: | Story Points: | --- | |||||||
Clone Of: | 903322 | Environment: | |||||||
Last Closed: | 2013-04-04 17:59:34 UTC | Type: | Bug | ||||||
Regression: | --- | Mount Type: | --- | ||||||
Documentation: | --- | CRM: | |||||||
Verified Versions: | Category: | --- | |||||||
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |||||||
Cloudforms Team: | --- | Target Upstream Version: | |||||||
Embargoed: | |||||||||
Bug Depends On: | |||||||||
Bug Blocks: | 903322 | ||||||||
Attachments: |
|
Comment 1
Pete Zaitcev
2013-02-26 17:27:05 UTC
Created attachment 703049 [details]
Candidate 1 in openstack-swift
Patch to openstack-swift to drop swift.1
Comment on attachment 703049 [details] Candidate 1 in openstack-swift For reference, swiftclient change to add swift(1) is https://review.openstack.org/#/c/23003/ Spec change here looks good, I'd just suggest more user-friendly changelog e.g. - Move swift manpage to python-swiftclient http://fedoraproject.org/wiki/Packaging:Conflicts "Keep in mind that implicit conflicts are NEVER acceptable." - e.g. if a possiblity of conflict on a file level between openstack-swift and python-swiftclient exists, we must resolve it at file level even if it means adding "Conflicts". However, man pages conflict commonly and there's a special suggestion: Man Page Name Conflicts * Rename the man pages to slightly alter the suffix of the man page (e.g man1/check.1.gz and man1/check.1foo.gz) * Rename the man pages to include a prefix of the providing package (e.g. foo-check.1.gz and bar-check.1.gz) Created attachment 703624 [details]
Candidate 2 in python-swiftclient
This should be better - does not use the "Conflicts:" anymore, installs swift.1x. I verified this RPM to work as expected and man page available.
Modified in python-swiftclient-1.2.0-5. This is non-conflicting, but we also removed the man page from openstack-swift in 1.7.4-10. In hindsight, since the new man page is non-conflicting, we did not really need to remove it as well as add, but we didn't know how that would turn out, so... Well, no harm done. Stephen, enjoy the fix. 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. http://rhn.redhat.com/errata/RHBA-2013-0706.html |