Bug 985114
Summary: | Provide man pages for the nss configuration files | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Product: | [Fedora] Fedora | Reporter: | Elio Maldonado Batiz <emaldona> | ||||||||||
Component: | nss | Assignee: | Elio Maldonado Batiz <emaldona> | ||||||||||
Status: | CLOSED ERRATA | QA Contact: | Fedora Extras Quality Assurance <extras-qa> | ||||||||||
Severity: | low | Docs Contact: | |||||||||||
Priority: | unspecified | ||||||||||||
Version: | rawhide | CC: | amarecek, dlackey, emaldona, kdudka, kengert | ||||||||||
Target Milestone: | --- | ||||||||||||
Target Release: | --- | ||||||||||||
Hardware: | All | ||||||||||||
OS: | Linux | ||||||||||||
Whiteboard: | |||||||||||||
Fixed In Version: | nss-3.15.1-3.fc19 | Doc Type: | Bug Fix | ||||||||||
Doc Text: | Story Points: | --- | |||||||||||
Clone Of: | Environment: | ||||||||||||
Last Closed: | 2013-08-09 17:11:14 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: | |||||||||||||
Attachments: |
|
Description
Elio Maldonado Batiz
2013-07-16 20:15:02 UTC
Created attachment 774539 [details]
man pages for cert{8|9}.db, key{3|4}.db, secmod.db and pkcs11.txt
This is a first cut. it includes the changes to the spec file a-d also for two other man related bugs. I'll split it into speparate parts if it turns out be hard to read. Let's see.
Created attachment 774548 [details] man pages for cert{8|9}.db, key{3|4}.db, secmod.db and pkcs11.txt This bug file also has the fixes for certutil, cmsutil, crlutil that are for bug 984106 and the upstream bug. I can split it into parts for easier review. Comment on attachment 774539 [details]
man pages for cert{8|9}.db, key{3|4}.db, secmod.db and pkcs11.txt
Duplicate attachment.
Created attachment 774550 [details]
changes to nss.spc in patch format
Created attachment 775000 [details]
Ugly docbook for pkcs11.txt - for discussion
This is what a real manpage for pkcs11.txt would look like and I this one if far from complete. You can see the remaining descriptins as a big block of comments. It has a lot of nesting of refsections inside valistenries within variable lists. Perhaps I could have chosen simpler entities for the enumartions and the list. My XML and Docbbok knowledege is merely fair, certainly not good enough. That's why, for reasons of expediency, I have opted for a simple one that just contains the url to the gory details upstream at least for now.
Deon, do you know of a better way to tackle this?
-Elio
Comment on attachment 774550 [details]
changes to nss.spc in patch format
Cancelling the review request on the nss.spec changes because it's best to deal with this bug after we have taken care of the other two:
1) rhbz#982856 - nss-sysinit man page has wrong path for script ...
This is a trivial fix.
2) rhbz#984106 - Fixes for the {cert|cms|crl}util man pages ...
This one Kai reviewed it upstream and I'll apply that revised patch.
nss-3.15.1-3.fc19 has been submitted as an update for Fedora 19. https://admin.fedoraproject.org/updates/nss-3.15.1-3.fc19 Package nss-3.15.1-3.fc19: * should fix your issue, * was pushed to the Fedora 19 testing repository, * should be available at your local mirror within two days. Update it with: # su -c 'yum update --enablerepo=updates-testing nss-3.15.1-3.fc19' as soon as you are able to. Please go to the following url: https://admin.fedoraproject.org/updates/FEDORA-2013-14189/nss-3.15.1-3.fc19 then log in and leave karma (feedback). nss-3.15.1-3.fc19 has been pushed to the Fedora 19 stable repository. If problems still persist, please make note of it in this bug report. |