[Distutils] abstract build system PEP update

[Marius Gedminas]

On Tue, Feb 16, 2016 at 04:10:43PM +1300, Robert Collins wrote:
> diff --git a/build-system-abstraction.rst b/build-system-abstraction.rst
> index a6e4712..56464f1 100644
> --- a/build-system-abstraction.rst
> +++ b/build-system-abstraction.rst
> @@ -68,12 +68,15 @@ modelled on pip's existing use of the setuptools
> setup.py interface.
>  pypa.json
>  ---------
> 
> -The file ``pypa.json`` acts as neutron configuration file for pip and other
> +The file ``pypa.json`` acts as neutral configuration file for pip and other
>  tools that want to build source trees to consult for configuration. The
>  absence of a ``pypa.json`` file in a Python source tree implies a setuptools
>  or setuptools compatible build system.
> 
> -The JSON has the following schema. Extra keys are ignored.
> +The JSON has the following schema. Extra keys are ignored, which permits the
> +use of ``pypa.json`` as a configuration file for other related tools. If doing
> +that the chosen keys must be namespaced - e.g. ``flit`` with keys under that
> +rather than (say) ``build`` or other generic keys.

Is this going to be a file that human beings are expected to edit by
hand?

If so, can we please not use JSON?  JSON is rather hostile to humans: no
trailing commas, no possibility to add comments.

Marius Gedminas
-- 
Debugging a computer program is such an interesting activity because it's not
really a matter of fixing a program. It's a matter of fixing your own
understanding to the point that the cause of the bug becomes obvious.  So
debugging means constantly challenging your assumptions, constantly looking
for the overlooked insignificant thing that turns out to be crucial.
        -- Joey Hess
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 173 bytes
Desc: Digital signature
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20160217/5a658f31/attachment.sig>