Commit d73049fb authored by chrisw's avatar chrisw

change "finding distributions" docs to correctly describe index and find-links behaviour


git-svn-id: http://svn.zope.org/repos/main/zc.buildout/trunk@89829 62d5b8a3-27da-0310-9561-8e5933582275
parent 3787267d
...@@ -2222,11 +2222,24 @@ Finding distributions ...@@ -2222,11 +2222,24 @@ Finding distributions
--------------------- ---------------------
By default, buildout searches the Python Package Index when looking By default, buildout searches the Python Package Index when looking
for distributions. The `find-links` options allows the addition of for distributions. You can, instead, specify your own index to search
more locations to search and is used extensively in this using the `index` option::
documentation.
These can be urls:: [buildout]
...
index = http://index.example.com/
This index, or the default of http://pypi.python.org/simple/ if no
index is specified, will always be searched for distributions unless
running buildout with options that prevent searching for
distributions. The latest version of the distribution that meets the
requirements of the buildout will always be used.
You can also specify more locations to search for distributions using
the `find-links` option. All locations specified will be searched for
distributions along with the package index as described before.
Locations can be urls::
[buildout] [buildout]
... ...
...@@ -2238,13 +2251,13 @@ They can also be directories on disk:: ...@@ -2238,13 +2251,13 @@ They can also be directories on disk::
... ...
find-links = /some/path find-links = /some/path
Finally, direct paths to distributions can be specified:: Finally, they can also be direct paths to distributions::
[buildout] [buildout]
... ...
find-links = /some/path/someegg-1.0.0-py2.3.egg find-links = /some/path/someegg-1.0.0-py2.3.egg
You can also specify more than one place to look:: Any number of locations can be specified in the `find-links` option::
[buildout] [buildout]
... ...
...@@ -2253,12 +2266,6 @@ You can also specify more than one place to look:: ...@@ -2253,12 +2266,6 @@ You can also specify more than one place to look::
/some/otherpath /some/otherpath
/some/path/someegg-1.0.0-py2.3.egg /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 Dependency links
---------------- ----------------
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment