Skip to content

Commit 8fda678

Browse files
committed
Address review feedback
1 parent e34c496 commit 8fda678

File tree

2 files changed

+10
-10
lines changed

2 files changed

+10
-10
lines changed

source/specifications/core-metadata.rst

+9-10
Original file line numberDiff line numberDiff line change
@@ -544,28 +544,27 @@ distribution.
544544

545545
A requirement string has one mandatory and three optional parts.
546546

547-
* A project name, in the same format as the ``Name:`` field.
548-
The only mandatory part.
547+
* A project name, in :ref:`the same format <name-format>`
548+
as the ``Name:`` field. The only mandatory part.
549549
* A comma-separated list of 'extra' names in square brackets, like
550550
``[extra1,extra2]``. These names are defined by the required
551551
project, referring to specific features which may need extra
552552
dependencies. The names MUST conform to the restrictions specified
553553
by the ``Provides-Extra:`` field.
554-
* Either a version specifier or an ``@`` sign followed by a URL.
555-
Tools parsing the format should accept optional parentheses around
556-
a version specifier, but tools generating it should not use
557-
parentheses.
554+
* Either a :ref:`version specifier <version-specifiers>` or a
555+
:ref:`direct reference <direct-references>`. Tools parsing the format
556+
should accept optional parentheses around a version specifier, but
557+
tools generating it should not use parentheses. If a distribution
558+
requires a direct reference it cannot be uploaded to PyPI, but private
559+
repositories may allow such distributions.
558560
* An environment marker after a semicolon. This means that the
559561
requirement is only needed in the specified conditions.
560562

561-
See :pep:`508` for full details of the allowed format.
563+
See :ref:`dependency-specifiers` for full details of the allowed format.
562564

563565
The project names should correspond to names as found
564566
on the `Python Package Index`_.
565567

566-
Version specifiers must follow the rules described in
567-
:doc:`version-specifiers`.
568-
569568
Examples::
570569

571570
Requires-Dist: pkginfo

source/specifications/version-specifiers.rst

+1
Original file line numberDiff line numberDiff line change
@@ -1078,6 +1078,7 @@ Examples
10781078
* ``~=3.1.0, != 3.1.3``: version 3.1.0 or later, but not version 3.1.3 and
10791079
not version 3.2.0 or later.
10801080

1081+
.. _direct-references:
10811082

10821083
Direct references
10831084
=================

0 commit comments

Comments
 (0)