-
598c3763
by Felix Lechner
at 2019-12-08T19:19:29Z
Add a new tag gratuitous-manpage to indicate a manpage without an executable.
The severity minor is the lowest setting to trigger a warning. That
way, most people (including the reporter for Bug#583125) are still
alerted to extra manpages.
Added in response to Bug#583125.
Gbp-Dch: ignore
-
20834ac5
by Felix Lechner
at 2019-12-08T19:20:05Z
Issue new tag gratuitous-manpage when a manpage is not accompanied by an executable. (Closes: #583125)
For now, the tag is issued only for sections 1 (general commands) and
8 (system administration). The other sections look more complicated.
Perhaps section 6 (games) could be added here.
All existing tests for manpages were adjusted except for one. The test
manpages-dependencies ships a manpage in a package called pecho-data.
In that case, the tag was added as expected.
It is unclear how common it is to ship manpages in a separate -data
package. Policy 12.1 clearly discourages it. I struggled with that
question, and then decided to implement the tag.
I was further unsure about the proper severity. The current setting,
minor, is the lowest setting to trigger a warning. That way, most
people (including the reporter for Bug#583125) are still alerted to
extra manpages.
-
cc1fc075
by Felix Lechner
at 2019-12-08T19:20:05Z
Provide test case with manpages that do not come with executables.
In response to Bug#583125.
Gbp-Dch: ignore
-
d08dccfe
by Felix Lechner
at 2019-12-08T19:20:05Z
Fix existing test cases; many did not install executables and triggered new tag gratuitous-manpage.
All tests now install executables, except for manpages-dependencies.
In that test, the new tag was added as expected because the manpage
ships in a separate -data package. According to policy 12.1, such
splitting of manpage and executable is discouraged.
These changes were made in response to Bug#583125.
Gbp-Dch: ignore