Bug 1610307 - Wrong crypt(3) manual page installed
Summary: Wrong crypt(3) manual page installed
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: man-pages
Version: 28
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Nikola Forró
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2018-07-31 11:58 UTC by Nadav Har'El
Modified: 2018-08-07 01:18 UTC (History)
5 users (show)

Fixed In Version: man-pages-4.15-3.fc28
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2018-08-07 01:18:19 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description Nadav Har'El 2018-07-31 11:58:22 UTC
Fedora 28 switched to libxcrypt. This package comes with its own manual page for the crypt(), crypt_r(), crypt_rn(), and crypt_ra() functions, but it is installed just as /usr/share/man/man3/crypt_rn.3.gz

The problem is that the manual page files for crypt.3, crypt_r.3 remain and come from the "man-pages" package. These manual pages give obsolete and incorrect information, for example crypt(3) suggests in "RETURN VALUE" that on error a NULL is returned, which is no longer try in libxcrypt, as the crypt_rn(3) manual page correctly explains.

I think crypt.3 and crypt_r.3 should be deleted from the man-pages package, and in the libxcrypt package we should have aliases for the existing crypt_rn.3 named crypt.3 and crypt_r.3.

Comment 1 Björn 'besser82' Esser 2018-08-02 20:27:22 UTC
Assigning to component 'man-pages' as they need to implement this first. 
 Afterwards I can add the symlinks in the libxcrypt package…

Comment 3 Nikola Forró 2018-08-03 15:26:33 UTC
Björn,

you should add the aliases as man pages sourcing the crypt_rn man page:

.so man3/crypt_rn.3

rather than symlinks.

Comment 4 Fedora Update System 2018-08-03 15:28:16 UTC
man-pages-4.15-3.fc28 has been submitted as an update to Fedora 28. https://bodhi.fedoraproject.org/updates/FEDORA-2018-236a0a8e67

Comment 5 Nikola Forró 2018-08-03 15:39:32 UTC
Also, I think crypt_ra.3 alias should be added as well.

Comment 6 Fedora Update System 2018-08-03 21:59:38 UTC
man-pages-4.15-3.fc28 has been pushed to the Fedora 28 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-2018-236a0a8e67

Comment 7 Björn 'besser82' Esser 2018-08-04 10:57:08 UTC
Thank you!  Will do so!

Comment 8 Fedora Update System 2018-08-04 11:34:16 UTC
libxcrypt-4.1.1-2.fc28 man-pages-4.15-3.fc28 has been submitted as an update to Fedora 28. https://bodhi.fedoraproject.org/updates/FEDORA-2018-236a0a8e67

Comment 9 Fedora Update System 2018-08-04 22:36:28 UTC
libxcrypt-4.1.1-2.fc28, man-pages-4.15-3.fc28 has been pushed to the Fedora 28 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-2018-236a0a8e67

Comment 10 Fedora Update System 2018-08-07 01:18:19 UTC
libxcrypt-4.1.1-2.fc28, man-pages-4.15-3.fc28 has been pushed to the Fedora 28 stable repository. If problems still persist, please make note of it in this bug report.


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