Bug#534640: lintian should check that info files contains section and directory entry

[Russ Allbery <rra@debian.org>]

Tag: info-document-missing-dir-section
Severity: normal
Certainty: certain
Info: This info document has no INFO-DIR-SECTION line and no
 <tt>--section</tt> option is passed to <tt>install-info</tt> in the
 package <tt>postinst</tt> maintainer script.  <tt>install-info</tt> will
 be unable to determine the section into which this info page should be
 put.  The best solution is to add a line like:
 .
   @dircategory Development
 .
 to the texinfo source so that the generated info file will contain a
 section.  See /usr/share/info/dir for sections to choose from.
 .
 Another alternative that doesn't require modifying the source is to
 explicitly pass a <tt>--section</tt> option to <tt>install-info</tt> in
 the <tt>postinst</tt> maintainer script, although in this case you will
 need to write the <tt>postinst</tt> yourself and not use tools like
 debhelper to do it for you.
Ref: policy 12.2

It's been there for quite a while.  It needs to be modified so that
passing --section to install-info isn't enough, but is there something
more that it needs besides that, or some other problem with the existing
Lintian check?

I assume we should drop the requirement that the maintainer scripts call
install-info and indeed warn if they do, noting that the calls can be
removed.

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>