summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* support arch:all data e.g. in separate Packages fileDavid Kalnischkies2015-11-041-4/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Based on a discussion with Niels Thykier who asked for Contents-all this implements apt trying for all architecture dependent files to get a file for the architecture all, which is treated internally now as an official architecture which is always around (like native). This way arch:all data can be shared instead of duplicated for each architecture requiring the user to download the same information again and again. There is one problem however: In Debian there is already a binary-all/ Packages file, but the binary-any files still include arch:all packages, so that downloading this file now would be a waste of time, bandwidth and diskspace. We therefore need a way to decide if it makes sense to download the all file for Packages in Debian or not. The obvious answer would be a special flag in the Release file indicating this, which would need to default to 'no' and every reasonable repository would override it to 'yes' in a few years time, but the flag would be there "forever". Looking closer at a Release file we see the field "Architectures", which doesn't include 'all' at the moment. With the idea outlined above that 'all' is a "proper" architecture now, we interpret this field as being authoritative in declaring which architectures are supported by this repository. If it says 'all', apt will try to get all, if not it will be skipped. This gives us another interesting feature: If I configure a source to download armel and mips, but it declares it supports only armel apt will now print a notice saying as much. Previously this was a very cryptic failure. If on the other hand the repository supports mips, too, but for some reason doesn't ship mips packages at the moment, this 'missing' file is silently ignored (= that is the same as the repository including an empty file). The Architectures field isn't mandatory through, so if it isn't there, we assume that every architecture is supported by this repository, which skips the arch:all if not listed in the release file.
* revamp all tools help messagesDavid Kalnischkies2015-11-0410-22/+106
| | | | | | | | | | | | | | | | The general idea is: A small paragraph on the tool itself as a description, a list of the most used (!= all) commands available in the tool, a remark where to find more information on the tool and its commands (aka: in the manpage) and finally a common block referring to even more manpages. In exchange options are completely omitted from the output as well as deprecated or obscure commands. (Better) Information about them is available in the manpages anyway and the few options which were listed before were also the least interesting ones (-o -c -q and co are hardly of interest for someone totally new looking to find info by asking for help and anyone with a bit of experience doesn't need this short list. Those would need a list of options applying to the command they call, but they are too numerous and command specific to list them sanely in this context.
* split up help messages for simpler reuseDavid Kalnischkies2015-11-049-1795/+4836
| | | | | | | | | | | | | That is one huge commit with busy work only: Help messages used to be one big translateable string, which is a pain for translators and hard to reuse for us. This change there 'explodes' this single string into new string for each documented string trying hard to split up the translated messages as well. This actually restores many translations as previously adding a single command made all of the bug message fuzzy. The splitup also highlighted that its easy to forget a line, duplicate one and similar stuff. Git-Dch: Ignore
* revamp apt(8) to refer more instead of duplicatingDavid Kalnischkies2015-11-042-111/+114
| | | | | | As apt is targetted at users, lets try to make apt(8) for users as well by giving only a quick overview about what is available and some pointers for how to find a whole lot more details.
* add binary-specific options via Binary scopeDavid Kalnischkies2015-11-041-0/+20
| | | | | | Especially with apt now, it can be useful to set an option only for apt and not for apt-get. Using a binary-specific subtree which is merged into the root seems like a simple enough trick to achieve this.
* refer to apt-secure(8) in unsecure repositories warningDavid Kalnischkies2015-11-042-38/+64
| | | | | | The manpage is also slightly updated to work better as a central hub to push people from all angles into the right directions without writting a book disguised as an error message.
* revert accidental removal of documentation for trusted option in sources.listDavid Kalnischkies2015-11-041-0/+14
| | | | | | | | In b0d408547734100bf86781615f546487ecf390d9 I accidently removed the documentation for Trusted and replaced it with Signed-By instead of adding it. Git-Dch: Ignore
* allow all dpkg selections to be set via apt-mark and libaptDavid Kalnischkies2015-11-042-52/+99
| | | | | | As we have support for 'hold', we need support for undoing a hold which in effect means that we implemented most other states as well, just that they weren't exposed in the interface directly so far.
* releasing 1.1~exp141.1_exp14Michael Vogt2015-10-2010-11/+11
|
* Run "./prepare-release pre-export"Michael Vogt2015-10-0510-8010/+8439
| | | | Git-dch: ignore
* Use --add-location=file for po/ and doc/poMichael Vogt2015-09-221-0/+4
| | | | | | | This avoids churn in the po/pot files when just the location line number in the source code changes. Git-Dch: ignore
* add by-hash sources.list option and document all of by-hashDavid Kalnischkies2015-09-143-0/+29
| | | | | | | | | | | | This changes the semantics of the option (which is renamed too) to be a yes/no value with the special additional value "force" as this allows by-hash to be disabled even if the repository indicates it would be supported and is more in line with our other yes/no options like pdiff which disable themselves if no support can be detected. The feature wasn't documented so far and hasn't reached a (un)stable release yet, so changing it without trying too hard to keep compatibility seems okay.
* add --sha512 option + documentation for apt-ftparchiveDavid Kalnischkies2015-09-141-4/+8
|
* add Source-Version field for EDSPDavid Kalnischkies2015-09-141-0/+6
| | | | | | The syntax of "Source" is different in EDSP compared to the the field of the same name in 'the rest' of Debian, so documented this accordingly and send the version as a new field.
* Sort pot input filesMichael Vogt2015-09-121-1/+1
| | | | Git-Dch: ignore
* releasing package apt version 1.1~exp12Michael Vogt2015-09-1110-1495/+1651
|
* fix valid-until-min typo in sources.list(5)David Kalnischkies2015-08-311-1/+1
| | | | Git-Dch: Ignore
* implement $(NATIVE_ARCHITECTURE) substvar for indextargetsDavid Kalnischkies2015-08-301-0/+3
|
* implement indextargets option 'DefaultEnabled'David Kalnischkies2015-08-291-24/+61
| | | | | | | | | | | Some targets like Contents-udeb are special-needs targets. Shipping the configuration snippet for them is okay, but they shouldn't be downloaded by default. Forcing the user to enable targets by uncommenting targets is wrong and this would still not really solve the problem completely as even if you want to download some -udebs it will probably not be for all sources you have enabled, so having the possibility of disabling a target by default, but giving the user the option to enable it on a per-source entry basis is better.
* implement PDiff patching for compressed filesDavid Kalnischkies2015-08-281-6/+21
| | | | | | | | | | | | | | | | | | Some additional files like 'Contents' are very big and should therefore kept compressed on the disk, which apt-file did in the past. It also implemented pdiff patching of these files by un- and recompressing these files on-the-fly, with this commit we can do the same – but we can do this in both pdiff patching styles (client and server merging) and secured by hashes. Hashes are in so far slightly complicated as we can't compare the hashes of the compressed files as we might compress them differently than the server would (different compressor versions, options, …), so we must compare the hashes of the uncompressed content. While this commit has changes in public headers, the classes it changes are marked as hidden, so nobody can use them directly, which means the ABI break is internal only.
* auto-prefix $(SITE) for indextargets Description fieldDavid Kalnischkies2015-08-271-10/+10
| | | | | | | | This updates the documentation for a change which actually happened in c2a4a8dded2dfb56dbcab9689b6cb4b96c9999b6 already. The acquire system expects the $(SITE) to be there (e.g. for mirror rewriting) so we are better of prefixing it automatically than giving frontends the chance to forget it. There is no point in not showing $(SITE) first anyway.
* sources.list and indextargets option for pdiffsDavid Kalnischkies2015-08-273-3/+27
| | | | | | | Disabling pdiffs can be useful occasionally, like if you have a fast local mirror where the download doesn't matter, but still want to use it for non-local mirrors. Also, some users might prefer it to only use it for very big indextargets like Contents.
* Release 1.11~exp111.1.exp11Julian Andres Klode2015-08-2710-458/+533
|
* allow explicit dis/enable of IndexTargets in sources optionsDavid Kalnischkies2015-08-271-0/+3
| | | | | | | While Target{,-Add,-Remove} is available for configuring IndexTargets already, allow Targets to be mentioned explicitely as yes/no options as well, so that the Target 'Contents' can be disabled via 'Contents: no' as well as 'Target-Remove: Contents'.
* fix various typos reported by codespellDavid Kalnischkies2015-08-272-2/+2
| | | | Reported-By: codespell
* releasing package apt version 1.1~exp10Michael Vogt2015-08-2410-5321/+11315
|
* Fix typoMichael Vogt2015-08-241-1/+1
| | | | | Thanks: Julian Andres Klode Git-Dch: ignore
* doc/apt.conf.5.xml: document Acquire::EnableSrvRecodsMichael Vogt2015-08-211-0/+9
| | | | Git-Dch: ignore
* Add support for "apt-cache showsrc --only-source srcpkgname"Michael Vogt2015-08-181-3/+6
| | | | | Thanks: Steve Slangasek for the suggestion Closes: 695633
* Document the general effect of the comma operatorJulian Andres Klode2015-08-151-0/+5
| | | | Closes: #574939
* doc/files.dbk: Improve documentation for {src,}pkgcache.binJulian Andres Klode2015-08-141-3/+3
| | | | | | This should be enough for most persons. Closes: #465551
* apt-cache(8): Drop the #versions >= #package names comparisonJulian Andres Klode2015-08-141-2/+1
| | | | Closes: #691281
* apt: Add autoremove and auto-remove commandsJulian Andres Klode2015-08-141-0/+5
|
* Make auto-remove and auto-clean aliases for the versions without -Julian Andres Klode2015-08-141-2/+2
| | | | | | | | Some people type them instead of autoremove and autoclean, so make them happy. Closes: #274159 Makes-Happy: Ansgar
* apt_preferences(5): Mention overlapping of pin matchesJulian Andres Klode2015-08-141-0/+3
|
* apt_preferences(5): Correct default pin assignment documentationJulian Andres Klode2015-08-141-2/+2
| | | | | | | This was broken, as higher pins were also assigned to versions that are installed. Closes: #623706
* apt-cache(8): Mention that --names-only search providesJulian Andres Klode2015-08-141-2/+2
| | | | Closes: #618017
* Mention that source order only matter per versionJulian Andres Klode2015-08-141-1/+1
| | | | Closes: #617445
* Replace --force-yes by various options starting with --allowJulian Andres Klode2015-08-141-1/+25
| | | | This enables more fine grained control over such exceptions.
* Merge branch 'debian/experimental' of https://github.com/DonKult/apt into ↵Julian Andres Klode2015-08-1412-38/+55
|\ | | | | | | debian/experimental
| * use a=experimental instead n=experimental in pin documentationJohannes Schauer2015-08-1210-17/+17
| | | | | | | | Closes: 783343
| * Do not set unhonored DPKG_NO_TSTP variable for dpkgGuillem Jover2015-08-121-9/+1
| | | | | | | | | | | | | | Support for that variable was removed in dpkg in 1.15.6, in commit 6f037003e8b96878b485efb7cbd1f846e3bf4e97. Closes: #765366
| * document VERSION 2 (and 3) pre-install-pkgs hook interfaceJonathan Nieder2015-08-121-4/+28
| | | | | | | | | | | | | | [Commiter: Patch adapted to apply to current version of the manpage and added/moved a few words about Version 3 to make it fit better] Closes: 627188
| * remove Dir:: scope limit of RootDir in the documentationDavid Kalnischkies2015-08-121-1/+2
| | | | | | | | | | | | | | RootDir doesn't only effect Dir-scope but all FindDir directories, so document it accordingly. Closes: 659387
| * po-fixups: fill Project-Id-Version and Encoding correctlyGuillem Jover2015-08-127-7/+7
| | | | | | | | Closes: 612996
* | Accept --upgradeable as synonym for --upgradableJulian Andres Klode2015-08-1310-13/+15
| | | | | | | | | | | | It's a tiny diff, so why not? But no need to document it. Closes: #787846
* | apt_preferences(5): Re-document how priorities are calculatedJulian Andres Klode2015-08-121-5/+8
| | | | | | | | | | | | | | The old text did not match either the old or the new implementation, so let's rewrite it to explain the new implementation. Closes: #554773
* | policy: Be more strict about parsing pin files, and document prio 0Julian Andres Klode2015-08-121-0/+4
|/ | | | | | Treat invalid pin priorities and overflows as an error. Closes: #429912
* hide implicit deps in apt-cache again by defaultDavid Kalnischkies2015-08-101-2/+13
| | | | | | | | | | | | | | Before MultiArch implicits weren't a thing, so they were hidden by default by definition. Adding them for MultiArch solved many problems, but having no reliable way of detecting which dependency (and provides) is implicit or not causes problems everytime we want to output dependencies without confusing our observers with unneeded implementation details. The really notworthy point here is actually that we keep now a better record of how a dependency came to be so that we can later reason about it more easily, but that is hidden so deep down in the library internals that change is more the problems it solves than the change itself.
* rename 'apt-get files' to 'apt-get indextargets'David Kalnischkies2015-08-103-21/+23
| | | | | | | | '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.