Где отправлять исправления на странице руководства? [dубликат]
В Ubuntu 17.04 я вижу, что man systemd-resolved имеет опечатку в разделе OPTIONS -i INTERFACE, относящемся к /etc/systemd/resolve.conf, а не /etc/systemd/resolved.conf, I.E. разница в d, и из-за того, что /etc/resolv.conf настолько близок, но отличается от человеческого надзора, чтобы опечатать страницу man.
Я считаю, что ссылка man на страницу Файл /etc/systemd/resolve.conf не существует. Кто исправляет страницы man?
2 ответа
FWIW, я сам проверил страницу man, и я не могу найти ошибку, которую вы упомянули! Возможно, это было исправлено? Я использую Ubuntu (MATE) 17.04, регулярно обновляемый с помощью sudo apt update && sudo apt full-upgrade.
В любом случае, чтобы ответить на ваш вопрос в общих чертах:
man ошибки страницы являются ошибками
Как упоминалось в комментариях, ошибки на страницах man являются ошибками и должны сообщаться сопровождающим пакета.
Как выяснить, какой пакет предоставляет страницу man
Используйте whereis, чтобы найти man (а также другие основные файлы), а также dpkg -S - справочной информации по Ubuntu для отчета об ошибках , например
$ 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
. Поскольку проблема - это просто опечатка в man-странице, вероятно, не так много смысла включать всю обычную информацию для отладки, которая включена, когда вы используете Apport. Вместо этого вы можете ввести
http://bugs.launchpad.net/ubuntu/+source/PACKAGENAME/+filebug?no-redirect
в поле URL вашего браузера, заменив PACKAGENAME на имя пакета.
Затем вы можете ввести краткое описание ошибки, например [ ! d21] typo in man page of `systemd-resolved`
Затем вы получаете форму, в которую вы входите (как будто все еще есть какие-либо сомнения), в какой пакет вы хотите указать ошибку, независимо от того, является ли это уязвимостью безопасности (я уверен, что опечатка на странице руководства не будет ...) и детали проблемы.
Не забудьте указать, какую версию пакета вы сообщаете. Вы можете проверить это с помощью apt policy <packagename>
$ apt policy systemd
systemd:
Installed: 232-21ubuntu5
Попытайтесь описать проблему настолько ясно, насколько это возможно, воображая, что вы должны ее исправить самостоятельно, при этом не имелось ранее существовавшего представления о том, что не так. Например, вы можете дать подзаголовок раздела, где появляется ошибка, скопировать и вставить текст раздела с ошибкой, объяснить, почему это неправильно, и что он должен сказать вместо этого.
FWIW, я сам проверил страницу man, и я не могу найти ошибку, которую вы упомянули! Возможно, это было исправлено? Я использую Ubuntu (MATE) 17.04, регулярно обновляемый с помощью sudo apt update && sudo apt full-upgrade.
В любом случае, чтобы ответить на ваш вопрос в общих чертах:
man ошибки страницы являются ошибками
Как упоминалось в комментариях, ошибки на страницах man являются ошибками и должны сообщаться сопровождающим пакета.
Как выяснить, какой пакет предоставляет страницу man
Используйте whereis, чтобы найти man (а также другие основные файлы), а также dpkg -S - справочной информации по Ubuntu для отчета об ошибках , например
$ 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
. Поскольку проблема - это просто опечатка в man-странице, вероятно, не так много смысла включать всю обычную информацию для отладки, которая включена, когда вы используете Apport. Вместо этого вы можете ввести
http://bugs.launchpad.net/ubuntu/+source/PACKAGENAME/+filebug?no-redirect
в поле URL вашего браузера, заменив PACKAGENAME на имя пакета.
Затем вы можете ввести краткое описание ошибки, например [ ! d21] typo in man page of `systemd-resolved`
Затем вы получаете форму, в которую вы входите (как будто все еще есть какие-либо сомнения), в какой пакет вы хотите указать ошибку, независимо от того, является ли это уязвимостью безопасности (я уверен, что опечатка на странице руководства не будет ...) и детали проблемы.
Не забудьте указать, какую версию пакета вы сообщаете. Вы можете проверить это с помощью apt policy <packagename>
$ apt policy systemd
systemd:
Installed: 232-21ubuntu5
Попытайтесь описать проблему настолько ясно, насколько это возможно, воображая, что вы должны ее исправить самостоятельно, при этом не имелось ранее существовавшего представления о том, что не так. Например, вы можете дать подзаголовок раздела, где появляется ошибка, скопировать и вставить текст раздела с ошибкой, объяснить, почему это неправильно, и что он должен сказать вместо этого.
-
1Для конкретного случая manpages, чтобы найти точную manpage, которую показывает человек, используйте -w: man -w ls, например: /usr/share/man/man1/ls.1.gz – muru 7 October 2017 в 14:46