[Python-Dev] usefulness of "extension modules" section in Misc/NEWS

Charles-François Natali cf.natali at gmail.com
Sun Jan 27 10:56:51 CET 2013


Hi,

What's exactly the guideline for choosing between the "Library" and
"Extension modules" section when updating Misc/NEWS?
Is it just the fact that the modified files live under Lib/ or Modules/?

I've frequently made a mistake when updating Misc/NEWS, and when
looking at it, I'm not the only one.

Is there really a good reason for having distinct sections?

If the intended audience for this file are end users, ISTM that the
only things that matters is that it's a library change, the fact that
the modification impacted Python/C code isn't really relevant.

Also, for example if you're rewriting a library from Python to C (or
vice versa), should it appear under both sections?

FWIW, the What's new documents don't have such a distinction.

Cheers,

cf


More information about the Python-Dev mailing list