Bug#1094145: debian-policy: Remove or significantly minimize manual page requirement

2025-01-25 Thread Bill Allombert
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

Re: Converting and unifying policy into a single formatting language?

2025-01-25 Thread Guillem Jover
Hi! On Sat, 2025-01-25 at 12:29:56 +, Sean Whitton wrote: > On Sat 25 Jan 2025 at 12:11pm +01, Guillem Jover wrote: > > This multitude of formatting languages has bothered me for a while, > > every time I take a peek at the sources. :) So this time around I > > pondered how hard could it be to

Re: Bug#1094145: debian-policy: Remove or significantly minimize manual page requirement

2025-01-25 Thread Richard Lewis
Jeremy Bícha writes: > The manpage does not really have useful content. as a user i both agree and disagree with this: i agree that documentation is not very good, but i disagree that nothing would be better than something. Even if people dont use man themselves, the man-page online is often the

Bug#1094145: debian-policy: Remove or significantly minimize manual page requirement

2025-01-25 Thread Jeremy Bícha
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

Re: Converting and unifying policy into a single formatting language?

2025-01-25 Thread Sean Whitton
Hello, On Sat 25 Jan 2025 at 12:11pm +01, Guillem Jover wrote: > This multitude of formatting languages has bothered me for a while, > every time I take a peek at the sources. :) So this time around I > pondered how hard could it be to do that unification, and started > looking into this, which d

Bug#1094145: debian-policy: Remove or significantly minimize manual page requirement

2025-01-25 Thread Guillem Jover
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

Bug#1094145: debian-policy: Remove or significantly minimize manual page requirement

2025-01-25 Thread Sean Whitton
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

Converting and unifying policy into a single formatting language?

2025-01-25 Thread Guillem Jover
Hi! I think at the time of the DebianDoc-SGML to DocBook-XML conversion and then from that to reStructuredText, there seemed to be agreement (AFAIR) among the editors that unifying (ideally) into a single formatting language would be best? For reference there are currently still three languages i

Bug#1094145: debian-policy: Remove or significantly minimize manual page requirement

2025-01-25 Thread Bill Allombert
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