wrap-and-sort

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
       default  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 mini-
              mizes  future  differences  in  the  VCS commits when additional
              dependencies 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
              parameter 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.

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)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2021 Hurricane Electric. All Rights Reserved.