Commits

Donald Stufft  committed b7265f9

Use `project @ URL` instead of `project (from URL)` for direct references

  • Participants
  • Parent commits af4e4e1

Comments (0)

Files changed (1)

File versioning.rst

 
 Some automated tools may permit the use of a direct reference as an
 alternative to a normal version specifier. A direct reference consists of
-the word ``from`` and an explicit URL.
+the specifier ``@`` and an explicit URL.
 
 Whether or not direct references are appropriate depends on the specific
 use case for the version specifier. Automated tools SHOULD at least issue
 
 For example, a local source archive may be referenced directly::
 
-    pip (from file:///localbuilds/pip-1.3.1.zip)
+    pip @ file:///localbuilds/pip-1.3.1.zip
 
 Alternatively, a prebuilt archive may also be referenced::
 
-    pip (from file:///localbuilds/pip-1.3.1-py33-none-any.whl)
+    pip @ file:///localbuilds/pip-1.3.1-py33-none-any.whl
 
 All direct references that do not refer to a local file URL SHOULD specify
 a secure transport mechanism (such as ``https``) AND include an expected
 
 Remote URL examples::
 
-    pip (from https://github.com/pypa/pip/archive/1.3.1.zip#sha1=da9234ee9982d4bbb3c72346a6de940a148ea686)
-    pip (from git+https://github.com/pypa/pip.git@7921be1537eac1e97bc40179a57f0349c2aee67d)
-    pip (from git+https://github.com/pypa/pip.git@1.3.1#7921be1537eac1e97bc40179a57f0349c2aee67d)
+    pip @ https://github.com/pypa/pip/archive/1.3.1.zip#sha1=da9234ee9982d4bbb3c72346a6de940a148ea686
+    pip @ git+https://github.com/pypa/pip.git@7921be1537eac1e97bc40179a57f0349c2aee67d
+    pip @ git+https://github.com/pypa/pip.git@1.3.1#7921be1537eac1e97bc40179a57f0349c2aee67d