X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/8c782efd93342c6119e8ba2ff6989b7a164b7f3d..dd47e21814291e965be6da73331f28dc695ce489:/doc/apt-mark.8.xml
diff --git a/doc/apt-mark.8.xml b/doc/apt-mark.8.xml
index 94f24437e..ddde0416f 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 front-end to set
+ various settings for a package, such as 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 the
+ package you installed explicitly is marked as manually installed.
+ Once an 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.
+
+
+ Schedule Packages for Install, Remove and Purge
+
+ Some front-ends like apt-get dselect-upgrade can be used to
+ apply previously scheduled changes to the install state of packages. Such changes
+ can be scheduled 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;