In order to improve usability of packages in Fedora, project Man Page Scan was created and its task is to provide consistency of man pages (and documentation in general). The results are now available for package maintainers to fix documentation issues. If you need to re-run the check yourself, here is the simple process of man page check: 1. Download man-page-day from: https://pagure.io/ManualPageScan/blob/master/f/man-page-day.sh 2. Run the script: $ ./man-page-day.sh passwd
Created attachment 1473104 [details] Logs
This bug appears to have been reported against 'rawhide' during the Fedora 29 development cycle. Changing version to '29'.
This message is a reminder that Fedora 29 is nearing its end of life. Fedora will stop maintaining and issuing updates for Fedora 29 on 2019-11-26. It is Fedora's policy to close all bug reports from releases that are no longer maintained. At that time this bug will be closed as EOL if it remains open with a Fedora 'version' of '29'. Package Maintainer: If you wish for this bug to remain open because you plan to fix it in a currently maintained version, simply change the 'version' to a later Fedora version. Thank you for reporting this issue and we are sorry that we were not able to fix it before Fedora 29 is end of life. If you would still like to see this bug fixed and are able to reproduce it against a later version of Fedora, you are encouraged change the 'version' to a later Fedora version prior this bug is closed as described in the policy above. Although we aim to fix as many bugs as possible during every release's lifetime, sometimes those efforts are overtaken by events. Often a more recent Fedora release includes newer upstream software that fixes bugs or makes them obsolete.
Created attachment 1642069 [details] Log from comparison Added log from comparison of output of `passwd --help` against passwd.1 manual page.
> [ OK ] config file /etc/pam.d/passwd has man page /usr/share/man/man1/passwd.1.gz > [ Error ] man page is in unexpected section 1. Man pages for configuration files should be in section 5 This is imho a false positive. The content of /etc/pam.d/ is described in `man 5 pam.d`.
> 4 option(s) reported by the program ONLY: > --help > --keep-tokens > --usage > -? > 2 option(s) reported by the man page ONLY: > --keep > -E Fixed in upstream commits: - https://pagure.io/passwd/c/9f961b1dd0f3bd2bd365bc6b70597b2f89a67269 - https://pagure.io/passwd/c/05bd4d3269216eb922328af193db8e1b65afb6e1 `--help` option is so common so it is not included in SYNOPSIS section, but it should be mentioned in OPTIONS section of the manpage `-E` is probably a false positive, because it is mentioned in-text as part of another command only ("... Use `chage -E 0 user` command instead for ...") In addition, I found inconsistencies between field names outputted by `passwd -S` and those mentioned in manpage. The upstream commit that fixes this is https://pagure.io/passwd/c/213c1a6b8d92422d544cf9671eefe7b07209f081.
Fix in rawhide, f31 and f30. Commit: https://src.fedoraproject.org/rpms/passwd/c/1f800c50310f216b612f5e7e3fee852a74ff96ec
FEDORA-2019-1c4b3119a7 has been submitted as an update to Fedora 30. https://bodhi.fedoraproject.org/updates/FEDORA-2019-1c4b3119a7
FEDORA-2019-8d4b43000d has been submitted as an update to Fedora 31. https://bodhi.fedoraproject.org/updates/FEDORA-2019-8d4b43000d
passwd-0.80-7.fc31 has been pushed to the Fedora 31 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-2019-8d4b43000d
passwd-0.80-7.fc30 has been pushed to the Fedora 30 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-2019-1c4b3119a7
passwd-0.80-7.fc31 has been pushed to the Fedora 31 stable repository. If problems still persist, please make note of it in this bug report.
passwd-0.80-7.fc30 has been pushed to the Fedora 30 stable repository. If problems still persist, please make note of it in this bug report.