summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTomSweeneyRedHat <tsweeney@redhat.com>2019-03-05 09:39:11 -0500
committerTomSweeneyRedHat <tsweeney@redhat.com>2019-03-14 18:09:23 -0400
commita220473698dfc8a74606690a4e28fcb0fa18babf (patch)
tree479165e1d9dfa2d0756de49f3df97da325cf7962
parent31f11a8a9bddc4dcfc22463097b852fcdc9f0172 (diff)
downloadpodman-a220473698dfc8a74606690a4e28fcb0fa18babf.tar.gz
podman-a220473698dfc8a74606690a4e28fcb0fa18babf.tar.bz2
podman-a220473698dfc8a74606690a4e28fcb0fa18babf.zip
Update pull and pull-always in bud man page
Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com> Update the `--pull` and `--pull-always` documentation in the build command to clarify what each does. Fixes: https://github.com/containers/buildah/issues/1381 Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>
-rw-r--r--docs/podman-build.1.md14
1 files changed, 11 insertions, 3 deletions
diff --git a/docs/podman-build.1.md b/docs/podman-build.1.md
index 3d51a5319..845103ca1 100644
--- a/docs/podman-build.1.md
+++ b/docs/podman-build.1.md
@@ -288,13 +288,21 @@ process.
**--pull**
-Pull the image if it is not present. If this flag is disabled (with
-*--pull=false*) and the image is not present, the image will not be pulled.
+When the flag is enabled, attempt to pull the latest image from the registries
+listed in registries.conf if a local image does not exist or the image is newer
+than the one in storage. Raise an error if the image is not in any listed
+registry and is not present locally.
+
+If the flag is disabled (with *--pull=false*), do not pull the image from the
+registry, use only the local version. Raise an error if the image is not
+present locally.
+
Defaults to *true*.
**--pull-always**
-Pull the image even if a version of the image is already present.
+Pull the image from the first registry it is found in as listed in registries.conf.
+Raise an error if not found in the registries, even if the image is present locally.
**--quiet, -q**