vcs.maemo.org Git - maemian/blob - 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 Severity: important
  11 Certainty: certain
  12 Info: Info documents have to be installed compressed (using <tt>gzip -9</tt>).
  13 Ref: policy 12.2
  14
  15 Tag: info-document-not-compressed-with-gzip
  16 Severity: important
  17 Certainty: certain
  18 Info: Info documents should be compressed with <tt>gzip -9</tt>.
  19 Ref: policy 12.2
  20
  21 Tag: info-document-not-compressed-with-max-compression
  22 Severity: important
  23 Certainty: certain
  24 Info: Info documents should be compressed with <tt>gzip -9</tt>.
  25 Ref: policy 12.2
  26
  27 Tag: info-document-has-wrong-extension
  28 Severity: normal
  29 Certainty: certain
  30 Info: The info document has an extension other than info*.gz.
  31 Ref: policy 12.2
  32
  33 Tag: info-document-missing-dir-section
  34 Severity: normal
  35 Certainty: certain
  36 Info: This info document has no INFO-DIR-SECTION line and no
  37  <tt>--section</tt> option is passed to <tt>install-info</tt> in the
  38  package <tt>postinst</tt> maintainer script.  <tt>install-info</tt> will
  39  be unable to determine the section into which this info page should be
  40  put.  The best solution is to add a line like:
  41  .
  42    @dircategory Development
  43  .
  44  to the texinfo source so that the generated info file will contain a
  45  section.  See /usr/share/info/dir for sections to choose from.
  46  .
  47  Another alternative that doesn't require modifying the source is to
  48  explicitly pass a <tt>--section</tt> option to <tt>install-info</tt> in
  49  the <tt>postinst</tt> maintainer script, although in this case you will
  50  need to write the <tt>postinst</tt> yourself and not use tools like
  51  debhelper to do it for you.
  52 Ref: policy 12.2
  53
  54 Tag: postrm-calls-install-info
  55 Severity: normal
  56 Certainty: certain
  57 Ref: policy 12.2
  58 Info: The postrm script calls the <tt>install-info</tt> command. Usually,
  59  this command should be called from the <tt>prerm</tt> maintainer script.
  60
  61 Tag: preinst-calls-install-info
  62 Severity: important
  63 Certainty: certain
  64 Ref: policy 12.2
  65 Info: The preinst script calls the <tt>install-info</tt> command. Usually,
  66  this command should be called from the <tt>postinst</tt> maintainer script.
  67
  68 Tag: install-info-not-called-with-quiet-option
  69 Severity: normal
  70 Certainty: certain
  71 Ref: policy 3.9
  72 Info: The package installation scripts should avoid producing output which it
  73  is unnecessary for the user to see.  Policy specifically mentions install-info
  74  output as unnecessary.
  75
  76 Tag: info-documents-not-removed
  77 Severity: normal
  78 Certainty: certain
  79 Ref: policy 12.2
  80 Info: The postinst script calls the <tt>install-info</tt> command, but the
  81  documents installed are not then removed by the <tt>prerm</tt>  maintainer
  82  script.