Typo fix.

Tested w/valgrind, all paths except the return on PyInt_AsLong() failure
I think I got all of these right.

Backport candidate.

Removed ^M from some line-ends.

This matches the Python C style guide (PEP 7).
Closes SF patch #571489.

version number, and explain what it is at the top of the chapter.
This closes SF bug #225003.

the Extending & Embedding manual use it.

Clean up the example of exporting a C-callable API from an extension module.
Add a hyperlink to a related section in the Python/C API reference.

PyModule_GetDict(), which is also more flexible: it does not assume that the
"module" is a real module.

Change a section title to fit in better.

document to the C API reference.  Move some instructional text from the API
reference to the Extending & Embedding manual.

Fix the descriptions of the es and es# formats for PyArg_Parse*().
This closes SF bug #536516.

Minor cleanups.

This closes SF bug #537511.

There's still a long way to go, but we're starting to see some real
content in the docs.

type implementation.

include them using \verbatiminput.  This has the advantage that pages
can still break at reasonable places, and examples that go longer than
a page won't get cut off.

Make a few small markup adjustments for consistency.

Explain that PyObject_New() is not a C function but a polymorphic
beast that returns a pointer to the type that's passed as the first
arg.

Explain why type objects use the PyObject_VAR_HEAD.