vcs.maemo.org Git - maemian/blob - checks/po-debconf.desc

   1 Check-Script: po-debconf
   2 Author: Denis Barbier <barbier@linuxfr.org>
   3 Abbrev: pd
   4 Type: source
   5 Unpack-Level: 1
   6 Info: This looks for common mistakes in packages using po-debconf.
   7 Needs-Info: debfiles
   8
   9 Tag: not-using-po-debconf
  10 Severity: serious
  11 Certainty: certain
  12 Info: This package seems to be using debconf templates, but it does not
  13  use po-debconf to make translations possible (<tt>debian/po</tt> doesn't
  14  exist).  Debian Policy requires that all packages using debconf use a
  15  gettext-based translation system.  If this package uses one other than
  16  po-debconf, please report this as a lintian bug along with how to detect
  17  that system.
  18 Ref: 3.9.1
  19
  20 Tag: stray-translated-debconf-templates
  21 Severity: normal
  22 Certainty: certain
  23 Info: This package contains a file named *templates.XX or
  24  *templates.XX_XX.  This was the naming convention for the translated
  25  templates merged using debconf-mergetemplate.  Since the package is using
  26  po-debconf, these files should be replaced by language-specific files in
  27  the <tt>debian/po</tt> directory and should no longer be needed.
  28
  29 Tag: missing-potfiles-in
  30 Severity: normal
  31 Certainty: certain
  32 Info: The required file <tt>POTFILES.in</tt> is missing from
  33  <tt>debian/po</tt>.
  34 Ref: po-debconf(7)
  35
  36 Tag: missing-file-from-potfiles-in
  37 Severity: normal
  38 Certainty: certain
  39 Info: A file listed in <tt>debian/po/POTFILES.in</tt> could not be found
  40  in the source package.
  41 Ref: po-debconf(7)
  42
  43 Tag: missing-templates-pot
  44 Severity: normal
  45 Certainty: certain
  46 Info: The required file <tt>templates.pot</tt> is missing from
  47  <tt>debian/po</tt>.
  48 Ref: po-debconf(7)
  49
  50 Tag: unknown-encoding-in-po-file
  51 Severity: normal
  52 Certainty: certain
  53 Info: Encoding must be declared in PO files. Otherwise, charset
  54  conversions cannot be performed.
  55
  56 Tag: invalid-po-file
  57 Severity: normal
  58 Certainty: certain
  59 Info: Errors were found in the listed PO file that will cause its content
  60  to be discarded. Run <tt>msgfmt</tt> on the file to see the error
  61  messages.
  62
  63 Tag: misnamed-po-file
  64 Severity: normal
  65 Certainty: possible
  66 Info: The name of this PO file doesn't appear to be a valid language
  67  code.  Any files in <tt>debian/po</tt> ending in <tt>.po</tt> will be
  68  processed as translations by po2debconf for the language code equal to
  69  the file name without the trailing <tt>.po</tt>.  If the file name does
  70  not correctly reflect the language of the translation, the translation
  71  will not be accessible to users of that language.
  72  .
  73  If this file isn't actually a PO file, rename it to something that
  74  doesn't end in <tt>.po</tt> or move it to another directory so that
  75  translation merging programs will not be confused.
  76
  77 Tag: newer-debconf-templates
  78 Severity: normal
  79 Certainty: possible
  80 Info: debconf-updatepo has not been run since the last change to your
  81  debconf templates.
  82  .
  83  You should run debconf-updatepo whenever debconf templates files are
  84  changed so that translators can be warned that their files are
  85  outdated.
  86  .
  87  This can be ensured by running debconf-updatepo in the 'clean' target
  88  of <tt>debian/rules</tt>. PO files will then always be up-to-date when
  89  building the source package.
  90
  91 Tag: translated-default-field
  92 Severity: normal
  93 Certainty: possible
  94 Info: You should not mark as translatable "Default:" or "DefaultChoice:"
  95  fields, unless explicitly needed (e.g. default country, default language,
  96  etc.).  If this Default field really should be translated, you should
  97  explain translators how they should translate it by using brackets.  For
  98  example:
  99  .
 100    _Default: English[ Default language name, but not translated]
 101 Ref: po-debconf(7)
 102
 103 Tag: no-complete-debconf-translation
 104 Severity: wishlist
 105 Certainty: possible
 106 Info: Even though this package provides debconf translation support, there
 107  are no  translations or none of the translations are complete. This may
 108  mean that translators weren't properly warned about new strings.
 109  .
 110  Translators may be notified of changes using podebconf-report-po, for
 111  example:
 112  .
 113   podebconf-report-po --call --withtranslators --deadline="+10 days" \
 114   --languageteam
 115 Ref: devref 6.5.2.2