docs: dockerfile chmod variable interpolation

Signed-off-by: David Karlsson <[email protected]>

frontend/dockerfile/docs/reference.md

@@ -1646,6 +1646,16 @@ If the container root filesystem doesn't contain either `/etc/passwd` or
 flag, the build will fail on the `COPY` operation. Using numeric IDs requires
 no lookup and does not depend on container root filesystem content.
 
+With BuildKit version 0.16.0 and later, the `--chmod` flag supports variable
+interpolation, which lets you define the permission bits using build arguments:
+
+```dockerfile
+FROM alpine
+WORKDIR /src
+ARG MODE=440
+COPY --chmod=$MODE . .
+```
+
 ### COPY --link
 
 ```dockerfile