1WRAP-AND-SORT(1) General Commands Manual WRAP-AND-SORT(1)
2
3
4
6 wrap-and-sort - wrap long lines and sort items in Debian packaging
7 files
8
10 wrap-and-sort [options]
11
12
14 wrap-and-sort wraps the package lists in Debian control files. By
15 default the lists will only split into multiple lines if the entries
16 are longer than the maximum line length limit of 79 characters.
17 wrap-and-sort sorts the package lists in Debian control files and all
18 .dirs, .docs, .examples, .info, .install, .links, .maintscript, and
19 .manpages files. Beside that wrap-and-sort removes trailing spaces in
20 these files.
21
22 This script should be run in the root of a Debian package tree. It
23 searches for control, control*.in, copyright, copyright.in, install,
24 and *.install in the debian directory.
25
26
28 -h, --help
29 Show this help message and exit.
30
31 -a, --wrap-always
32 Wrap all package lists in the Debian control file even if they
33 do not exceed the line length limit and could fit in one line.
34
35 -s, --short-indent
36 Only indent wrapped lines by one space (default is in-line with
37 the field name).
38
39 -b, --sort-binary-packages
40 Sort binary package paragraphs by name.
41
42 -k, --keep-first
43 When sorting binary package paragraphs, leave the first one at
44 the top.
45
46 Unqualified debhelper(7) configuration files are applied to the
47 first package.
48
49 -n, --no-cleanup
50 Do not remove trailing whitespaces.
51
52 -t, --trailing-comma
53 Add a trailing comma at the end of the sorted fields. This min‐
54 imizes future differences in the VCS commits when additional
55 dependencies are appended or removed.
56
57 -d path, --debian-directory=path
58 Location of the debian directory (default: ./debian).
59
60 -f file, --file=file
61 Wrap and sort only the specified file. You can specify this
62 parameter multiple times. All supported files will be processed
63 if no files are specified.
64
65 -v, --verbose
66 Print all files that are touched.
67
68 --max-line-length=max_line_length
69 Set the maximum allowed line length. Package lists in the Debian
70 control file that exceed this length limit will be wrapped.
71
72 The default maximum line length is 79 characters.
73
74 -N, --dry-run
75 Do not modify any file, instead only print the files that would
76 be modified.
77
78
80 wrap-and-sort and this manpage have been written by Benjamin Drung
81 <bdrung@debian.org>.
82
83 Both are released under the ISC license.
84
85
86
87DEBIAN Debian Utilities WRAP-AND-SORT(1)