While modifying zlibmodule.c, Serhiy told me that argument clinic is now used in zlibmodule.c. Running "./python Tools/clinic/clinic.py -f Modules/zlibmodule.c" does modify the file, so I misuse argument clinic.

I saw Argument Clinic on Youtube but it didn't help...
http://www.youtube.com/watch?v=kQFKtI6gn9Y

Would it be possible to explain how to use clinic.py, explain the format, etc. in the Python documentation? Somewhere near Doc/c-api/.

I think this is really necessary at some point.
How to start writing a function with Argument Clinic, etc.

I quite agree.  My plan is to write a quick HOWTO for now to get
people up and running for now, then flesh it out into a full document.
But I'm working like crazy right now to get a couple things done
before beta.

> I quite agree.  My plan is to write a quick HOWTO for now to get
> people up and running for now, then flesh it out into a full document.

Oh yes, I prefer a practical doc based on examples rather a full reference of the API.

While it's still a private tool, something in the dev guide would be
appropriate, then it can be promoted to the regular docs if it becomes a
public capability in 3.5.

New changeset e2280bf5c263 by Larry Hastings in branch 'default':
Issue #19659: Added documentation for Argument Clinic.
http://hg.python.org/cpython/rev/e2280bf5c263

I hid it in the howto directory.  Nobody'll look in there!  :D

> I hid it in the howto directory.  Nobody'll look in there!  :D

I think using a dotfile would make the hiding more efficient.

Doesn't help on Windows, junior!