NAME

       dpkg-scansources - create Sources index files

SYNOPSIS

       dpkg-scansources [option...] binary-dir [override-file [path-prefix]] > Sources

DESCRIPTION

       dpkg-scansources  scans  the  given binary-dir for .dsc files.  These are used to create a
       Debian source index, which is output to stdout.

       The override-file, if given, is used to set priorities in the resulting index records  and
       to  override  the  maintainer  field  given in the .dsc files.  The file can be compressed
       (since dpkg 1.15.5).  See deb-override(5) for the format of this  file.  Note:  Since  the
       override  file is indexed by binary, not source packages, there's a bit of a problem here.
       The current implementation uses the highest priority of all the binary  packages  produced
       by  a  .dsc  file  for  the priority of the source package, and the override entry for the
       first binary package listed in the .dsc file to modify maintainer information. This  might
       change.

       The  path-prefix,  if  given,  is prepended to the directory field in the generated source
       index. You generally use this to make the directory fields contain the path from  the  top
       of the Debian archive hierarchy.

       Note:  If you want to access the generated Sources file with apt(8) you will probably need
       to compress the file with gzip(1) (generating a Sources.gz file). apt ignores uncompressed
       Sources files except on local access (i.e.  file:// sources).

OPTIONS

       -n, --no-sort
           Don't sort the index records. Normally they are sorted by source package name.

       -e, --extra-override file
           Scan  file  to  find  supplementary  overrides  (since  dpkg  1.15.4;  the file can be
           compressed since dpkg 1.15.5).  See deb-extra-override(5) for more information on  its
           format.

       -s, --source-override file
           Use  file  as the source override file (the file can be compressed since dpkg 1.15.5).
           The default is the name of the override file you specified with .src appended.

           The source override file is in a different format from the binary  override  file.  It
           contains  only  two  whitespace separated fields, the first is the source package name
           and the second is the section. Blank lines and comment lines are ignored in the normal
           manner.  If  a  package appears in both files the source override takes precedence for
           setting the section.

       --debug
           Turn debugging on.

       --help
           Show the usage message and exit.

       --version
           Show the version and exit.

ENVIRONMENT

       DPKG_COLORS
              Sets the color mode (since dpkg 1.18.5).  The currently accepted values  are:  auto
              (default), always and never.

       DPKG_NLS
              If set, it will be used to decide whether to activate Native Language Support, also
              known as internationalization (or i18n) support (since dpkg 1.19.0).  The  accepted
              values are: 0 and 1 (default).

SEE ALSO

       deb-override(5), deb-extra-override(5), dpkg-scanpackages(1).