[Checkins] SVN: zc.buildout/trunk/src/zc/buildout/buildout.txt docs for find-links, I'm not 100% on the order of location searching but hopefully someone can review...

Chris Withers chris at simplistix.co.uk
Wed Aug 13 07:21:18 EDT 2008


Log message for revision 89790:
  docs for find-links, I'm not 100% on the order of location searching but hopefully someone can review...

Changed:
  U   zc.buildout/trunk/src/zc/buildout/buildout.txt

-=-
Modified: zc.buildout/trunk/src/zc/buildout/buildout.txt
===================================================================
--- zc.buildout/trunk/src/zc/buildout/buildout.txt	2008-08-13 09:18:23 UTC (rev 89789)
+++ zc.buildout/trunk/src/zc/buildout/buildout.txt	2008-08-13 11:21:17 UTC (rev 89790)
@@ -2218,6 +2218,47 @@
 You will then need to use a false value for prefer-final to get the
 newest releases.
 
+Finding distributions
+---------------------
+
+By default, buildout searches the Python Package Index when looking
+for distributions. The `find-links` options allows the addition of
+more locations to search and is used extensively in this
+documentation. 
+
+These can be urls::
+
+  [buildout]
+  ...
+  find-links = http://download.zope.org/distribution/
+
+They can also be directories on disk::
+
+  [buildout]
+  ...
+  find-links = /some/path
+
+Finally, direct paths to distributions can be specified::
+
+  [buildout]
+  ...
+  find-links = /some/path/someegg-1.0.0-py2.3.egg
+
+You can also specify more than one place to look::
+
+  [buildout]
+  ...
+  find-links = 
+      http://download.zope.org/distribution/
+      /some/otherpath
+      /some/path/someegg-1.0.0-py2.3.egg
+
+In this case, distribution sources are searched in the order
+specified. In the event that a distribution cannot be found in any of
+the locations specified, the python package index will still be
+searched unless other buildout configuration options have prevented
+this.
+
 Dependency links
 ----------------
 



More information about the Checkins mailing list