1WRAP-AND-SORT(1)            General Commands Manual           WRAP-AND-SORT(1)
2
3
4

NAME

6       wrap-and-sort  -  wrap  long  lines  and sort items in Debian packaging
7       files
8

SYNOPSIS

10       wrap-and-sort [options]
11
12

DESCRIPTION

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

OPTIONS

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

AUTHORS

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)
Impressum