25a9e80456210aef71cd89458cdc2fa2a660933e
[maemian] / nokia-lintian / checks / patch-systems.desc
1 Check-Script: patch-systems
2 Author: Marc Brockschmidt <he@debian.org>
3 Abbrev: pat
4 Type: source
5 Unpack-Level: 1
6 Info: This script checks for various possible problems when using patch systems
7 Needs-Info: debfiles
8
9 Tag: dpatch-build-dep-but-no-patch-list
10 Type: warning
11 Info: Using dpatch requires you to explicitly list all patches you want
12  to apply in debian/patches/00list. This package build-depends on dpatch,
13  but does not provide a patch list.
14  .
15  You should either remove the dpatch build dependency or add a patch
16  list.
17
18 Tag: dpatch-index-references-non-existent-patch
19 Type: error
20 Info: In the 00list file listing all your dpatches, you referenced a file
21  that does not exist. This will lead to a fatal error when calling dpatch.
22
23 Tag: dpatch-missing-description
24 Type: warning
25 Info: dpatch files should carry a description of the function of the included
26  patch. Description lines start with "## DP:".
27
28 Tag: quilt-build-dep-but-no-series-file
29 Type: warning
30 Info: Using quilt requires you to explicitly list all patches you want
31  to apply in debian/patches/series. This package build-depends on quilt,
32  but does not provide a patch list.
33  .
34  You should either remove the quilt build dependency or add a series
35  file.
36
37 Tag: quilt-series-but-no-build-dep
38 Type: warning
39 Info: The package contains a debian/patches/series file usually used by
40  quilt to apply patches at build time, but quilt is not listed in the
41  build dependencies.
42  .
43  You should either remove the series file if it's effectively not useful
44  or add quilt to the build-dependencies if quilt is used during the build
45  process.
46  .
47  If you don't need quilt during build but only during maintenance work,
48  then you can override this warning.
49
50 Tag: quilt-patch-with-non-standard-options
51 Type: warning
52 Info: The quilt series file contains non-standard options to apply some of
53  the listed patches. Quilt uses '-p1' by default if nothing is specified
54  after the name of the patch and the current series file specify something
55  else for some of the patches listed.
56  .
57  For compatibility with the source "3.0 (quilt)" source package format,
58  you should avoid using any option at all and make sure that your patches
59  apply with "-p1". This can be done by refreshing all patches like this:
60  quilt pop -a; while quilt push; do quilt refresh -pab; done
61
62 Tag: quilt-series-references-non-existent-patch
63 Type: error
64 Info: In the series file listing all your quilt patches, you referenced a
65  file that does not exist. This will lead to a fatal error when calling quilt.
66
67 Tag: patch-modifying-debian-files
68 Type: error
69 Info: A patch stored in debian/patches/ should never modify files
70  in the debian directory (even when it's only creating new files) because
71  the debian directory is always directly provided by the Debian packaging.
72  And you shouldn't have to modify what you choose to provide in the first
73  place.
74  .
75  If the patch provides a new file (say a manual page), place that file
76  in the upstream directory hierarchy as if it was ready to be submitted.
77
78 Tag: patch-system-but-direct-changes-in-diff
79 Type: warning
80 Info: The package uses a patch-system, but the Debian diff.gz contains changes
81  made on files without being separated out in a patch.
82
83 Tag: more-than-one-patch-system
84 Type: warning
85 Info: The build-dependencies list more than one patch system and it's
86  unlikely that you need both at the same time.
87  .
88  Currently lintian knows only dpatch and quilt.