#1001247 vim-doc: Please publish Vim packaging policy on the Web

#1001247#5
Date:
2021-12-06 22:41:59 UTC
From:
To:
Hi,

Lintian provides references to the Vim packaging in tag descriptions.
[1] We determine the appropriate sections by scanning your HTML index
file. [2] Vim is somewhat special because your policy is not
published. (Doc-base isn't either.) All we can do, therefore, is
provide URI into a user's file system.

Unfortunately, your URL structure is significantly different between
the versions in stable and unstable. (For example, x73.html vs
x65.html; please see below for details.) The Lintian maintainers are
therefore uncertain which version to provide. The easiest way would be
for you to publish your packaging policy on the Web. Several other
teams do so. [3]

You may be eligible for the same assistance that we were offered from
the official New Maintainer's guide. [4][5] For Lintian, we ended up
publishing the manual ourselves, but we have a website. [6]

Alternatively, I could replace the Vim policy reference in the tag
shown above [1] with a more permanent link. I believe that no other
tags refer to your policy. Thank you!

Kind regards
Felix Lechner

[1] https://lintian.debian.org/tags/vim-addon-within-vim-runtime-path
[2] https://salsa.debian.org/lintian/lintian/-/blob/master/data/authority/vim-policy
[3] https://salsa.debian.org/lintian/lintian/-/tree/master/data/authority
[4] https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=998701#15
[5] https://www.debian.org/doc/manuals/maint-guide/index.en.html
[6] https://lintian.debian.org/

* * *

If <section> is an underscore, that line specifies the title and URL
for the whole manual.

bullseye:

_::Debian Packaging Policy for
Vim::file:///usr/share/doc/vim/vim-policy.html/index.html
1::Vim Addon Packaging in a
Nutshell::file:///usr/share/doc/vim/vim-policy.html/index.html#nutshell
2::Vim Packaging::file:///usr/share/doc/vim/vim-policy.html/x73.html
3::Packaging of Vim Addons::file:///usr/share/doc/vim/vim-policy.html/x113.html
3.1::Addon Structure::file:///usr/share/doc/vim/vim-policy.html/x113.html#addon-structure
3.2::Addon Packages::file:///usr/share/doc/vim/vim-policy.html/x113.html#addon-packages
3.3::Registry Entries::file:///usr/share/doc/vim/vim-policy.html/x113.html#registry-entry
4::Tools::file:///usr/share/doc/vim/vim-policy.html/x221.html
A::Vim Registry Entry
Examples::file:///usr/share/doc/vim/vim-policy.html/a245.html

sid:

_::Debian Packaging Policy for
Vim::file:///usr/share/doc/vim/vim-policy.html/index.html
1::Vim Addon Packaging in a
Nutshell::file:///usr/share/doc/vim/vim-policy.html/index.html#nutshell
2::Vim Packaging::file:///usr/share/doc/vim/vim-policy.html/x65.html
3::Packaging of Vim Addons::file:///usr/share/doc/vim/vim-policy.html/x126.html
3.1::Addon Structure::file:///usr/share/doc/vim/vim-policy.html/x126.html#addon-structure
3.2::Addon Packages::file:///usr/share/doc/vim/vim-policy.html/x126.html#addon-packages
4::Tools::file:///usr/share/doc/vim/vim-policy.html/x166.html

#1001247#10
Date:
2021-12-06 23:25:58 UTC
From:
To:
https://vim-team.pages.debian.net/vim/

That's an artifact of docbook2html, as far as I know.  I certainly don't
do anything to specifically generate those obtuse names.


Cheers,