summaryrefslogtreecommitdiffstats
path: root/Doc/api
Commit message (Collapse)AuthorAgeFilesLines
* More refcount information.Fred Drake2001-10-291-0/+40
|
* PyObject_CallFunctionObArgs() ---> PyObject_CallFunctionObjArgs()Fred Drake2001-10-282-14/+14
| | | | PyObject_CallMethodObArgs() ---> PyObject_CallMethodObjArgs()
* Added docs for PyObject_CallFunctionObArgs() and PyObject_CallMethodObArgs().Fred Drake2001-10-261-11/+32
| | | | Minor cleanups & markup consistency fixes.
* Added refcount data for PyObject_CallFunctionObArgs() andFred Drake2001-10-261-0/+9
| | | | PyObject_CallMethodObArgs().
* Generalize dictionary() to accept a sequence of 2-sequences. At theTim Peters2001-10-261-5/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | outer level, the iterator protocol is used for memory-efficiency (the outer sequence may be very large if fully materialized); at the inner level, PySequence_Fast() is used for time-efficiency (these should always be sequences of length 2). dictobject.c, new functions PyDict_{Merge,Update}FromSeq2. These are wholly analogous to PyDict_{Merge,Update}, but process a sequence-of-2- sequences argument instead of a mapping object. For now, I left these functions file static, so no corresponding doc changes. It's tempting to change dict.update() to allow a sequence-of-2-seqs argument too. Also changed the name of dictionary's keyword argument from "mapping" to "x". Got a better name? "mapping_or_sequence_of_pairs" isn't attractive, although more so than "mosop" <wink>. abstract.h, abstract.tex: Added new PySequence_Fast_GET_SIZE function, much faster than going thru the all-purpose PySequence_Size. libfuncs.tex: - Document dictionary(). - Fiddle tuple() and list() to admit that their argument is optional. - The long-winded repetitions of "a sequence, a container that supports iteration, or an iterator object" is getting to be a PITA. Many months ago I suggested factoring this out into "iterable object", where the definition of that could include being explicit about generators too (as is, I'm not sure a reader outside of PythonLabs could guess that "an iterator object" includes a generator call). - Please check my curly braces -- I'm going blind <0.9 wink>. abstract.c, PySequence_Tuple(): When PyObject_GetIter() fails, leave its error msg alone now (the msg it produces has improved since PySequence_Tuple was generalized to accept iterable objects, and PySequence_Tuple was also stomping on the msg in cases it shouldn't have even before PyObject_GetIter grew a better msg).
* Slightly better conformance to the Python C style guide.Fred Drake2001-10-251-4/+8
|
* Documentation for the new PyArg_UnpackTuple() function.Fred Drake2001-10-231-0/+47
|
* Update the description of PyTrace_EXCEPT.Fred Drake2001-10-161-5/+8
|
* Added documentation for the functions listed in marshal.h.Fred Drake2001-10-141-0/+80
| | | | Prompted by Jim Ahlstrom. This closes SF patch #470614.
* Break the Python/C API manual into smaller files by chapter. This manualFred Drake2001-10-1211-6136/+6171
| | | | | | | | has grown beyond what font-lock will work with using the default (X)Emacs settings. Indentation of the description has been made consistent, and a number of smaller markup adjustments have been made as well.
* Add documentation for the public API for weak reference objects.Fred Drake2001-10-051-1/+70
|
* Expand the documentation of the low-level tracing/profiling interface.Fred Drake2001-10-031-2/+23
| | | | This reflects what is currently in CVS, which may change before 2.2 is final.
* Typo fix.Greg Ward2001-09-261-1/+1
|
* Add more signature information and some descriptions for the new APIsFred Drake2001-09-241-1/+89
| | | | | | | introduced in Python 2.2. Add documentation for the slice object interface (not complete). Added version annotations for several of the Python 2.2 APIs already documented.
* Add more reference count information.Fred Drake2001-09-241-0/+28
|
* Added API information for the PyCallIter_*() and PySeqIter_*() functions.Fred Drake2001-09-232-1/+66
| | | | Added signatures for some new PyType_*() functions.
* Document all the Py*_CheckExact() functions.Fred Drake2001-09-202-26/+174
| | | | Document many more of the PyLong_{As,From}*() functions.
* Fix parameter for PyInt_Check().Fred Drake2001-09-061-1/+31
| | | | Add refcount information for other recently documented APIs.
* Document the PyMethod_* type object, functions, and macros.Fred Drake2001-09-061-0/+58
|
* Document the rule that Python.h must be included before any standardFred Drake2001-09-061-0/+3
| | | | headers. This is the final checkin for SF bug #458768.
* Patch #449815: Set filesystemencoding based on CODESET.Martin v. Löwis2001-09-051-1/+5
|
* At Guido's suggestion, here's a new C API function, PyObject_Dir(), likeTim Peters2001-09-041-0/+10
| | | | __builtin__.dir(). Moved the guts from bltinmodule.c to object.c.
* Update documentation for GC API. Closes SF patch #421893.Neil Schemenauer2001-08-301-29/+48
|
* Refcount info for PyString_FromFormat() and PyString_FromFormatV().Barry Warsaw2001-08-281-0/+8
| | | | Closes SF patch #455666.
* Documentation for PyString_FromFormat() and PyString_FromFormatV().Barry Warsaw2001-08-281-0/+28
| | | | Closes SF patch #455666.
* Document PyTuple_GET_SIZE(), removing confusing sentence from PyDict_Copy()Fred Drake2001-08-201-2/+7
| | | | | | description. This fixes SF bug #453111.
* Patch #427190: Implement and use METH_NOARGS and METH_O.Martin v. Löwis2001-08-161-0/+62
|
* Add "exceptions" to the list of fundamental modulesFred Drake2001-08-141-3/+3
| | | | | | created by Py_Initialize(). This closes SF bug #450621.
* Added documentation for PyDict_Update() and PyDict_Merge().Fred Drake2001-08-101-1/+19
|
* Remove the bogus flags parameter from the PyFile_WriteString() signature;Fred Drake2001-08-101-2/+1
| | | | | | it has no such parameter. This closes SF bug #449761.
* Added documentation for PyNumber_*FloorDivide(), PyNumber_*TrueDivide(),Fred Drake2001-08-081-48/+138
| | | | | | | PyInterpreterState_*Head(), PyInterpreterState_Next(), and PyThreadState_Next(). Wrapped some long lines, added some others.
* Reference counting information for PyNumber_*FloorDivide() andFred Drake2001-08-081-0/+16
| | | | PyNumber_*TrueDivide().
* Move away from apply() to using extended call syntax for some exampleFred Drake2001-08-021-3/+19
| | | | | | | fragments when discussing equivalence of thhe C API to what a Python programmer sees. Added descriptions of PyEval_SetProfile() and PyEval_SetTrace().
* Typo: PyArgs_ParseTuple --> PyArg_ParseTupleFred Drake2001-07-201-30/+62
| | | | | | Moved the PyArg_Parse*(), Py_BuildValue() functions to the Utilities chapter, added a minimal description and reference to the Extending manual for Py_BuildValue().
* Added information on Py_BuildValue().Fred Drake2001-07-201-0/+3
|
* Adding what's done of the documentation for the new profiling &Fred Drake2001-07-171-0/+53
| | | | | tracing interface. Incomplete, but better to check it in since I've been including it in my updates.
* Oops, one more caret.Fred Drake2001-07-141-1/+1
|
* Fix the markup of the caret charater in a couple of places; LaTeX'sFred Drake2001-07-141-2/+2
| | | | | | special character bite us again. ;-( This fixes SF bug #440911.
* Move the section on concrete numeric objects before the section onFred Drake2001-07-111-249/+249
| | | | | | concrete sequence objects, since their API is simpler. This is in response to a comment in SF bug #440037.
* Corrected the refcount information for PyList_SET_ITEM().Fred Drake2001-07-101-1/+1
|
* Document PyObject_New(), PyObject_NewVar(), PyObject_Init(),Fred Drake2001-07-101-24/+97
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | PyObject_InitVar(), PyObject_Del(), PyObject_NEW(), PyObject_NEW_VAR(), and PyObject_DEL(). Add notes to PyMem_Malloc() and PyMem_New() about the memory buffers not being initialized. This fixes SF bug #439012. Added explicit return value information for PyList_SetItem(), PyDict_SetItem(), and PyDict_SetItemString(). Corrected return type for PyList_SET_ITEM(). Fixed index entries in the descriptions of PyLong_AsLong() and PyLong_AsUnignedLong(). This fixes the API manual portion of SF bug #440037. Note that the headers properly declare everything as 'extern "C"' for C++ users. Document _Py_NoneStruct. Added links to the Extending & Embedding manual for PyArg_ParseTuple() and PyArg_ParseTupleAndKeywords(). Added note that PyArg_Parse() should not be used in new code. Fix up a few style nits -- avoid "e.g." and "i.e." -- these make translation more difficult, as well as reading the English more difficult for non-native speakers.
* Fix for SF bug #436525, reported by Greg Kochanski:Thomas Wouters2001-07-091-2/+2
| | | | | | The block/unblock thread macros are called 'Py_BLOCK_THREADS' and 'Py_UNBLOCK_THREADS', not 'Py_BEGIN_BLOCK_THREADS' and 'Py_BEGIN_UNBLOCK_THREADS'.
* More reference count information.Fred Drake2001-07-061-1/+9
|
* Move license information to a less annoying location in the document.Fred Drake2001-06-201-0/+13
| | | | Add documentation for PyErr_SetFromErrnoWithFilename().
* Explained more differences between PyList_SetItem() and PyList_SET_ITEM().Fred Drake2001-06-031-2/+7
| | | | | | | In particular, the affect on existing list content was not sufficiently explained. This closes SF bug #429554.
* Users of PySequence_GET_FAST() should get the length of the sequence usingFred Drake2001-05-291-1/+1
| | | | | | | PySequence_Size(), not PyObject_Size(): the later considers the mapping methods as well as the sequence methods, which is not needed here. Either should be equally fast in this case, but PySequence_Size() offers a better conceptual match.
* Removed information on the old third parameter to _PyTuple_Resize().Fred Drake2001-05-291-1/+20
| | | | | | Added information on PyIter_Check(), PyIter_Next(), PyObject_Unicode(), PyString_AsDecodedObject(), PyString_AsEncodedObject(), and PyThreadState_GetDict().
* Do not start API descriptions with "Does the same, but ..." -- actuallyFred Drake2001-05-291-10/+13
| | | | | | | | state *which* other function the current one is like, even if the descriptions are adjacent. Revise the _PyTuple_Resize() description to reflect the removal of the third parameter.
* Add documentation for Py_Main() and PyThreadState_GetDict().Fred Drake2001-05-211-0/+21
|
* Typo: "that" --> "than"Fred Drake2001-05-211-1/+1
| | | | This closes SF bug #425320.