@@ -0,0 +1,123 @@
+.TH NETSELECT-APT 1 "March 6, 2008" "DEBIAN" \" -*- nroff -*-
+.\" Please adjust this date whenever revising the manpage.
+netselect-apt \- create sources.list for the fastest Debian mirrors
+.RI [ OPTIONS ]
+.\" copied verbatim from netselect-apt
+.RI [ \|stable | testing | unstable | experimental | \fIrelease_codename\fR | sid ]
+automatically creates a \fIsources.list\fR file for using with
+for the specified distribution by downloading the list of Debian
+and choosing the fastest servers using
+.BR netselect .
+The output file is written to
+.IR OUTFILE .
+is not installed setuid, then
+needs to run as an administrator user (i.e. root). This is only required
+because the network probes done by
+requires these permissions. No changes are done to the system.
+.BI "\-i" " INFILE"
+uses that rather than downloading another copy to a temporary file. The file
+will be downloaded from http://www.debian.org/mirror/mirrors_full
+.IR stable | testing | unstable | experimental | \fIrelease_codename\fR | sid
+Specify which distribution of Debian to use. By default
+.BI "\-a, \-\-arch" " ARCH"
+Use mirrors containing \fIARCH\fR. By default the architecture of the current
+machine is used as reported by \fBdpkg\fR
+.B \-s, \-\-sources
+include also deb-src lines to use with ``apt-get source'' to obtain
+Debian source packages.
+.BI "\-i, \-\-infile" " INFILE"
+instead of downloading the mirror list to a temporary file. The file must be in
+the same format as mirrors_full.
+.BI "\-o, \-\-outfile" " OUTFILE"
+instead of sources.list.
+.B \-n, \-\-nonfree
+Include also non-free section while generating
+.IR OUTFILE .
+.B \-f, \-\-ftp
+Use FTP mirrors instead of HTTP and generate
+setting this to 1 is equivalent to --sources
+setting this to 1 is equivalent to --nonfree
+is unable to work with restricted environments in which network filtering is
+implemented as it relies on
+being able to find a suitable mirror. To do this, the system where the script is run
+needs to have network visibility of the mirrors, as it will probe them using UDP probes.
+is also unable to work in environments where HTTP or FTP network connections have to be
+done through a proxy host, as it relies on being able to test the validity of the
+remote mirrors doing direct network connections to them.
+will not check if the mirror it suggests as the "fastest" mirror is either valid or
+up-to-date. It is recommended that users that use this tool also validate that the
+mirrors suggested are official mirrors and are also current.
+.SH SEE ALSO
+.BR netselect (1),
+.BR wget (1),
+.BR curl (1),
+.BR apt (8),
+.IR sources.list (5).
+For Debian GNU/Linux it is recommended that users review the official mirror
+list at http://www.debian.org/mirror/official as well as the mirror checker
+tool at http://mirror.debian.org/status.html (which provides information on the
+up-to-dateness status of mirrors)
+Avery Pennarun <firstname.lastname@example.org>
+This manual page and program have been also enhanced by
+Filippo Giunchedi <email@example.com> and Javier Fernandez-Sanguino <firstname.lastname@example.org>