Bug#978552: 978552: conventions for writing Linux man pages
Hi Felix, On 2021-02-06 00:13, Felix Lechner wrote: > Hi Andrius, > > On Fri, Feb 5, 2021 at 1:57 AM Andrius Merkys wrote: >> Within the man-pages project, the necessary updates to these timestamps >> are handled automatically > I like your idea, but how can the dates—being handled > automatically—ever be wrong? Do the scripts neglect to adjust manual > pages provided by Debian's maintainers? Thanks for reviewing my proposal! My proposal aims at the manpages that are written manually or semi-automatically. Particularly 'man-pages' project is not the aim here, I cite their conventions just to show that Debian manpages are supposed to follow the conventions of .TH structure. Best wishes, Andrius
Bug#978552: 978552: conventions for writing Linux man pages
Hi Andrius, On Fri, Feb 5, 2021 at 1:57 AM Andrius Merkys wrote: > > Within the man-pages project, the necessary updates to these timestamps > are handled automatically I like your idea, but how can the dates—being handled automatically—ever be wrong? Do the scripts neglect to adjust manual pages provided by Debian's maintainers? Kind regards Felix Lechner
Processed: Bug#981932 marked as pending in lintian
Processing control commands: > tag -1 pending Bug #981932 [lintian] lintian: warn about packages using PyPI pages in the Homepage field Added tag(s) pending. -- 981932: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=981932 Debian Bug Tracking System Contact ow...@bugs.debian.org with problems
Processed: Bug#981935 marked as pending in lintian
Processing control commands: > tag -1 pending Bug #981935 [lintian] lintian: warn about packages using Rubygems pages in the Homepage field Added tag(s) pending. -- 981935: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=981935 Debian Bug Tracking System Contact ow...@bugs.debian.org with problems
Bug#978552: 978552: conventions for writing Linux man pages
As explained in [1], there actually are conventions for writing man pages given in 'man 7 man-pages'. Thus .TH line can be trusted to contain the date of last non-trivial change: date: The date of the last nontrivial change that was made to the man page. (Within the man-pages project, the necessary updates to these timestamps are handled automatically by scripts, so there is no need to manually update them as part of a patch.) Dates should be written in the form -MM-DD. [1] https://lists.debian.org/debian-devel/2021/02/msg00040.html Andrius
Bug#981935: lintian: warn about packages using Rubygems pages in the Homepage field
Package: lintian Version: 2.104.0 Severity: wishlist Please warn about packages using Rubygems pages in the Homepage field. Rubygems is a packaging system just as Debian is a packaging system and each Rubygems package has a Homepage link that points at the upstream homepage. Debian packages should point at the upstream homepage rather than the page for other packaging systems like Rubygems. There are several forms of Homepages that are used, both are URLs like this, with/without the trailing slash and with/without https: https://rubygems.org/gems// This URL is a false positive and is the correct Homepage for the Debian rubygems package manager itself. https://rubygems.org/ According to the Debian Code Search service 21 packages are affected: https://codesearch.debian.net/search?literal=0=path%3Adebian%2Fcontrol+Homepage%3A.%2Arubygem=0 -- bye, pabs https://wiki.debian.org/PaulWise signature.asc Description: This is a digitally signed message part
Bug#981932: lintian: warn about packages using PyPI pages in the Homepage field
Package: lintian Version: 2.104.0 Severity: wishlist Please warn about packages using PyPI pages in the Homepage field. PyPI is a packaging system just as Debian is a packaging system and each PyPI package has a Homepage link that points at the upstream homepage. Debian packages should point at the upstream homepage rather than the page for other packaging systems like PyPI. There are two forms of Homepages that are used, the first of these is the current one, and the second one is the old one and it redirects to the current one. https://pypi.org/project// https://pypi.python.org/pypi// According to the Debian Code Search service 100 packages are affected: https://codesearch.debian.net/search?q=path%3Adebian%2Fcontrol+Homepage%3A.*pypi=0 -- bye, pabs https://wiki.debian.org/PaulWise signature.asc Description: This is a digitally signed message part