Documenting ENTRYPOINT can empty value of CMD

Signed-off-by: Brandon Mitchell <git@bmitch.net>
docker · Nov 17, 2018 · cc316fd · cc316fd
1 parent f7ea8e8
commit cc316fd
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/reference/builder.md b/docs/reference/builder.md
@@ -1339,6 +1339,10 @@ The table below shows what command is executed for different `ENTRYPOINT` / `CMD
 | **CMD ["p1_cmd", "p2_cmd"]**   | p1_cmd p2_cmd              | /bin/sh -c exec_entry p1_entry | exec_entry p1_entry p1_cmd p2_cmd              |
 | **CMD exec_cmd p1_cmd**        | /bin/sh -c exec_cmd p1_cmd | /bin/sh -c exec_entry p1_entry | exec_entry p1_entry /bin/sh -c exec_cmd p1_cmd |
 
+> **Note**: If `CMD` is defined from the base image, setting `ENTRYPOINT` will
+> reset `CMD` to an empty value. In this scenario, `CMD` must be defined in the
+> current image to have a value.
+
 ## VOLUME
 
     VOLUME ["/data"]