[Docs] clarify keyword "keywords" requirements

[ynikitenko]

Summary

At https://setuptools.pypa.io/en/latest/references/keywords.html there is a keyword keywords:

A list of strings or a comma-separated string providing descriptive meta-data. See: PEP 0314.

However, in PEP 314 there is no requirement for the string to be comma-separated (in fact, the example there is without commas, and I earlier used strings without commas):

A list of additional keywords to be used to assist searching for the package in a larger catalog.

Please fix your documentation or refer to a proper source.

OS / Environment

No response

Additional Information

This makes documentation non self-contradictory: correct (in the case of fix) or understandable by users (in the case of a proper link).

Code of Conduct

• I agree to follow the PSF Code of Conduct

[ynikitenko]

I found that there were recent documentation changes, but this doesn't seem to be addressed by them. #3307

[ynikitenko]

One more note: I really use a string without commas in my setup.py, and they seem to be automatically inserted on PyPI (https://pypi.org/project/lena/). So probably commas are still not required in the setup file.

[abravalheri]

Hi @ynikitenko thank you very much for the PR.

The core metadata standard is a live standard, which means that its most recent version can be found in:
https://packaging.python.org/en/latest/specifications/core-metadata/#keywords.

That pages does mention commas. The request for changing the ref is very legit 😄

[ynikitenko]

Hi @abravalheri , thanks for the quick update and for the link! Just out of curiosity, what happens if I don't use commas? As I wrote, PyPI separated all my keywords by commas (if I ever intended it to be one sentence :) .

[abravalheri]

I don't know if setuptools or PyPI has some fallback logic to handle that... It might be the case. But it is better to stick to the standard, since the fallback logic may be removed in the future.