[issue19659] Document Argument Clinic

[Larry Hastings]

Larry Hastings added the comment:

Doesn't help on Windows, junior!

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19659] Document Argument Clinic

[Antoine Pitrou]

Antoine Pitrou added the comment:

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

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

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19659] Document Argument Clinic

[Larry Hastings]

Larry Hastings added the comment:

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

--
assignee:  -> larry
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19659] Document Argument Clinic

[Roundup Robot]

Roundup Robot added the comment:

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

--
nosy: +python-dev

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19659] Document Argument Clinic

[Brett Cannon]

Changes by Brett Cannon :


--
nosy: +brett.cannon

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19659] Document Argument Clinic

[Nick Coghlan]

Nick Coghlan added the comment:

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.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19659] Document Argument Clinic

[STINNER Victor]

STINNER Victor added the comment:

> 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.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19659] Document Argument Clinic

[Larry Hastings]

Larry Hastings added the comment:

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.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19659] Document Argument Clinic

[Antoine Pitrou]

Antoine Pitrou added the comment:

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

--
components: +Build, Demos and Tools
nosy: +ncoghlan, pitrou
priority: normal -> critical
title: Document Argument Clinic? -> Document Argument Clinic

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19659] Document Argument Clinic?

[STINNER Victor]

New submission from STINNER Victor:

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/.

--
messages: 203452
nosy: haypo, larry
priority: normal
severity: normal
status: open
title: Document Argument Clinic?
versions: Python 3.4

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com