448e7cb1a81a13d7fc68ef52110d05cac03684c9
[lintian/lintian.git] / checks / source-copyright.desc
1 Check-Script: source-copyright
2 Author: Jakub Wilk <jwilk@debian.org>
3 Abbrev: scpy
4 Type: source
5 Needs-Info: debfiles, unpacked
6 Info: This script checks if a source package conforms to policy
7  with regard to copyright files.
8  .
9  Each source package should have a debian/copyright file.
10
11 Tag: debian-copyright-is-symlink
12 Severity: normal
13 Certainty: certain
14 Info: The file <tt>debian/copyright</tt> is a symlink instead of a regular
15  file.  This makes package checking and manipulation more difficult.
16  .
17  This problem may have prevented lintian from performing other checks.
18
19 Tag: no-debian-copyright
20 Severity: minor
21 Certainty: certain
22 Ref: policy 12.5
23 Info: Every package must include the file <tt>/usr/share/doc/<i>pkg</i>/copyright</tt>.
24  A copy of this file should be in <tt>debian/copyright</tt> in the source package.
25
26 Tag: no-dep5-copyright
27 Severity: pedantic
28 Certainty: possible
29 Info: This package does not use Machine-readable debian/copyright file.
30  .
31  This format help to review license problem and could be easily parsed
32  by Lintian.
33 Ref: https://dep.debian.net/deps/dep5/
34
35 Tag: unknown-copyright-format-uri
36 Severity: pedantic
37 Certainty: wild-guess
38 Info: The copyright file appears to intended as machine-readable, but lintian
39  cannot recognize its format URI.  It could be a typo for a common URI or a
40  syntax error in the first paragraph.  Please file a bug against Lintian if you
41  believe that the copyright file in syntactically valid and the URI is
42  correct.
43
44 Tag: boilerplate-copyright-format-uri
45 Severity: normal
46 Certainty: possible
47 Info: Format URI of the machine-readable copyright file contains
48  <tt>VERSIONED_FORMAT_URL</tt> or <tt>REVISION</tt> string.  Please replace it
49  with an actual URI or an actual revision number respectively.
50
51 Tag: wiki-copyright-format-uri
52 Severity: pedantic
53 Certainty: possible
54 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
55 Info: Format URI of the machine-readable copyright file refers to Debian Wiki.
56  .
57  Debian Wiki is not used for the format development anymore.  Please use
58  <tt>https://www.debian.org/doc/packaging-manuals/copyright-format/<i>version</i>/</tt>
59  as the format URI instead.
60
61 Tag: unversioned-copyright-format-uri
62 Severity: pedantic
63 Certainty: possible
64 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
65 Info: Format URI of the machine-readable copyright file is not versioned.
66  .
67  Please use
68  <tt>https://www.debian.org/doc/packaging-manuals/copyright-format/<i>version</i>/</tt>
69  as the format URI instead.
70
71 Tag: out-of-date-copyright-format-uri
72 Severity: pedantic
73 Certainty: possible
74 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
75 Info: A newer version of the machine-readable copyright file specification,
76  than the one referenced by the copyright file, is available.
77  .
78  This problem may have prevented lintian from performing other checks.
79
80 Tag: syntax-error-in-dep5-copyright
81 Severity: normal
82 Certainty: possible
83 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
84 Info: The machine-readable copyright file didn't pass Debian control file
85  syntax check.
86  .
87  This issue may hide other issues as Lintian skips some checks on the
88  file in this case.
89
90 Tag: obsolete-field-in-dep5-copyright
91 Severity: normal
92 Certainty: possible
93 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
94 Info: The machine-readable copyright file uses a field, that used to be defined
95  by the specification, but has been renamed since then.
96  .
97  Please use Format instead of Format-Specification.
98  .
99  Please use Upstream-Contact instead of Contact, Maintainer or Upstream-Maintainer.
100  .
101  Please use Upstream-Name instead of Name.
102
103 Tag: comma-separated-files-in-dep5-copyright
104 Severity: normal
105 Certainty: possible
106 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
107 Info: A list of files in the machine-readable copyright format appears to be
108  separated by commas.  The file list should be whitespace separated instead.
109  .
110  Please note this tag is only emitted once per checked copyright file.
111
112 Tag: missing-field-in-dep5-copyright
113 Severity: normal
114 Certainty: possible
115 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
116 Info: The paragraph in the machine readable copyright file is missing a field
117  that is required by the specification.
118
119 Tag: empty-short-license-in-dep5-copyright
120 Severity: normal
121 Certainty: possible
122 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
123 Info: The short license field in the machine readable copyright file
124  is empty.
125
126 Tag: license-problem-undefined-license
127 Severity: serious
128 Certainty: possible
129 Ref: https://ftp-master.debian.org/REJECT-FAQ.html
130 Info: Your copyright file references a license that is not defined.
131  Due to copyright law or treaties, files that are not available under
132  a defined license are non-free and non-re-distributable.
133  .
134  Referencing an undefined license could mean the file cannot be
135  distributed in Debian or it could simply mean that the existing
136  license needs to be documented. In both cases,
137  the copyright file should be updated to reflect reality.
138  .
139  Please re-package the package without the file (if possible)
140  or ask the FTP-masters to remove the package.
141  .
142  If the package has been uploaded to Debian before, and if
143  affected files cannot be distributed in Debian please
144  remember to also notify snapshot.debian.org about this
145  package containing a non-distributable file.
146
147 Tag: invalid-short-name-in-dep5-copyright
148 Severity: minor
149 Certainty: certain
150 Ref: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
151 Info: The license header contains a short name observed to be a
152  misspelling of one of the standard short names.
153
154 Tag: space-in-std-shortname-in-dep5-copyright
155 Severity: minor
156 Certainty: certain
157 Ref: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
158 Info: The license header contains a short name with a space, which
159  does not conform to the specification.
160
161 Tag: missing-license-paragraph-in-dep5-copyright
162 Severity: normal
163 Certainty: possible
164 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
165 Info: The files paragraph in the machine readable copyright file references a
166  license, for which no standalone license paragraph exists.
167
168 Tag: missing-license-text-in-dep5-copyright
169 Severity: normal
170 Certainty: possible
171 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
172 Info: The standalone license header contains only short license name, but not
173  the license text.
174
175 Tag: unused-license-paragraph-in-dep5-copyright
176 Severity: minor
177 Certainty: possible
178 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
179 Info: The license paragraph in the machine-readable copyright file is not
180  referenced by any files paragraph.  It could be a typo in the license name or
181  the license paragraph is simply not needed and can be removed.
182
183 Tag: unknown-paragraph-in-dep5-copyright
184 Severity: normal
185 Certainty: possible
186 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
187 Info: The machine-readable copyright file contains a paragraph that is neither
188  a standalone license paragraph nor a files paragraph.
189
190 Tag: field-name-typo-in-dep5-copyright
191 Severity: normal
192 Certainty: possible
193 Info: The listed field name is a likely misspelling of one of the documented
194  DEP-5 fields.
195  .
196  Lintian will continue by using the "misspelled" variant, but other parsers
197  are unlikely to do so.
198  .
199  Implementation detail: The typo is detected by using "Levenshtein
200  edit distance".  Therefore, if the typo involve several characters,
201  Lintian may not detect it.
202
203 Tag: ambiguous-paragraph-in-dep5-copyright
204 Severity: normal
205 Certainty: possible
206 Ref: #652380, https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
207 Info: The paragraph has a "License" and a "Copyright" field, but no
208  "Files" field.  Technically, this is a valid paragraph per the DEP-5
209  specification.  However, it is mostly likely a mistake.
210  .
211  If it is a <tt>stand-alone license paragraph</tt>, the "Copyright"
212  field is not needed and should be removed.  On the other hand, if it
213  is a <tt>files paragraph</tt>, it is missing the "Files" field.
214  .
215  Please note that while the "Files" field was optional in some cases
216  in some of the earlier draft versions, it is mandatory in <i>all</i>
217  <tt>files paragraphs</tt> in the current specification.
218  .
219  Lintian will attempt to guess what you intended and continue based on
220  its guess.  If the guess is wrong, you may see spurious tags related
221  to this paragraph.
222
223 Tag: pipe-symbol-used-as-license-disjunction
224 Severity: normal
225 Certainty: possible
226 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
227 Info: In contrast to package dependencies, the pipe symbol or vertical
228  bar does not indicate a logical disjunction or OR-relationship
229  between two license short names. Instead, the keyword "or" between
230  two license names indicates the dual licensing.
231
232 Tag: invalid-escape-sequence-in-dep5-copyright
233 Severity: normal
234 Certainty: possible
235 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
236 Info: The only allowed escape sequences are "\*", "\?" and "\\" (without
237  quotes) to produce a literal star, question mark and backslash, respectively.
238  Without the escaping backslash, the star and question mark take the role of
239  globbing operators similar to shell globs which is why they have to be
240  escaped. No other escapable characters than "*", "?" and "\" exist.
241
242 Tag: wildcard-matches-nothing-in-dep5-copyright
243 Severity: minor
244 Certainty: possible
245 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
246 Info: The wildcard that was specified matches no file in the source tree.
247  This either indicates that you should fix the wildcard so that it matches
248  the intended file or that you can remove the wildcard. Notice that in
249  contrast to shell globs, the "*" (star or asterisk) matches slashes and
250  leading dots.
251
252 Tag: file-without-copyright-information
253 Severity: normal
254 Certainty: possible
255 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
256 Info: The source tree contains a file which was not matched by any of
257  the <tt>Files</tt> paragraphs in debian/copyright. Either adjust existing
258  wildcards to match that file or add a new <tt>Files</tt> paragraph.
259
260 Tag: unused-file-paragraph-in-dep5-copyright
261 Severity: minor
262 Certainty: possible
263 Ref: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
264 Info: The <tt>Files</tt> paragraph in debian/copyright is superfluous as it is
265  never used to match any files. You should be able to safely remove it.