Bug 14776

Summary:	gensrclist и genpkglist lack documentation
Product:	Sisyphus	Reporter:	Mikhail Gusarov <dottedmag>
Component:	apt-repo-tools	Assignee:	Nobody's working on this, feel free to take it <nobody>
Status:	CLOSED WONTFIX	QA Contact:	qa-sisyphus
Severity:	minor
Priority:	P2	CC:	glebfm, ldv, mike, placeholder
Version:	unstable
Hardware:	all
OS:	Linux

Description

Mikhail Gusarov 2008-03-06 13:03:38 MSK

gensrclist и genpkglist в пакете не имеют внятной документации.

Если это внутренние утилиты genbasedir - их нужно унести в /usr/libexec. Если 
это внешние утилиты - им нужно дописать документацию.

Comment 1

Michael Shigorin 2010-11-06 13:04:27 MSK

В альте не вменяется в обязательство документирование каждой утилиты, по факту.

Comment 2

Anton Farygin 2026-09-11 08:23:29 MSK

Man-страниц у genbasedir, genpkglist, gensrclist и pkglist-query нет до сих пор (apt-repo-tools 0.11-alt1), но у каждой утилиты есть --help с описанием ключей, а mike@ в комментарии 1 уже сформулировал позицию: документирование каждой утилиты в ALT не обязательно. Утилиты при этом именно внешние — ими пользуются сборщики репозиториев, так что в /usr/libexec они не уедут.

Если man-страницы всё же понадобятся, самый дешёвый путь — генерировать их help2man на этапе сборки, как сделано в alternatives. WONTFIX.