Browse code

Fix #2369 by documenting decompression behavior.

Andy Rothfusz authored on 2013/10/31 08:50:58
Showing 1 changed files
... ...
@@ -208,6 +208,9 @@ a remote file URL.
208 208
 ``<dest>`` is the path at which the source will be copied in the
209 209
 destination container.
210 210
 
211
+All new files and directories are created with mode 0755, uid and gid
212
+0.
213
+
211 214
 The copy obeys the following rules:
212 215
 
213 216
 * If ``<src>`` is a URL and ``<dest>`` does not end with a trailing slash,
... ...
@@ -220,8 +223,9 @@ The copy obeys the following rules:
220 220
   (``http://example.com`` will not work).
221 221
 * If ``<src>`` is a directory, the entire directory is copied,
222 222
   including filesystem metadata.
223
-* If ``<src>`` is a tar archive in a recognized compression format
224
-  (identity, gzip, bzip2 or xz), it is unpacked as a directory.
223
+* If ``<src>`` is a *local* tar archive in a recognized compression
224
+  format (identity, gzip, bzip2 or xz) then it is unpacked as a
225
+  directory. Resources from *remote* URLs are **not** decompressed.
225 226
 
226 227
   When a directory is copied or unpacked, it has the same behavior as
227 228
   ``tar -x``: the result is the union of
... ...
@@ -229,7 +233,7 @@ The copy obeys the following rules:
229 229
   1. whatever existed at the destination path and
230 230
   2. the contents of the source tree,
231 231
 
232
-  with conflicts resolved in favor of 2) on a file-by-file basis.
232
+  with conflicts resolved in favor of "2." on a file-by-file basis.
233 233
 
234 234
 * If ``<src>`` is any other kind of file, it is copied individually
235 235
   along with its metadata. In this case, if ``<dest>`` ends with a
... ...
@@ -237,10 +241,9 @@ The copy obeys the following rules:
237 237
   contents of ``<src>`` will be written at ``<dest>/base(<src>)``.
238 238
 * If ``<dest>`` does not end with a trailing slash, it will be
239 239
   considered a regular file and the contents of ``<src>`` will be
240
-  written at ``<dst>``.
240
+  written at ``<dest>``.
241 241
 * If ``<dest>`` doesn't exist, it is created along with all missing
242
-  directories in its path. All new files and directories are created
243
-  with mode 0755, uid and gid 0.
242
+  directories in its path. 
244 243
 
245 244
 .. _entrypoint_def:
246 245