Bug 1520066

Summary: Please fix manual page for ptsname
Product: [Fedora] Fedora Reporter: Jaroslav Škarvada <jskarvad>
Component: man-pagesAssignee: Nikola Forró <nforro>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 26CC: jchaloup, kasal, nforro, pschiffe
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: man-pages-4.09-4.fc26 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-12-12 13:43: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:

Description Jaroslav Škarvada 2017-12-02 13:42:30 UTC
Description of problem:
Manual page for ptsname says it requires '#define _XOPEN_SOURCE' but in fact it requires _XOPEN_SOURCE >= 500.

Version-Release number of selected component (if applicable):
man-pages-4.09-3.fc26.noarch

How reproducible:
Always

Steps to Reproduce:
1. Check manual page
2.
3.

Actual results:
There is written:
      #define _XOPEN_SOURCE       /* See feature_test_macros(7) */
      #include <stdlib.h>

      char *ptsname(int fd);

      #define _GNU_SOURCE         /* See feature_test_macros(7) */
      #include <stdlib.h>

      int ptsname_r(int fd, char *buf, size_t buflen);

Expected results:
In fact it requires:
#define _XOPEN_SOURCE 500

Additional info:
See bug 1520042 for reproducer and details. By consulting feature_test_macros manual page and its example of 'acct' manual page I think the current state is confusing at least.

Comment 1 Nikola Forró 2017-12-06 10:54:43 UTC
Already fixed upstream with this commit:
https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/?id=c2ba3716a92bb679b0ed70e56d52d17fd7b6fd54

Comment 3 Fedora Update System 2017-12-06 11:33:21 UTC
man-pages-4.09-4.fc26 has been submitted as an update to Fedora 26. https://bodhi.fedoraproject.org/updates/FEDORA-2017-566e710072

Comment 4 Fedora Update System 2017-12-09 07:27:22 UTC
man-pages-4.09-4.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-566e710072

Comment 5 Fedora Update System 2017-12-12 13:43:34 UTC
man-pages-4.09-4.fc26 has been pushed to the Fedora 26 stable repository. If problems still persist, please make note of it in this bug report.