From dacf8fa27c576512cecea4a15b9adb93808c9743 Mon Sep 17 00:00:00 2001 From: Foysal Iqbal Date: Tue, 21 Mar 2017 15:22:29 -0400 Subject: [PATCH] remove the duplicate line from doc and rebase with master for 'example of ADD and COPY with special characters file name' Signed-off-by: Foysal Iqbal --- docs/reference/builder.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/reference/builder.md b/docs/reference/builder.md index 72ad7670f6..8550b0a4f5 100644 --- a/docs/reference/builder.md +++ b/docs/reference/builder.md @@ -803,6 +803,14 @@ the source will be copied inside the destination container. ADD test relativeDir/ # adds "test" to `WORKDIR`/relativeDir/ ADD test /absoluteDir/ # adds "test" to /absoluteDir/ +When adding files or directories that contain special characters (such as `[` +and `]`), you need to escape those paths following the Golang rules to prevent +them from being treated as a matching pattern. For example, to add a file +named `arr[0].txt`, use the following; + + ADD arr[[]0].txt /mydir/ # copy a file named "arr[0].txt" to /mydir/ + + All new files and directories are created with a UID and GID of 0. In the case where `` is a remote file URL, the destination will @@ -915,6 +923,14 @@ the source will be copied inside the destination container. COPY test relativeDir/ # adds "test" to `WORKDIR`/relativeDir/ COPY test /absoluteDir/ # adds "test" to /absoluteDir/ + +When copying files or directories that contain special characters (such as `[` +and `]`), you need to escape those paths following the Golang rules to prevent +them from being treated as a matching pattern. For example, to copy a file +named `arr[0].txt`, use the following; + + COPY arr[[]0].txt /mydir/ # copy a file named "arr[0].txt" to /mydir/ + All new files and directories are created with a UID and GID of 0. > **Note**: