a2b529ead2
--help and help are successful commands so output should not go to error.
QE teams have requested this change, also users doing docker help | less
or docker run --help | less would expect this to work.
Usage statement should only be printed when the user asks for it.
Errors should print error message and then suggest the docker COMMAND --help
command to see usage information.
The current behaviour causes the user to have to search for the error message
and sometimes scrolls right off the screen. For example a error on a
"docker run" command is very difficult to diagnose.
Finally erros should always exit with a non 0 exit code, if the user
makes a CLI error.
Docker-DCO-1.1-Signed-off-by: Dan Walsh <dwalsh@redhat.com> (github: rhatdan)
1.3 KiB
% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014
NAME
docker-commit - Create a new image from a container's changes
SYNOPSIS
docker commit [-a|--author[=AUTHOR]] [--help] [-m|--message[=MESSAGE]] [-p|--pause[=true]] CONTAINER [REPOSITORY[:TAG]]
DESCRIPTION
Using an existing container's name or ID you can create a new image.
OPTIONS
-a, --author="" Author (e.g., "John Hannibal Smith hannibal@a-team.com")
--help Print usage statement
-m, --message="" Commit message
-p, --pause=true|false Pause container during commit. The default is true.
EXAMPLES
Creating a new image from an existing container
An existing Fedora based container has had Apache installed while running in interactive mode with the bash shell. Apache is also running. To create a new image run docker ps to find the container's ID and then run:
# docker commit -m="Added Apache to Fedora base image" \
-a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20
HISTORY
April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and in June 2014, updated by Sven Dowideit SvenDowideit@home.org.au July 2014, updated by Sven Dowideit SvenDowideit@home.org.au