From cd7e2a6b2b529cb4180926352a3fe9e82040d073 Mon Sep 17 00:00:00 2001 From: Josh Hawn Date: Mon, 8 Jun 2015 11:42:00 -0700 Subject: [PATCH] [docs] Update builder docs on last-modified times Docker-DCO-1.1-Signed-off-by: Josh Hawn (github: jlhawn) --- docs/sources/articles/dockerfile_best-practices.md | 3 ++- docs/sources/reference/builder.md | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/sources/articles/dockerfile_best-practices.md b/docs/sources/articles/dockerfile_best-practices.md index 2604b22453..8c9c6ed515 100644 --- a/docs/sources/articles/dockerfile_best-practices.md +++ b/docs/sources/articles/dockerfile_best-practices.md @@ -103,7 +103,8 @@ a little more examination and explanation. being put into the image are examined. Specifically, a checksum is done of the file(s) and then that checksum is used during the cache lookup. If anything has changed in the file(s), including its metadata, -then the cache is invalidated. +then the cache is invalidated. The last-modified and last-accessed times of the +file(s) are not considered in these checksums. * Aside from the `ADD` and `COPY` commands cache checking will not look at the files in the container to determine a cache match. For example, when processing diff --git a/docs/sources/reference/builder.md b/docs/sources/reference/builder.md index fb4d5ce1d7..485ad39b88 100644 --- a/docs/sources/reference/builder.md +++ b/docs/sources/reference/builder.md @@ -519,8 +519,8 @@ 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 have permissions of 600. If the remote file being retrieved has an HTTP `Last-Modified` header, the timestamp from that header will be used -to set the `mtime` on the destination file. Then, like any other file -processed during an `ADD`, `mtime` will be included in the determination +to set the `mtime` on the destination file. However, like any other file +processed during an `ADD`, `mtime` will not be included in the determination of whether or not the file has changed and the cache should be updated. > **Note**: