vcs.maemo.org Git - maemian/blob - nokia-lintian/checks/infofiles.desc

   1 Check-Script: infofiles
   2 Author: Josip Rodin <jrodin@jagor.srce.hr>
   3 Abbrev: info
   4 Type: binary
   5 Unpack-Level: 2
   6 Needs-Info: file-info
   7 Info: This script checks if a binary package conforms to info document policy.
   8
   9 Tag: info-document-not-compressed
  10 Type: error
  11 Info: Info documents have to be installed compressed (using <tt>gzip -9</tt>).
  12 Ref: policy 12.2
  13
  14 Tag: info-document-not-compressed-with-gzip
  15 Type: error
  16 Info: Info documents should be compressed with <tt>gzip -9</tt>.
  17 Ref: policy 12.2
  18
  19 Tag: info-document-not-compressed-with-max-compression
  20 Type: error
  21 Info: Info documents should be compressed with <tt>gzip -9</tt>.
  22 Ref: policy 12.2
  23
  24 Tag: info-document-has-wrong-extension
  25 Type: warning
  26 Info: The info document has an extension other than info*.gz.
  27 Ref: policy 12.2
  28
  29 Tag: info-document-missing-dir-section
  30 Type: warning
  31 Info: This info document has no INFO-DIR-SECTION line and no
  32  <tt>--section</tt> option is passed to <tt>install-info</tt> in the
  33  package <tt>postinst</tt> maintainer script.  <tt>install-info</tt> will
  34  be unable to determine the section into which this info page should be
  35  put.  The best solution is to add a line like:
  36  .
  37    @dircategory Development
  38  .
  39  to the texinfo source so that the generated info file will contain a
  40  section.  See /usr/share/info/dir for sections to choose from.
  41  .
  42  Another alternative that doesn't require modifying the source is to
  43  explicitly pass a <tt>--section</tt> option to <tt>install-info</tt> in
  44  the <tt>postinst</tt> maintainer script, although in this case you will
  45  need to write the <tt>postinst</tt> yourself and not use tools like
  46  debhelper to do it for you.
  47 Ref: policy 12.2
  48
  49 Tag: postrm-calls-install-info
  50 Type: warning
  51 Ref: policy 12.2
  52 Info: The postrm script calls the <tt>install-info</tt> command. Usually,
  53  this command should be called from the <tt>prerm</tt> maintainer script.
  54
  55 Tag: preinst-calls-install-info
  56 Type: error
  57 Ref: policy 12.2
  58 Info: The preinst script calls the <tt>install-info</tt> command. Usually,
  59  this command should be called from the <tt>postinst</tt> maintainer script.
  60
  61 Tag: install-info-not-called-with-quiet-option
  62 Type: warning
  63 Ref: policy 3.10
  64 Info: The package installation scripts should avoid producing output which it
  65  is unnecessary for the user to see.  Policy specifically mentions install-info
  66  output as unnecessary.
  67
  68 Tag: info-documents-not-removed
  69 Type: warning
  70 Ref: policy 12.2
  71 Info: The postinst script calls the <tt>install-info</tt> command, but the
  72  documents installed are not then removed by the <tt>prerm</tt>  maintainer
  73  script.