Note: This is a public test instance of Red Hat Bugzilla. The data contained within is a snapshot of the live data so any changes you make will not be reflected in the production Bugzilla. Email is disabled so feel free to test any aspect of the site that you want. File any problems you find or give feedback at bugzilla.redhat.com.
Bug 1513594
Summary: | man pages in unexpected package | ||
---|---|---|---|
Product: | [Fedora] Fedora | Reporter: | Carl George <carl> |
Component: | redis | Assignee: | Nathan Scott <nathans> |
Status: | CLOSED ERRATA | QA Contact: | Fedora Extras Quality Assurance <extras-qa> |
Severity: | unspecified | Docs Contact: | |
Priority: | unspecified | ||
Version: | rawhide | CC: | fabian.deutsch, fpercoco, jal233, nathans |
Target Milestone: | --- | Keywords: | Reopened |
Target Release: | --- | ||
Hardware: | Unspecified | ||
OS: | Unspecified | ||
Whiteboard: | |||
Fixed In Version: | redis-4.0.5-1.fc26 redis-4.0.4-1.fc27 | Doc Type: | If docs needed, set a value |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2017-12-09 22:27:21 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: |
Description
Carl George
2017-11-15 16:24:11 UTC
Hi Carl, As of redis-4.x we've begun incorporating significant amount of additional documentation from the upstream Redis developers. This aims to improve the user experience overall. All of the documentation is available in redis-doc, as you found. In this regard, we're following the guidelines outlined here: https://fedoraproject.org/wiki/Packaging:Guidelines#Documentation " ... if there's a lot of documentation, consider putting it into a subpackage. In this case, it is recommended to use *-doc as the subpackage name." This technique is commonly used in other packages, such as git-core-doc. It has the advantage of keeping the size of the core redis package smaller too, which is appreciated by people building Redis containers. $ rpm -qi redis | grep Size Size : 1571517 $ rpm -qi redis-doc | grep Size Size : 2856236 cheers. I have read those guidelines and understand the purpose of the -doc subpackage. However, those guidelines make no mention of man pages. Personally, my expectation is that if a command is available, I should have the respective man page available. I'm fine with larger documentation being in an optional -doc subpackage, but not man pages. Anecdotally, everyone I've asked about this feels the same way, so at the very least I'm not the only one who feels this way. Likewise, I disagree with how git is doing it, but most people won't notice it there because the top level git package pulls in git-core and git-core-doc as dependencies. I appreciate the intent of making the package smaller, but I believe the point is moot because when size is a concern (containers), `tsflags=nodocs` will be set. This means that the 8.9KB of man pages wouldn't be installed anyways regardless of which package they are in. Please reconsider moving the man pages back to the main package. Re-opening, as another request for this has arrived and the man pages are not immense in the big scheme of things - reverting this change in the 4.0.4 update. Thanks Carl. redis-4.0.4-1.fc26 has been submitted as an update to Fedora 26. https://bodhi.fedoraproject.org/updates/FEDORA-2017-60109c0576 redis-4.0.4-1.fc25 has been submitted as an update to Fedora 25. https://bodhi.fedoraproject.org/updates/FEDORA-2017-9c179d4157 redis-4.0.4-1.fc25 has been pushed to the Fedora 25 testing repository. If problems still persist, please make note of it in this bug report. See https://fedoraproject.org/wiki/QA:Updates_Testing for instructions on how to install test updates. You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2017-9c179d4157 redis-4.0.4-1.fc26 has been pushed to the Fedora 26 testing repository. If problems still persist, please make note of it in this bug report. See https://fedoraproject.org/wiki/QA:Updates_Testing for instructions on how to install test updates. You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2017-60109c0576 redis-4.0.5-1.fc26 has been submitted as an update to Fedora 26. https://bodhi.fedoraproject.org/updates/FEDORA-2017-ff072b2156 redis-4.0.5-1.fc25 has been submitted as an update to Fedora 25. https://bodhi.fedoraproject.org/updates/FEDORA-2017-7ef68f3f89 redis-4.0.5-1.fc25 has been pushed to the Fedora 25 testing repository. If problems still persist, please make note of it in this bug report. See https://fedoraproject.org/wiki/QA:Updates_Testing for instructions on how to install test updates. You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2017-7ef68f3f89 redis-4.0.5-1.fc26 has been pushed to the Fedora 26 testing repository. If problems still persist, please make note of it in this bug report. See https://fedoraproject.org/wiki/QA:Updates_Testing for instructions on how to install test updates. You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2017-ff072b2156 redis-4.0.6-1.fc25 has been submitted as an update to Fedora 25. https://bodhi.fedoraproject.org/updates/FEDORA-2017-57468d2c9b redis-4.0.6-1.fc25 has been pushed to the Fedora 25 testing repository. If problems still persist, please make note of it in this bug report. See https://fedoraproject.org/wiki/QA:Updates_Testing for instructions on how to install test updates. You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2017-57468d2c9b redis-4.0.5-1.fc26 has been pushed to the Fedora 26 stable repository. If problems still persist, please make note of it in this bug report. redis-4.0.4-1.fc27 has been pushed to the Fedora 27 stable repository. If problems still persist, please make note of it in this bug report. |