docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

update documentation styling as per suggestions 

Signed-off-by: Amen Belayneh <amenbelayneh@gmail.com>
This commit is contained in:
Amen Belayneh 2015-09-14 19:08:27 +08:00
parent 6a55d95334
commit 30164588d6
1 changed files with 11 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/reference/builder.md
View File

@ -295,6 +295,17 @@ any point in an image's history, much like source control.
The *exec* form makes it possible to avoid shell string munging, and to `RUN` The *exec* form makes it possible to avoid shell string munging, and to `RUN`
commands using a base image that does not contain `/bin/sh`. commands using a base image that does not contain `/bin/sh`.
In the *shell* form you can use a `\` (backslash) to continue a single
RUN instruction onto the next line. For example, consider these two lines:
```
RUN /bin/bash -c 'source $HOME/.bashrc ;\
echo $HOME'
```
Together they are equivalent to this single line:
```
RUN /bin/bash -c 'source $HOME/.bashrc ; echo $HOME'
```
> **Note**: > **Note**:
> To use a different shell, other than '/bin/sh', use the *exec* form > To use a different shell, other than '/bin/sh', use the *exec* form
> passing in the desired shell. For example, > passing in the desired shell. For example,
@ -311,12 +322,6 @@ commands using a base image that does not contain `/bin/sh`.
> If you want shell processing then either use the *shell* form or execute > If you want shell processing then either use the *shell* form or execute
> a shell directly, for example: `RUN [ "sh", "-c", "echo", "$HOME" ]`. > a shell directly, for example: `RUN [ "sh", "-c", "echo", "$HOME" ]`.
> **Note**:
> If you choose to use the *shell* form, any time you want to continue a single
> `RUN` instruction onto the next line, it has to be ended with a backslash `\`.
> For example, `RUN /bin/bash -c 'source $HOME/.bashrc ;\` then on the next
> line ` echo $HOME '`.
The cache for `RUN` instructions isn't invalidated automatically during The cache for `RUN` instructions isn't invalidated automatically during
the next build. The cache for an instruction like the next build. The cache for an instruction like
`RUN apt-get dist-upgrade -y` will be reused during the next build. The `RUN apt-get dist-upgrade -y` will be reused during the next build. The