Issue 23944: Argument Clinic: wrap impl's declaration if it's too long

For example:

_winapi_CreateFile_impl(PyModuleDef *module, LPCTSTR file_name, DWORD desired_access, DWORD share_mode, LPSECURITY_ATTRIBUTES security_attributes, DWORD creation_disposition, DWORD flags_and_attributes, HANDLE template_file)

If you give me a test case I'll knock this out.

Will do in the morning.

Larry: Here's your sample:

/*[clinic input]
_winapi.CreateProcess

    application_name: Py_UNICODE(nullable=True)
    command_line: Py_UNICODE(nullable=True)
    proc_attrs: object
        Ignored internally, can be None.
    thread_attrs: object
        Ignored internally, can be None.
    inherit_handles: BOOL
    creation_flags: DWORD
    env_mapping: object
    current_directory: Py_UNICODE(nullable=True)
    startup_info: object
    /

Create a new process and its primary thread.

The return value is a tuple of the process handle, thread handle,
process ID, and thread ID.
[clinic start generated code]*/

static PyObject *
_winapi_CreateProcess_impl(PyModuleDef *module, Py_UNICODE *application_name, Py_UNICODE *command_line, PyObject *proc_attrs, PyObject *thread_attrs, BOOL inherit_handles, DWORD creation_flags, PyObject *env_mapping, Py_UNICODE *current_directory, PyObject *startup_info)
/*[clinic end generated code: output=c279c1271b4c45cf input=6667ea0bc7036472]*/

I wish the Python bug tracker had a way of attaching files to issues, so we didn't have to just copy and paste into and out of the comments.  Ah well, wishful thinking!

Alright, alright, I'll get you a file.

On Tue, Apr 14, 2015 at 1:22 PM, Larry Hastings <report@bugs.python.org> wrote:
>
> Larry Hastings added the comment:
>
> I wish the Python bug tracker had a way of attaching files to issues, so we didn't have to just copy and paste into and out of the comments.  Ah well, wishful thinking!
>
> ----------
>
> _______________________________________
> Python tracker <report@bugs.python.org>
> <http://bugs.python.org/issue23944>
> _______________________________________

You can even have the whole thing, with lots of samples :)

That's AMAZING, you mean the web site knew how to do that THE WHOLE TIME?

Attached is a patch.  This causes a lot of churn, darn.

Should I copy & paste the patch into this text box too?  Maybe that would be more convenient!

Okay, this patch is about half the size.  I had a bug that was throwing away some important syntax.  With this patch applied, Python builds and the test suite is as reasonable as usual.

I swear, C compilers are so fussy sometimes!

After an English lesson, looks fine to me.

New changeset c99ca3d7052d by Larry Hastings in branch 'default':
Issue #23944: Argument Clinic now wraps long impl prototypes at column 78.
https://hg.python.org/cpython/rev/c99ca3d7052d

messages: + msg241000

messages: + msg240995

messages: + msg240979