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  de‐
15       fault  the lists will only split into multiple lines if the entries are
16       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 de‐
55              pendencies 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 pa‐
62              rameter  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
79       --experimental-rts-parser
80              Enable the experimental round-trip safe parser.   When  enabled,
81              most comments in deb822 control will be preserved.
82
83              The  option  is  a  temporary means to enable users to opt-in to
84              this new experimental feature. The option will be  removed  once
85              the  new parser is mature enough and is ready to unconditionally
86              replace the previous parser.
87
88              This option requires python-debian version 0.1.43  or  later  to
89              work.  However, some features will require 0.1.44 or later.
90
91

AUTHORS

93       wrap-and-sort  and  this  manpage  have  been written by Benjamin Drung
94       <bdrung@debian.org>.
95
96       Both are released under the ISC license.
97
98
99
100DEBIAN                         Debian Utilities               WRAP-AND-SORT(1)
Impressum