Package: debmirror
Version: 1:2.26
Severity: minor
Hello!
I suppose that file /usr/share/doc/debmirror/examples/debmirror.conf is unclear
and confusing (see e.g. #466801).
It also contains some obsolete variable names.
Thus, there should be more comments and examples in it.
I propose a patch with them.
Best regards,
Alexey
-- System Information:
Debian Release: 9.0
APT prefers stable
APT policy: (500, 'stable')
Architecture: amd64 (x86_64)
Kernel: Linux 4.9.0-3-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.utf8 (charmap=UTF-8), LANGUAGE=en_US:en
(charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
Versions of packages debmirror depends on:
ii bzip2 1.0.6-8.1
pn libdigest-md5-perl
ii liblockfile-simple-perl 0.208-1
ii libperl5.24 [libdigest-sha-perl] 5.24.1-3
ii libwww-perl 6.15-1
ii perl 5.24.1-3
ii perl-modules-5.24 [libnet-perl] 5.24.1-3
ii rsync 3.1.2-1
Versions of packages debmirror recommends:
ii ed 1.10-2.1
ii gpgv 2.1.18-6
ii patch 2.7.5-1+b2
Versions of packages debmirror suggests:
ii gnupg 2.1.18-6
-- no debconf information
--- debmirror.conf 2014-07-03 00:54:08.0 +0400
+++ ./new/debmirror.conf2017-06-18 20:52:02.353975632 +0300
@@ -12,7 +12,7 @@
# files.
# Location of the local mirror (use with care)
-# $mirrordir="/path/to/mirrordir"
+# $mirrordir="/path/to/mirrordir";
# Output options
$verbose=0;
@@ -25,36 +25,55 @@
$passwd="anonymous@";
$remoteroot="debian";
$download_method="ftp";
-@dists="sid";
-@sections="main,main/debian-installer,contrib,non-free";
-@arches="i386";
-# @ignores="";
-# @excludes="";
-# @includes="";
-# @excludes_deb_section="";
-# @limit_priority="";
$omit_suite_symlinks=0;
$skippackages=0;
-# @rsync_extra="doc,tools";
$i18n=0;
$getcontents=0;
$do_source=1;
$max_batch=0;
+# Multiple distributions, sections, arches, extras may be specified at once,
+# separated by commas like in lines below.
+# Uncomment the next string to mirror stretch dists.
+# Otherwise, sid is the default.
+# @dists="stretch,stretch-updates,stretch-backports";
+@sections="main,main/debian-installer,contrib,non-free";
+@arches="i386";
+# If you wish to create custom CD images using for example debian-cd, you
+# will probably also want mirror doc and tools.
+# @rsync_extra="trace,doc,tools";
# @di_dists="dists";
# @di_archs="arches";
+# Multiple includes, excludes and other options with regex arguments
+# may be specified at once as a perl array.
+# For example the next string excludes following sections:
+# all "debug", "contrib/games", "main/sound" and all "tex" but not "text".
+# @excludes_deb_section=("debug", "contrib/games", "^sound", "tex\$");
+
+# Uncomment the next line to limit download to files with specified
+# Debian Priority
+# @limit_priority=("required", "important", "standard", "optional", "extra");
+
+# Uncomment the following string to completely exclude debug symbols and
+# developer files if you do not need them.
+# @excludes=("-dbg_", "-dev_");
+# @includes="";
+# @ignores="";
+
# Save mirror state between runs; value sets validity of cache in days
$state_cache_days=0;
# Security/Sanity options
+# @keyrings="/path/to/keyrings/file";
$ignore_release_gpg=0;
-$ignore_release=0;
-$check_md5sums=0;
+$check_gpg=1;
+$ignore_missing_release=0;
+$verify_checksums=0;
$ignore_small_errors=0;
# Cleanup
-$cleanup=0;
+$pre_cleanup=0;
$post_cleanup=1;
# Locking options
@@ -62,7 +81,9 @@
# Rsync options
$rsync_batch=200;
-$rsync_options="-aIL --partial";
+# Uncomment next line to specify standard rsync options with
+# additional transfer rate limit 5MiBs.
+# $rsync_options="-aIL --partial --bwlimit=5M";
# FTP/HTTP options
$passive=0;