From 64e3414e00906e6eaa72d7b63ca76d1c59ecadf6 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Fri, 25 Sep 2015 19:58:43 +0200 Subject: allow all dpkg selections to be set via apt-mark and libapt 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. --- doc/apt-mark.8.xml | 110 ++++++++++++++++++++++++++++++--------------------- doc/apt-verbatim.ent | 41 ++++++++++++++++--- 2 files changed, 99 insertions(+), 52 deletions(-) (limited to 'doc') diff --git a/doc/apt-mark.8.xml b/doc/apt-mark.8.xml index 94f24437e..8dd157a60 100644 --- a/doc/apt-mark.8.xml +++ b/doc/apt-mark.8.xml @@ -14,7 +14,7 @@ &apt-email; &apt-product; - 2012-06-09T00:00:00Z + 2015-09-25T00:00:00Z @@ -26,31 +26,37 @@ apt-mark - mark/unmark a package as being automatically-installed + show, set and unset various settings for a package &synopsis-command-apt-mark; Description - apt-mark will change whether a package has - been marked as being automatically installed. + apt-mark can be used as a unified frontend to set + various settings for a package like marking a package as being + automatically/manually installed or changing dpkg + selections such as hold, install, deinstall and purge which are respected + e.g. by apt-get dselect-upgrade or aptitude. + Automatically and manually installed packages When you request that a package is installed, and as a result other packages are installed to satisfy its dependencies, the - dependencies are marked as being automatically installed. Once - these automatically installed packages are no longer depended on - by any manually installed packages, they will be removed by e.g. - apt-get or aptitude. + dependencies are marked as being automatically installed, while + package you installed explicitely is marked as manually installed. + Once a automatically installed package is no longer depended on + by any manually installed package it is considered no longer needed + and e.g. apt-get or aptitude + will at least suggest removing them. - + auto is used to mark a package as being automatically installed, which will cause the package to be removed when no more manually installed packages depend on this package. - + manual is used to mark a @@ -58,23 +64,7 @@ package from being automatically removed if no other packages depend on it. - - - - hold is used to mark a - package as held back, which will prevent the package from being - automatically installed, upgraded or removed. - The command is only a wrapper around dpkg --set-selections - and the state is therefore maintained by &dpkg; and not affected - by the option. - - - - - unhold is used to cancel a - previously set hold on a package to allow all actions again. - - + showauto is used to print a @@ -82,38 +72,66 @@ All automatically installed packages will be listed if no package is given. If packages are given only those which are automatically installed will be shown. - + showmanual can be used in the same way as showauto except that it will print a list of manually installed packages instead. + + + + Options + + + + + + Read/Write package stats from the filename given with the parameter + &synopsis-param-filename; instead of from the default location, which + is extended_status in the directory defined + by the Configuration Item: Dir::State. + + + - - showhold is used to print a list - of packages on hold in the same way as for the other show commands. + Prevent changes for a package + + + hold is used to mark a + package as held back, which will prevent the package from being + automatically installed, upgraded or removed. - + + + unhold is used to cancel a + previously set hold on a package to allow all actions again. + + - - - - options - - - - - - - Read/Write package stats from the filename given with the parameter - &synopsis-param-filename; instead of from the default location, which - is extended_status in the directory defined - by the Configuration Item: Dir::State. + + showhold is used to print a list + of packages on hold in the same way as for the other show commands. + + + Shedule packages for install, remove and purge + + Some frontends like apt-get dselect-upgrade can be used to + apply previously sheduled changes to the install state of packages. Such changes + can be sheduled with the , + (also known as ) and commands. + Packages with a specific selection can be displayed with , + and respectively. + More information about these so called dpkg selections can be found in &dpkg;. + + + Options + &apt-commonoptions; diff --git a/doc/apt-verbatim.ent b/doc/apt-verbatim.ent index 448e6c2df..f5e322e11 100644 --- a/doc/apt-verbatim.ent +++ b/doc/apt-verbatim.ent @@ -394,18 +394,47 @@ "> apt-mark - + + + + + + auto + manual + + &synopsis-arg-pkg; + + + + showauto + showmanual + + &synopsis-pkg; + + + &synopsis-help; + +apt-mark - auto - manual - showauto - showmanual + hold + unhold + install + remove + purge &synopsis-arg-pkg; - &synopsis-help; + + + showhold + showinstall + showremove + showpurge + + &synopsis-pkg; + "> -- cgit v1.2.3