summaryrefslogtreecommitdiff
path: root/docs/reference/commandline/build.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/reference/commandline/build.md')
-rw-r--r--docs/reference/commandline/build.md10
1 files changed, 6 insertions, 4 deletions
diff --git a/docs/reference/commandline/build.md b/docs/reference/commandline/build.md
index 42c3ecf65f..b141e7422e 100644
--- a/docs/reference/commandline/build.md
+++ b/docs/reference/commandline/build.md
@@ -58,6 +58,8 @@ Options:
--ulimit value Ulimit options (default [])
```
+## Description
+
Builds Docker images from a Dockerfile and a "context". A build's context is
the files located in the specified `PATH` or `URL`. The build process can refer
to any of the files in the context. For example, your build can use an
@@ -285,7 +287,7 @@ $ docker build - < context.tar.gz
This will build an image for a compressed context read from `STDIN`. Supported
formats are: bzip2, gzip and xz.
-### Usage of .dockerignore
+### Use a .dockerignore file
```bash
$ docker build .
@@ -315,7 +317,7 @@ directory from the context. Its effect can be seen in the changed size of the
uploaded context. The builder reference contains detailed information on
[creating a .dockerignore file](../builder.md#dockerignore-file)
-### Tag image (-t)
+### Tag an image (-t)
```bash
$ docker build -t vieux/apache:2.0 .
@@ -334,7 +336,7 @@ For example, to tag an image both as `whenry/fedora-jboss:latest` and
```bash
$ docker build -t whenry/fedora-jboss:latest -t whenry/fedora-jboss:v2.1 .
```
-### Specify Dockerfile (-f)
+### Specify a Dockerfile (-f)
```bash
$ docker build -f Dockerfile.debug .
@@ -373,7 +375,7 @@ the command line.
> repeatable builds on remote Docker hosts. This is also the reason why
> `ADD ../file` will not work.
-### Optional parent cgroup (--cgroup-parent)
+### Use a custom parent cgroup (--cgroup-parent)
When `docker build` is run with the `--cgroup-parent` option the containers
used in the build will be run with the [corresponding `docker run`