From 2ba9601ef13204119bf37a1174673eee4305a702 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Filip=20Jare=C5=A1?= Date: Fri, 12 Oct 2018 10:07:33 +0200 Subject: [PATCH] Improve `docker image rm` documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The `docker image rm` command can be used not only to remove images but also remove tags. This update improves the documentation to make this clear. Signed-off-by: Filip Jareš --- man/src/image/rm.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/man/src/image/rm.md b/man/src/image/rm.md index 348d45402e..e06a9387ac 100644 --- a/man/src/image/rm.md +++ b/man/src/image/rm.md @@ -1,6 +1,11 @@ -Removes one or more images from the host node. This does not remove images from -a registry. You cannot remove an image of a running container unless you use the -**-f** option. To see all images on a host use the **docker image ls** command. +Removes (and un-tags) one or more images from the host node. If an image has +multiple tags, using this command with the tag as a parameter only removes the +tag. If the tag is the only one for the image, both the image and the tag are +removed. + +This does not remove images from a registry. You cannot remove an image of a +running container unless you use the **-f** option. To see all images on a host +use the **docker image ls** command. # EXAMPLES