diff --git a/docs/sources/use/builder.rst b/docs/sources/use/builder.rst index e48f3f2a48..18c52ec09f 100644 --- a/docs/sources/use/builder.rst +++ b/docs/sources/use/builder.rst @@ -221,8 +221,16 @@ destination container. All new files and directories are created with mode 0755, uid and gid 0. +.. note:: + if you build using STDIN (``docker build - < somefile``), there is no build + context, so the Dockerfile cannot contain an ADD statement. + The copy obeys the following rules: +* The ```` path must be inside the *context* of the build; you cannot + ``ADD ../something /something``, because the first step of a + ``docker build`` is to send the context directory (and subdirectories) to + the docker daemon. * If ```` is a URL and ```` does not end with a trailing slash, then a file is downloaded from the URL and copied to ````. * If ```` is a URL and ```` does end with a trailing slash,