WRAP-AND-SORT(1) General Commands Manual WRAP-AND-SORT(1) NAME wrap-and-sort - wrap long lines and sort items in Debian packaging files SYNOPSIS wrap-and-sort [options] DESCRIPTION wrap-and-sort wraps the package lists in Debian control files. By de- fault the lists will only split into multiple lines if the entries are longer than the maximum line length limit of 79 characters. wrap-and-sort sorts the package lists in Debian control files and all .dirs, .docs, .examples, .info, .install, .links, .maintscript, and .manpages files. Beside that wrap-and-sort removes trailing spaces in these files. This script should be run in the root of a Debian package tree. It searches for control, control*.in, copyright, copyright.in, install, and *.install in the debian directory. OPTIONS -h, --help Show this help message and exit. -a, --wrap-always Wrap all package lists in the Debian control file even if they do not exceed the line length limit and could fit in one line. -s, --short-indent Only indent wrapped lines by one space (default is in-line with the field name). -b, --sort-binary-packages Sort binary package paragraphs by name. -k, --keep-first When sorting binary package paragraphs, leave the first one at the top. Unqualified debhelper(7) configuration files are applied to the first package. -n, --no-cleanup Do not remove trailing whitespaces. -t, --trailing-comma Add a trailing comma at the end of the sorted fields. This min- imizes future differences in the VCS commits when additional de- pendencies are appended or removed. -d path, --debian-directory=path Location of the debian directory (default: ./debian). -f file, --file=file Wrap and sort only the specified file. You can specify this pa- rameter multiple times. All supported files will be processed if no files are specified. -v, --verbose Print all files that are touched. --max-line-length=max_line_length Set the maximum allowed line length. Package lists in the Debian control file that exceed this length limit will be wrapped. The default maximum line length is 79 characters. -N, --dry-run Do not modify any file, instead only print the files that would be modified. --experimental-rts-parser Enable the experimental round-trip safe parser. When enabled, most comments in deb822 control will be preserved. The option is a temporary means to enable users to opt-in to this new experimental feature. The option will be removed once the new parser is mature enough and is ready to unconditionally replace the previous parser. This option requires python-debian version 0.1.43 or later to work. However, some features will require 0.1.44 or later. AUTHORS wrap-and-sort and this manpage have been written by Benjamin Drung <bdrung@debian.org>. Both are released under the ISC license. DEBIAN Debian Utilities WRAP-AND-SORT(1)
Generated by dwww version 1.15 on Thu Jun 20 11:21:45 CEST 2024.