From e6eea5470afd3aa526e7773a8c1f0f1edcbaf8ce Mon Sep 17 00:00:00 2001 From: Matthew Brett Date: Tue, 2 Aug 2016 14:48:13 -0700 Subject: [PATCH] DOC: README to discourage additions to archives Can usually get away with not downloading archives to the `archives` directory. --- archives/README.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 archives/README.rst diff --git a/archives/README.rst b/archives/README.rst new file mode 100644 index 000000000..c3ead01f1 --- /dev/null +++ b/archives/README.rst @@ -0,0 +1,18 @@ +################################## +Archives for pillow library builds +################################## + +This directory contains archives for libraries that will be built as part of +the Pillow build. + +In general, there is no need to put library archives here, because the +``multibuild`` scripts will download them from their respective URLs. + +But, ``multibuild`` will look in this directory before downloading from the +URL, so if there is a library that often fails to download, or you think might +fail to download, then download it to this directory and add it to the git +repository. + +See the ``fetch_unpack`` routine in ``multibuild/common_utils.sh`` for the +logic, and the build recipes in ``multibuild/library_builders.sh`` for the +filename to give to the downloaded archive.