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

Godefroid Chapelle gotcha at bubblenet.be
Sun Mar 29 17:24:17 EDT 2009


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

Changed:
  U   zc.buildout/branches/help-api/src/zc/buildout/buildout.txt

-=-
Modified: zc.buildout/branches/help-api/src/zc/buildout/buildout.txt
===================================================================
--- zc.buildout/branches/help-api/src/zc/buildout/buildout.txt	2009-03-29 21:24:10 UTC (rev 98531)
+++ zc.buildout/branches/help-api/src/zc/buildout/buildout.txt	2009-03-29 21:24:16 UTC (rev 98532)
@@ -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