1 files changed, 93 insertions, 0 deletions
diff --git a/man/dpkg-scansources.1 b/man/dpkg-scansources.1
new file mode 100644
index 0000000..f50c186
--- /dev/null
+++ b/man/dpkg-scansources.1
@@ -0,0 +1,93 @@
+.\" dpkg manual page - dpkg-scansources(1)
+.\"
+.\" Copyright © 2005 Roderick Schertler <roderick@argon.org>
+.\" Copyright © 2006 Frank Lichtenheld <djpig@debian.org>
+.\" Copyright © 2009 Raphaël Hertzog <hertzog@debian.org>
+.\"
+.\" This is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" This is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
+.
+.TH dpkg\-scansources 1 "2011-08-14" "Debian Project" "dpkg utilities"
+.SH NAME
+dpkg\-scansources \- create Sources index files
+.
+.SH SYNOPSIS
+.B dpkg\-scansources
+.RI [ option "...] " binary-dir
+.RI [ override-file
+.RI [ path-prefix ]]
+.B >
+.I Sources
+.
+.SH DESCRIPTION
+\fBdpkg\-scansources\fR scans the given \fIbinary-dir\fR for \fI.dsc\fR files.
+These are used to create a Debian source index, which is output to
+stdout.
+.PP
+The \fIoverride-file\fR, if given, is used to set priorities in the resulting
+index records and to override the maintainer field given in the \fI.dsc\fR
+files. The file can be compressed. See
+.BR deb\-override (5)
+for the format of this file. \s-1NB:\s0  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 \fI.dsc\fR file for the priority of the
+source package, and the override entry for the first binary package listed
+in the \fI.dsc\fR file to modify maintainer information. This might change.
+.PP
+The \fIpath-prefix\fR, 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.
+.
+.PP
+.B Note:
+If you want to access the generated Sources file with
+.BR apt (8)
+you will probably need to compress the file with
+.BR gzip (1)
+(generating a Sources.gz file). apt ignores uncompressed Sources files
+except on local access (i.e.
+.B file://
+sources).
+.
+.SH OPTIONS
+.IP "\fB\-n\fR, \fB\-\-no\-sort\fR" 4
+Don't sort the index records. Normally they are sorted by source package
+name.
+.TP
+.IP "\fB\-e\fR, \fB\-\-extra\-override\fR \fIfile\fP" 4
+Scan \fIfile\fP to find supplementary overrides (the file can be
+compressed). See
+.BR deb\-extra\-override (5)
+for more information on its format.
+.IP "\fB\-s\fR, \fB\-\-source\-override\fR \fIfile\fR" 4
+Use \fIfile\fR as the source override file (the file can be compressed).
+The default is the name of the override file you specified with \fI.src\fR
+appended.
+.sp
+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.
+.IP "\fB\-\-debug\fR" 4
+Turn debugging on.
+.IP "\fB\-\-help\fR" 4
+Show the usage message and exit.
+.IP "\fB\-\-version\fR" 4
+Show the version and exit.
+.
+.SH "SEE ALSO"
+.BR deb\-override (5),
+.BR deb\-extra\-override (5),
+.BR dpkg\-scanpackages (1).