Bug#600057: apt: sources.list(5) does not document sources.list URI format
Package: apt
Version: 0.8.6
Severity: important
The sources.list(5) man page does not document how a deb or deb-src line
is expanded into a full URL by apt.
Also is should mention how it interacts with Packages file content so
that given a repository a user can construct a correct sources.list line
for it.
-- Package-specific info:
-- apt-config dump --
APT "";
APT::Architecture "amd64";
APT::Build-Essential "";
APT::Build-Essential:: "build-essential";
APT::Install-Recommends "1";
APT::Install-Suggests "0";
APT::Acquire "";
APT::Acquire::Translation "environment";
APT::Authentication "";
APT::Authentication::TrustCDROM "true";
APT::NeverAutoRemove "";
APT::NeverAutoRemove:: "^firmware-linux.*";
APT::NeverAutoRemove:: "^linux-firmware$";
APT::NeverAutoRemove:: "^linux-image.*";
APT::NeverAutoRemove:: "^kfreebsd-image.*";
APT::NeverAutoRemove:: "^linux-restricted-modules.*";
APT::NeverAutoRemove:: "^linux-ubuntu-modules-.*";
APT::Never-MarkAuto-Sections "";
APT::Never-MarkAuto-Sections:: "metapackages";
APT::Never-MarkAuto-Sections:: "restricted/metapackages";
APT::Never-MarkAuto-Sections:: "universe/metapackages";
APT::Never-MarkAuto-Sections:: "multiverse/metapackages";
APT::Never-MarkAuto-Sections:: "oldlibs";
APT::Never-MarkAuto-Sections:: "restricted/oldlibs";
APT::Never-MarkAuto-Sections:: "universe/oldlibs";
APT::Never-MarkAuto-Sections:: "multiverse/oldlibs";
APT::Cache-Limit "67108864";
Dir "/";
Dir::State "var/lib/apt/";
Dir::State::lists "lists/";
Dir::State::cdroms "cdroms.list";
Dir::State::mirrors "mirrors/";
Dir::State::extended_states "/var/lib/apt/extended_states";
Dir::State::status "/var/lib/dpkg/status";
Dir::Cache "var/cache/apt/";
Dir::Cache::archives "archives/";
Dir::Cache::srcpkgcache "srcpkgcache.bin";
Dir::Cache::pkgcache "pkgcache.bin";
Dir::Etc "etc/apt/";
Dir::Etc::sourcelist "sources.list";
Dir::Etc::sourceparts "sources.list.d";
Dir::Etc::vendorlist "vendors.list";
Dir::Etc::vendorparts "vendors.list.d";
Dir::Etc::main "apt.conf";
Dir::Etc::netrc "auth.conf";
Dir::Etc::parts "apt.conf.d";
Dir::Etc::preferences "preferences";
Dir::Etc::preferencesparts "preferences.d";
Dir::Etc::trusted "trusted.gpg";
Dir::Etc::trustedparts "trusted.gpg.d";
Dir::Bin "";
Dir::Bin::methods "/usr/lib/apt/methods";
Dir::Bin::dpkg "/usr/bin/dpkg";
Dir::Media "";
Dir::Media::MountPath "/media/apt";
Dir::Log "var/log/apt";
Dir::Log::Terminal "term.log";
Dir::Log::History "history.log";
Dir::Ignore-Files-Silently "";
Dir::Ignore-Files-Silently:: "~$";
Dir::Ignore-Files-Silently:: "\.disabled$";
Dir::Ignore-Files-Silently:: "\.bak$";
Dir::Ignore-Files-Silently:: "\.dpkg-[a-z]+$";
DPkg "";
DPkg::Pre-Install-Pkgs "";
DPkg::Pre-Install-Pkgs:: "/usr/sbin/dpkg-preconfigure --apt || true";
CommandLine "";
CommandLine::AsString "apt-config dump";
-- /etc/apt/preferences --
Package: *
Pin: release a=stable
Pin-Priority: 900
Package: *
Pin: release a=lenny
Pin-Priority: 900
Package: *
Pin: release a=lenny-backports
Pin-Priority: 800
Package: *
Pin: release a=testing
Pin-Priority: 700
Package: *
Pin: release a=squeeze
Pin-Priority: 700
Package: *
Pin: release a=experimental
Pin-Priority: 200
Package: *
Pin: release a=etch
Pin-Priority: 105
-- /etc/apt/sources.list --
deb http://debian.sh.cvut.cz/debian lenny main contrib non-free
deb-src http://debian.sh.cvut.cz/debian lenny main contrib non-free
deb http://backports.debian.org/debian-backports lenny-backports main contrib non-free
#deb-src http://www.backports.org/debian-backports lenny-backports main contrib non-free
deb http://debian.sh.cvut.cz/debian-security lenny/updates main contrib non-free
deb-src http://debian.sh.cvut.cz/debian-security lenny/updates main contrib non-free
deb http://debian.sh.cvut.cz/debian-security squeeze/updates main contrib non-free
deb-src http://debian.sh.cvut.cz/debian-security squeeze/updates main contrib non-free
deb http://debian.sh.cvut.cz/debian-multimedia sid main non-free
deb-src http://debian.sh.cvut.cz/debian-multimedia sid main non-free
deb http://debian.sh.cvut.cz/debian-multimedia squeeze main non-free
deb-src http://debian.sh.cvut.cz/debian-multimedia squeeze main non-free
deb http://debian.sh.cvut.cz/debian-multimedia lenny main non-free
deb-src http://debian.sh.cvut.cz/debian-multimedia lenny main non-free
deb http://debian.sh.cvut.cz/debian-volatile lenny/volatile main contrib non-free
deb-src http://debian.sh.cvut.cz/debian-volatile lenny/volatile main contrib non-free
deb http://debian.sh.cvut.cz/debian squeeze main contrib non-free
deb-src http://debian.sh.cvut.cz/debian squeeze main contrib non-free
deb http://debian.sh.cvut.cz/debian unstable main contrib non-free
deb-src http://debian.sh.cvut.cz/debian unstable main contrib non-free
deb http://debian.sh.cvut.cz/debian experimental main contrib non-free
deb-src http://debian.sh.cvut.cz/debian experimental main contrib
#deb http://www.lamaresh.net/apt lenny main
#deb-src http://www.lamaresh.net/apt lenny main
#deb http://www.lamaresh.net/apt squeeze main
#deb-src http://www.lamaresh.net/apt squeeze main
#deb http://www.lamaresh.net/apt sid main
#deb-src http://www.lamaresh.net/apt sid main
deb http://ppa.launchpad.net/ubuntu-wine/ppa/ubuntu lucid main
deb-src http://ppa.launchpad.net/ubuntu-wine/ppa/ubuntu lucid main
deb http://mozilla.debian.net/packages/ ./
deb-src http://mozilla.debian.net/packages/ ./
-- System Information:
Debian Release: squeeze/sid
APT prefers stable
APT policy: (900, 'stable'), (700, 'testing'), (500, 'unstable'), (200, 'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 2.6.36-rc6-r600fence-smbinit-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_US.UTF-8)
Shell: /bin/sh linked to /bin/bash
Versions of packages apt depends on:
ii debian-archive-keyring 2010.08.28~lenny1 GnuPG archive keys of the Debian a
ii gnupg 1.4.9-3+lenny1 GNU privacy guard - a free PGP rep
ii libc6 2.11.2-6 Embedded GNU C Library: Shared lib
ii libgcc1 1:4.4.5-2 GCC support library
ii libstdc++6 4.4.5-2 The GNU Standard C++ Library v3
ii zlib1g 1:1.2.3.4.dfsg-3 compression library - runtime
apt recommends no packages.
Versions of packages apt suggests:
ii apt-doc 0.8.6 Documentation for APT
ii aptitude 0.6.3-3.1 terminal-based package manager (te
ii bzip2 1.0.5-1+lenny1 high-quality block-sorting file co
ii dpkg-dev 1.15.8.5 Debian package development tools
ii lzma 4.43-14 Compression method of 7z format in
pn python-apt <none> (no description available)
-- no debconf information
Reply to: