Where to submit man page corrections? [duplicate]
Solution 1:
FWIW, I checked the man page myself, and I cannot find the error you mention! Perhaps it has been corrected? I am using Ubuntu (MATE) 17.04, regularly updated with sudo apt update && sudo apt full-upgrade
. Have you tried updating your system?
Anyway, to answer your question in general terms:
man
page errors are bugs
As mentioned in the comments, mistakes in man
pages are bugs and should be reported to the package maintainers. See the Ubuntu help wiki on bug reporting and How do I report a bug?
How to figure out which package provides a man
page
Use whereis
to find the man
page file (as well as other main files), and dpkg -S
to find which package provides the file, for example
$ whereis ls
ls: /bin/ls /usr/share/man/man1/ls.1.gz
The last file mentioned is the man
page file - we can see that because it's in /usr/share/man
, so we can find the providing package like this:
$ dpkg -S /usr/share/man/man1/ls.1.gz
coreutils: /usr/share/man/man1/ls.1.gz
So the package would be coreutils
.
In your case:
$ whereis systemd-resolved
systemd-resolved: /usr/share/man/man8/systemd-resolved.8.gz
$ dpkg -S /usr/share/man/man8/systemd-resolved.8.gz
systemd: /usr/share/man/man8/systemd-resolved.8.gz
So in this case the package to report a bug against is systemd
How to report the problem
First, create a Launchpad account
Since the problem is just a typo in the manpage, there is probably not much point in including all the usual debugging information that is included when you use Apport. Instead you could enter
http://bugs.launchpad.net/ubuntu/+source/PACKAGENAME/+filebug?no-redirect
in the URL field of your browser, replacing PACKAGENAME with the name of the package.
You can then enter a short bug description, for example
typo in man page of `systemd-resolved`
You then get a form where you enter (as if there were still any doubt) which package you want to file a bug against, whether it is a security vulnerability (I'm pretty sure a typo in a man page won't be one...) and the details of the problem.
Don't forget to include which version of the package you are reporting against. You can check this with apt policy <packagename>
$ apt policy systemd
systemd:
Installed: 232-21ubuntu5
Try to describe the problem as clearly as possible, imagining that you have to fix it yourself with no pre-existing idea of what's wrong. For example, you could give the subheading of the section where the error appears, copy and paste the text of the section with the mistake, explain why it is wrong and what it should say instead.