PEP 517: add clarifying sentence about duplicate keys in config-settings (GH-2996)
This commit is contained in:
parent
77bbe7983a
commit
c36b348151
|
@ -374,9 +374,11 @@ dictionary provided as an "escape hatch" for users to pass ad-hoc
|
|||
configuration into individual package builds. Build backends MAY
|
||||
assign any semantics they like to this dictionary. Build frontends
|
||||
SHOULD provide some mechanism for users to specify arbitrary
|
||||
string-key/string-value pairs to be placed in this dictionary. For
|
||||
example, they might support some syntax like ``--package-config
|
||||
CC=gcc``. Build frontends MAY also provide arbitrary other mechanisms
|
||||
string-key/string-value pairs to be placed in this dictionary.
|
||||
For example, they might support some syntax like ``--package-config CC=gcc``.
|
||||
In case a user provides duplicate string-keys, build frontends SHOULD
|
||||
combine the corresponding string-values into a list of strings.
|
||||
Build frontends MAY also provide arbitrary other mechanisms
|
||||
for users to place entries in this dictionary. For example, ``pip``
|
||||
might choose to map a mix of modern and legacy command line arguments
|
||||
like::
|
||||
|
|
Loading…
Reference in New Issue