Package: vim-doc
Severity: wishlist

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

Reply via email to