Hello,
On Sun 26 Jan 2025 at 04:56pm +01, Bill Allombert wrote:
> I will go as far as saying that of all package documentation we provide,
> man pages are the most useful, because you can just do 'man somecommand'
> and get something even if you have no idea what somecommand is supposed to
> do.
On Fri, Jan 24, 2025 at 09:04:28PM -0700, Sam Hartman wrote:
> > "Jeremy" == Jeremy Bícha writes:
>
> FWIW, I think it is desirable to get as many man pages as we can.
> To that end, I hope policy continues to:
>
> *encourage writing man pages
>
> * Encourage maintainers to take well writte
On Sat, Jan 25, 2025 at 10:23:01AM -0500, Jeremy Bícha wrote:
> On Sat, Jan 25, 2025 at 5:21 AM Bill Allombert wrote:
> > The man page provides a link between the executable name and the app.
> > This is useful in a lot of situation. Writing such a manpage is not
> > a waste of time.
>
> I think
On Sat, Jan 25, 2025 at 5:21 AM Bill Allombert wrote:
> The man page provides a link between the executable name and the app.
> This is useful in a lot of situation. Writing such a manpage is not
> a waste of time.
I think apps already have .desktop files that provide that link.
As an example of
Hi!
On Sat, 2025-01-25 at 11:21:18 +0100, Bill Allombert wrote:
> On Fri, Jan 24, 2025 at 08:16:29PM -0500, Jeremy Bícha wrote:
> > - Many new contributors to Debian in an attempt to get their new
> > package "Lintian clean" spend significant time creating a manpage for
> > their app, often a GUI
Hello Jeremy,
It's very annoying when you install something and try to 'man foo' and
you don't get documentation. I don't think that situation has got any
less annoying over the past twenty years. It makes the system we are
producing less useful.
I don't think the fact that we have many open Li
On Fri, Jan 24, 2025 at 08:16:29PM -0500, Jeremy Bícha wrote:
> - Many new contributors to Debian in an attempt to get their new
> package "Lintian clean" spend significant time creating a manpage for
> their app, often a GUI app with no command line options. The manpage
> does not really have usef
> "Jeremy" == Jeremy Bícha writes:
FWIW, I think it is desirable to get as many man pages as we can.
To that end, I hope policy continues to:
*encourage writing man pages
* Encourage maintainers to take well written man pages as patches.
At the time that section of policy was last written,
Source: debian-policy
Version: 4.7.0.2
Debian Policy §12.1 has this section:
"Each program, utility, and function should have an associated manual
page included in the same package or a dependency. It is suggested
that all configuration files also have a manual page included as well.
Manual pages
9 matches
Mail list logo
