Browse code

Clarify `cp` documentation behaviour with trailing "/."

Issue #30082 demonstrated that their is possible confusion with the "/."
where the tailing "." can appear to be merely punctuation within the
document rather than a highly pertinent part of `SRC_PATH`.

Signed-off-by: Ian Campbell <ian.campbell@docker.com>

Ian Campbell authored on 2017/01/13 22:54:44
Showing 2 changed files
... ...
@@ -75,9 +75,9 @@ argument of `DEST_PATH`, the behavior is as follows:
75 75
     - `DEST_PATH` exists and is a file
76 76
         - Error condition: cannot copy a directory to a file
77 77
     - `DEST_PATH` exists and is a directory
78
-        - `SRC_PATH` does not end with `/.`
78
+        - `SRC_PATH` does not end with `/.` (that is: _slash_ followed by _dot_)
79 79
             - the source directory is copied into this directory
80
-        - `SRC_PATH` does end with `/.`
80
+        - `SRC_PATH` does end with `/.` (that is: _slash_ followed by _dot_)
81 81
             - the *content* of the source directory is copied into this
82 82
               directory
83 83
 
... ...
@@ -42,9 +42,9 @@ argument of `DEST_PATH`, the behavior is as follows:
42 42
     - `DEST_PATH` exists and is a file
43 43
         - Error condition: cannot copy a directory to a file
44 44
     - `DEST_PATH` exists and is a directory
45
-        - `SRC_PATH` does not end with `/.`
45
+        - `SRC_PATH` does not end with `/.` (that is: _slash_ followed by _dot_)
46 46
             - the source directory is copied into this directory
47
-        - `SRC_PATH` does end with `/.`
47
+        - `SRC_PATH` does end with `/.` (that is: _slash_ followed by _dot_)
48 48
             - the *content* of the source directory is copied into this
49 49
               directory
50 50