☰

在哪里提交手册页修正？

tag-icon • tag-icon manpage
在哪里提交手册页修正？

在 Ubuntu 17.04 中，我发现在指代而不是 的部分man systemd-resolved下有一个拼写错误，IE 差异是，并且由于非常接近但又不同，因此拼写错误并不超出人为疏忽的范围。OPTIONS -i INTERFACE/etc/systemd/resolve.conf/etc/systemd/resolved.confd/etc/resolv.confman

我发现man引用的页面/etc/systemd/resolve.conf文件不存在。谁来做man页面更正？

答案1

顺便说一句，我自己检查了手册页，但找不到您提到的错误！也许它已被更正？我正在使用 Ubuntu (MATE) 17.04，定期更新sudo apt update && sudo apt full-upgrade。您尝试过更新系统吗？

无论如何，一般性地回答你的问题：

man页面错误是 bug

正如评论中提到的，man页面中的错误是错误，应报告给软件包维护者。请参阅Ubuntu 帮助 wiki 上的错误报告和我如何报告错误？

如何确定哪个包提供了man页面

用于whereis查找man页面文件（以及其他主文件），dpkg -S并查找哪个包提供了该文件， 例如

$ whereis ls
ls: /bin/ls /usr/share/man/man1/ls.1.gz

最后提到的文件是man页面文件 - 我们可以看到它，因为它在/usr/share/man，所以我们可以像这样找到提供的包：

$ dpkg -S /usr/share/man/man1/ls.1.gz
coreutils: /usr/share/man/man1/ls.1.gz

因此包裹将是coreutils。

就你的情况而言：

$ 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

因此，在这种情况下，要报告错误的软件包是systemd

如何报告问题

第一的，创建 Launchpad 账户

由于问题只是手册页中的拼写错误，因此大概没有必要包含使用 Apport 时包含的所有常见调试信息。相反，你可以输入

http://bugs.launchpad.net/ubuntu/+source/PACKAGENAME/+filebug?no-redirect

在浏览器的 URL 字段中，将 PACKAGENAME 替换为包的名称。

然后您可以输入一个简短的错误描述，例如

typo in man page of `systemd-resolved`

然后，您会得到一个表单，您可以在其中输入（好像仍然有任何疑问）您要针对哪个软件包提交错误，它是否是一个安全漏洞（我很确定手册页中的拼写错误不会是其中之一......）以及问题的详细信息。

不要忘记包含您要报告的软件包的版本。您可以使用以下方法检查apt policy <packagename>

$ apt policy systemd
systemd:
  Installed: 232-21ubuntu5

尽量清晰地描述问题，想象您必须自己修复它，而事先不知道哪里出了问题。例如，您可以给出出现错误的部分的副标题，复制并粘贴出现错误的部分的文本，解释为什么是错误的以及应该说什么。

相关内容