po-debconf.desc 5.72 KB
Newer Older
1 2 3 4
Check-Script: po-debconf
Author: Denis Barbier <barbier@linuxfr.org>
Abbrev: pd
Type: source
5
Info: This looks for common mistakes in packages using po-debconf(7).
6
Needs-Info: unpacked
7

8
Tag: not-using-po-debconf
9 10
Severity: serious
Certainty: certain
Russ Allbery's avatar
Russ Allbery committed
11 12
Info: This package seems to be using debconf templates, but it does not
 use po-debconf to make translations possible (<tt>debian/po</tt> doesn't
13 14
 exist). Debian Policy requires that all packages using debconf use a
 gettext-based translation system. If this package uses one other than
15
 po-debconf, please report this as a Lintian bug along with how to detect
Russ Allbery's avatar
Russ Allbery committed
16
 that system.
17
Ref: policy 3.9.1
18

19 20 21 22
Tag: untranslatable-debconf-templates
Severity: serious
Certainty: possible
Info: This package seems to be using debconf templates, but some
23 24
 descriptions are not translatable. You should prepend an underscore
 before every translatable field, as described in po-debconf(7). This
25 26 27 28 29 30 31 32 33 34 35 36
 may mean that translators weren't properly warned about new strings.
 .
 Translators may be notified of changes using podebconf-report-po, for
 example:
 .
  podebconf-report-po --call --withtranslators --deadline="+10 days" \
  --languageteam
 .
 If the field is not intended for users to see, ensure the first line
 of the description contains "for internal use".
Ref: policy 3.9.1

37
Tag: stray-translated-debconf-templates
38 39
Severity: normal
Certainty: certain
40
Info: This package contains a file named *templates.XX or
41 42
 *templates.XX_XX. This was the naming convention for the translated
 templates merged using debconf-mergetemplate. Since the package is using
43 44 45
 po-debconf, these files should be replaced by language-specific files in
 the <tt>debian/po</tt> directory and should no longer be needed.

46
Tag: missing-potfiles-in
47 48
Severity: normal
Certainty: certain
49 50 51
Info: The required file <tt>POTFILES.in</tt> is missing from
 <tt>debian/po</tt>.
Ref: po-debconf(7)
52

53
Tag: missing-file-from-potfiles-in
54 55
Severity: normal
Certainty: certain
56 57 58
Info: A file listed in <tt>debian/po/POTFILES.in</tt> could not be found
 in the source package.
Ref: po-debconf(7)
59

60
Tag: missing-templates-pot
61 62
Severity: normal
Certainty: certain
63 64 65
Info: The required file <tt>templates.pot</tt> is missing from
 <tt>debian/po</tt>.
Ref: po-debconf(7)
66

67
Tag: unknown-encoding-in-po-file
68 69
Severity: normal
Certainty: certain
70 71
Info: Encoding must be declared in PO files. Otherwise, charset
 conversions cannot be performed.
72

73
Tag: invalid-po-file
74 75
Severity: normal
Certainty: certain
76 77 78
Info: Errors were found in the listed PO file that will cause its content
 to be discarded. Run <tt>msgfmt</tt> on the file to see the error
 messages.
79

80 81 82 83 84 85 86 87
Tag: debconf-translation-using-general-list
Severity: normal
Certainty: certain
Info: This debconf translation is using the general debconf-i18n list as
 the address in the Language-Team field.
 .
 The intended purpose of the Language-Team field is to be an additional
 contact for new translation requests in addition to the previous
88
 translator (as recorded in Last-Translator). The field should therefore
89 90 91
 point to a mailing list dedicated to the language of this PO file, not
 the general list for translation discussions.

92
Tag: misnamed-po-file
93 94
Severity: normal
Certainty: possible
95
Info: The name of this PO file doesn't appear to be a valid language
96
 code. Any files in <tt>debian/po</tt> ending in <tt>.po</tt> will be
97
 processed as translations by po2debconf for the language code equal to
98
 the file name without the trailing <tt>.po</tt>. If the file name does
99 100
 not correctly reflect the language of the translation, the translation
 will not be accessible to users of that language.
101 102 103 104 105
 .
 If this file isn't actually a PO file, rename it to something that
 doesn't end in <tt>.po</tt> or move it to another directory so that
 translation merging programs will not be confused.

106
Tag: newer-debconf-templates
107 108
Severity: normal
Certainty: possible
109
Info: debconf-updatepo has not been run since the last change to your
110
 debconf templates.
111 112 113 114 115 116
 .
 You should run debconf-updatepo whenever debconf templates files are
 changed so that translators can be warned that their files are
 outdated.
 .
 This can be ensured by running debconf-updatepo in the 'clean' target
117 118
 of <tt>debian/rules</tt>. PO files will then always be up-to-date when
 building the source package.
119 120

Tag: translated-default-field
121 122
Severity: normal
Certainty: possible
123 124
Info: You should not mark as translatable "Default:" or "DefaultChoice:"
 fields, unless explicitly needed (e.g. default country, default language,
125
 etc.). If this Default field really should be translated, you should
126
 explain translators how they should translate it by using comments or
127
 brackets. For example:
128 129 130 131 132
 .
   # Translators: Default language name, but not translated
   _Default: English
 .
 Or:
133 134
 .
   _Default: English[ Default language name, but not translated]
135 136 137 138 139
 .
 Note that in the first case, Lintian ignores the comment unless it
 explicitly references translators and it is appears directly before
 the field in question.
Ref: po-debconf(7), #637881
140

141
Tag: no-complete-debconf-translation
142 143
Severity: wishlist
Certainty: possible
144
Info: Even though this package provides debconf translation support, there 
145
 are no translations or none of the translations are complete. This may
146 147 148 149 150 151 152
 mean that translators weren't properly warned about new strings.
 .
 Translators may be notified of changes using podebconf-report-po, for
 example:
 .
  podebconf-report-po --call --withtranslators --deadline="+10 days" \
  --languageteam
153
Ref: devref 6.5.2.2
154 155 156 157 158 159 160 161 162 163 164 165

Tag: invalid-potfiles-in
Severity: normal
Certainty: certain
Info: Errors were found in the <tt>debian/po/POTFILES.in</tt> file.
 .
 Please make sure that all strings marked for translation are in uniform
 encoding (say UTF-8) then prepend the following line to POTFILES.in and
 rerun intltool-update.
 .
  [encoding: UTF-8]
Ref: #849912, #883653