Update ADD documentation to specify new behavior.

This commit is contained in:
Caleb Spare 2013-07-08 01:29:13 -07:00
parent 416fdaa3d5
commit c383d59880

View file

@ -152,6 +152,14 @@ destination container.
The copy obeys the following rules: The copy obeys the following rules:
* If ``<src>`` is a URL and ``<dest>`` does not end with a trailing slash,
then a file is downloaded from the URL and copied to ``<dest>``.
* If ``<src>`` is a URL and ``<dest>`` does end with a trailing slash,
then the filename is inferred from the URL and the file is downloaded to
``<dest>/<filename>``. For instance, ``ADD http://example.com/foobar /``
would create the file ``/foobar``. The URL must have a nontrivial path
so that an appropriate filename can be discovered in this case
(``http://example.com`` will not work).
* If ``<src>`` is a directory, the entire directory is copied, * If ``<src>`` is a directory, the entire directory is copied,
including filesystem metadata. including filesystem metadata.
* If ``<src>``` is a tar archive in a recognized compression format * If ``<src>``` is a tar archive in a recognized compression format