summaryrefslogtreecommitdiff
path: root/doc/apt-get.8.xml
AgeCommit message (Collapse)Author
2015-08-10rename 'apt-get files' to 'apt-get indextargets'David Kalnischkies
'files' is a bit too generic as a name for a command usually only used programmatically (if at all) by developers, so instead of "wasting" this generic name for this we use "indextargets" which is actually the name of the datastructure the displayed data is stored in. Along with this rename the config options are renamed accordingly.
2015-08-10add sources.list Check-Valid-Until and Valid-Until-{Max,Min} optionsDavid Kalnischkies
These options could be set via configuration before, but the connection to the actual sources is so strong that they should really be set in the sources.list instead – especially as this can be done a lot more specific rather than e.g. disabling Valid-Until for all sources at once. Valid-Until-* names are chosen instead of the Min/Max-ValidTime as this seems like a better name and their use in the wild is probably low enough that this isn't going to confuse anyone if we have to names for the same thing in different areas. In the longrun, the config options should be removed, but for now documentation hinting at the new options is good enough as these are the kind of options you set once across many systems with different apt versions, so the new way should work everywhere first before we deprecate the old way.
2015-06-15provide a public interface for acquiring changelogsDavid Kalnischkies
Provided is a specialized acquire item which given a version can figure out the correct URI to try by itself and if not provides an error message alongside with static methods to get just the URI it would try to download if it should just be displayed or similar such. The URI is constructed as follows: Release files can provide an URI template in the "Changelogs" field, otherwise we lookup a configuration item based on the "Label" or "Origin" of the Release file to get a (hopefully known) default value for now. This template should contain the string CHANGEPATH which is replaced with the information about the version we want the changelog for (e.g. main/a/apt/apt_1.1). This middleway was choosen as this path part was consistent over the three known implementations (+1 defunct), while the rest of the URI varies widely between them. The benefit of this construct is that it is now easy to get changelogs for Debian packages on Ubuntu and vice versa – even at the moment where the Changelogs field is present nowhere. Strictly better than what apt-get had before as it would even fail to get changelogs from security… Now it will notice that security identifies as Origin: Debian and pick this setting (assuming again that no Changelogs field exists). If on the other hand security would ship its changelogs in a different location we could set it via the Label option overruling Origin. Closes: 687147, 739854, 784027, 787190
2015-06-11implement 'apt-get files' to access index targetsDavid Kalnischkies
Downloading additional files is only half the job. We still need a way to allow external tools to know where the files are they requested for download given that we don't want them to choose their own location. 'apt-get files' is our answer to this showing by default in a deb822 format information about each IndexTarget with the potential to filter the records based on lines and an option to change the output format. The command serves also as an example on how to get to this information via libapt.
2014-10-13Document ↵Michael Vogt
Acquire{MaxReleaseFileSize,AllowInsecureRepositories,AllowDowngradeToInsecureRepositories} and --no-allow-insecure-repositories Document the new options to restrict loading unauthenticated data into our parsers.
2014-08-26ensure that all docs use all entities filesDavid Kalnischkies
Not all are needed for all files at the moment, but the new docbook building hadn't available some of the entities it used as the files weren't correctly copied around in all cases and having the same across the bord makes working with all of them a little easier. Git-Dch: Ignore
2014-04-22Consistently use Dpkg::Progress* in documentationJames McCoy
Closes: 745452
2014-03-13support DEB_BUILD_PROFILES and -P for build profilesDavid Kalnischkies
Inspired by the rest of the patch in 661537, but abstract the parsing of various ways of setting the build profiles more so it can potentially be reused and all apt parts have the same behaviour. Especially config options, cmdline options and environment will not be combined as proposed as this isn't APTs usual behaviour and dpkg doesn't do it either, so one overrides the other as it normally does.
2014-02-14do not recommend dselect in apt-get manpageDavid Kalnischkies
The current description says: "Many users find dselect intimidating and new users may prefer to use apt-based user interfaces." It doesn't feel right to refer users to it then. Closes: 617625
2013-12-05* document Dpkg::Progress-Fancy (closes: 726169), thanks to James McCoyMichael Vogt
2013-11-30add a vendor specific file to have configurable entitiesDavid Kalnischkies
manpages sometimes refer to distro-specific things like the name of the package providing the achive-keyring. Having a central place to configure this helps in having it consistent in the manpages and allows to load this info from other places in the buildsystem as well later.
2013-10-08Merge remote-tracking branch 'mvo/feature/upgrade-with-new' into debian/sidMichael Vogt
2013-10-01rename "--dpkg-progress" to "--show-progress" and document it in apt-get.8Michael Vogt
2013-08-28add man-page, improve option, use --with-new-pkgs as the flagMichael Vogt
2012-06-09updating <date> tags and the po files for the manpagesDavid Kalnischkies
2012-06-02* doc/apt-get.8.xml:Justin B Rye
- review and fix spelling issues
2012-05-29* doc/apt-get.8.xml:David Kalnischkies
- use apt-utils as package example instead of libc6
2012-05-29Reword: "So, <literal>dist-upgrade</literal> command may remove some packages."Justin B Rye
to "The <literal>dist-upgrade</literal> command may therefore remove some packages."
2012-05-29* doc/apt-get.8.xml:Justin B Rye
- move dselect-upgrade below dist-upgrade
2012-05-24* doc/*.xml:Justin B Rye
- remove 'GNU/Linux' from 'Debian systems' strings as Debian has more systems than just GNU/Linux nowadays
2012-05-23use docbook DTD 4.5 instead of 4.2 to have valid docsDavid Kalnischkies
2012-05-21add also <refentryinfo> to the list of unstranslated tags for po4aDavid Kalnischkies
2012-05-21auto-generate the correct <date> translationDavid Kalnischkies
2012-05-21in <term> mark all options with <option> and mark <term><option>David Kalnischkies
as untranslated for po4a removing ~200 unless "translateable" strings
2012-05-20* doc/*.xml:David Kalnischkies
- add a few translator notes and reword some paragraphs to ensure that translators and users alike can better understand them (Closes: #669409)
2012-04-05* doc/*:David Kalnischkies
- move the command synopsis out of each manpage into apt-verbatim.ent as they are a hell to translate and just single out the parameters which can be translated to apt.ent
2012-04-04[ Bogdan Purcareata ]Bogdan Purcareata
* doc/apt-get.8.xml: - add 'download' to the usage line (Closes: #649340)
2012-03-22* doc/apt-get.8.xml:Mike Erickson
- typofix: respect → respecting, thanks Mike Erickson! (Closes: #664833)
2011-12-19merged from debian-sidMichael Vogt
2011-11-20* German manpage translation updateChris Leick
* doc/*.xml: - find and fix a bunch of misspellings
2011-10-30merge with my debian-sid branchDavid Kalnischkies
2011-09-14* doc/apt-get.8.xml:David Kalnischkies
- change wording of autoremove description as suggested by Robert Simmons, thanks! (Closes: #641490)
2011-07-28* merged latest fixes from debian-sidMichael Vogt
* apt-pkg/contrib/sha1.cc: - fix illegally casts of on-stack buffer to a type requiring more alignment than it has resulting in segfaults on sparc (Closes: #634696) * apt-pkg/contrib/cdromutl.cc: - fix escape problem when looking for the mounted devices * apt-pkg/contrib/strutl.{h,cc}, test/libapt/strutil_test.cc: - add new DeEscapeString() similar to DeQuoteString but unescape character escapes like \0XX and \xXX (plus added test) * refresh po/* * cmdline/apt-get.cc: - fix missing download progress in apt-get download - do not require unused partial dirs in 'source' (Closes: #633510) - buildconflicts effect all architectures - implement MultiarchCross for build-dep and source (Closes: #632221) * cmdline/apt-key: - use a tmpfile instead of /etc/apt/secring.gpg (Closes: #632596) * debian/apt.postinst: - remove /etc/apt/secring.gpg if it is an empty file * doc/apt-cache.8.xml: - apply madison typofix from John Feuerstein, thanks! (Closes: #633455) * apt-pkg/policy.cc: - emit an error on unknown APT::Default-Release value (Closes: #407511) * apt-pkg/aptconfiguration.cc: - ensure that native architecture is if not specified otherwise the first architecture in the Architectures vector * apt-pkg/deb/deblistparser.cc: - Strip only :any and :native if MultiArch should be stripped as it is save to ignore them in non-MultiArch contexts but if the dependency is a specific architecture (and not the native) do not strip
2011-07-25implement MultiarchCross for build-dep and source (Closes: #632221)David Kalnischkies
2011-07-14* cmdline/apt-get.cc:David Kalnischkies
- add an --assume-no option for testing to say 'no' to everything
2011-06-28various typo and syntax corrections in doc/*.xmlMichael Vogt
2011-02-09* cmdline/apt-get.cc:David Kalnischkies
- add --install-suggests option (Closes: #473089)
2011-02-03merge 'after squeeze release'-stuffDavid Kalnischkies
[ David Kalnischkies ] * apt-pkg/depcache.cc: - add SetCandidateRelease() to set a candidate version and the candidates of dependencies if needed to a specified release (Closes: #572709) * cmdline/apt-get.cc: - if --print-uris is used don't setup downloader as we don't need progress, lock nor the directories it would create otherwise - show dependencies of essential packages which are going to remove only if they cause the remove of this essential (Closes: #601961) - keep not installed garbage packages uninstalled instead of showing in the autoremove section and installing those (Closes: #604222) - change pkg/release behavior to use the new SetCandidateRelease so installing packages from experimental or backports is easier - really do not show packages in the extra section if they were requested on the commandline, e.g. with a modifier (Closes: #184730) * debian/control: - add Vcs-Browser now that loggerhead works again (Closes: #511168) - depend on debhelper 7 to raise compat level - depend on dpkg-dev (>= 1.15.8) to have c++ symbol mangling * apt-pkg/contrib/fileutl.cc: - add a RealFileExists method and check that your configuration files are real files to avoid endless loops if not (Closes: #604401) - ignore non-regular files in GetListOfFilesInDir (Closes: #594694) * apt-pkg/contrib/weakptr.h: - include stddefs.h to fix compile error (undefined NULL) with gcc-4.6 * methods/https.cc: - fix CURLOPT_SSL_VERIFYHOST by really passing 2 to it if enabled * deb/dpkgpm.cc: - fix popen/fclose mismatch reported by cppcheck. Thanks to Petter Reinholdtsen for report and patch! (Closes: #607803) * doc/apt.conf.5.xml: - fix multipl{y,e} spelling error reported by Jakub Wilk (Closes: #607636) * apt-inst/contrib/extracttar.cc: - let apt-utils work with encoded tar headers if uid/gid are large. Thanks to Nobuhiro Hayashi for the patch! (Closes: #330162) * apt-pkg/cacheiterator.h: - do not segfault if cache is not build (Closes: #254770) * doc/apt-get.8.xml: - remove duplicated mentioning of --install-recommends * doc/sources.list.5.xml: - remove obsolete references to non-us (Closes: #594495) * debian/rules: - use -- instead of deprecated -u for dh_gencontrol - remove shlibs.local creation and usage - show differences in the symbol files, but never fail * pre-build.sh: - remove as it is not needed for a working 'bzr bd' * debian/{apt,apt-utils}.symbols: - ship experimental unmangled c++ symbol files * methods/rred.cc: - operate optional on gzip compressed pdiffs * apt-pkg/acquire-item.cc: - don't uncompress downloaded pdiff files before feeding it to rred - try downloading clearsigned InRelease before trying Release.gpg - change the internal handling of Extensions in pkgAcqIndex - add a special uncompressed compression type to prefer those files - download and use i18n/Index to choose which Translations to download * cmdline/apt-key: - don't set trustdb-name as non-root so 'list' and 'finger' can be used without being root (Closes: #393005, #592107) * apt-pkg/deb/deblistparser.cc: - rewrite LoadReleaseInfo to cope with clearsigned Releasefiles * ftparchive/writer.cc: - add config option to search for more patterns in release command - include Index files by default in the Release file * methods/{gzip,bzip}.cc: - print a good error message if FileSize() is zero * apt-pkg/aptconfiguration.cc: - remove the inbuilt Translation files whitelist
2011-01-13* doc/apt-get.8.xml:David Kalnischkies
- remove duplicated mentioning of --install-recommends
2010-11-18merged from apt-get-downloadMichael Vogt
2010-11-18doc/apt-get.8.xml: document downloadMichael Vogt
2010-11-18merged from apt-get-changelogMichael Vogt
2010-11-18doc/apt-get.8.xml: document based on the work from Martin Pitt (thanks!)Michael Vogt
2010-10-14* doc/apt.ent:David Kalnischkies
- move some strings into apt-verbatim.ent to avoid showing them in apt-doc.pot as they are untranslatable anyway (e.g. manpage references)
2010-05-24remove the gnome-apt reference as it is removed from unstableDavid Kalnischkies
2010-05-24* doc/apt-get.8.xml:David Kalnischkies
- do not say explicit target_release_{name,version,codename}, it should be clear by itself and 'man' can break lines again (Closes: #566166)
2010-03-12* cmdline/apt-get.cc:David Kalnischkies
- add a --only-upgrade flag to install command (Closes: #572259) That is NOT what is requested in e.g. #74067 - this is a very simple flag which behaves orthogonal to --no-upgrade not a full-blown upgrade option for a single package instead of the whole package set.
2009-12-12fix to other oddities observed by Chris Leick while translatingDavid Kalnischkies
in doc/apt-get.8.xml, namely: - change equivalent "for" to "to the" (purge command) - clarify --fix-broken sentence about specifying packages
2009-10-29correct various errors, typos and oddities in the manpagesDavid Kalnischkies
Patch by Chris Leick which closes his on bug. Thanks! * doc/ various manpages: - correct various errors, typos and oddities (Closes: #552535) * doc/apt-secure.8.xml: - replace literal with emphasis tags in Archive configuration
2009-09-26Fix typobubulle@debian.org