summaryrefslogtreecommitdiffstats
path: root/Doc/api/api.tex
Commit message (Collapse)AuthorAgeFilesLines
* 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.
* This patch changes the way the string .encode() method works slightlyMarc-André Lemburg2001-05-151-7/+21
| | | | | | | | | | | | | | | | | | | | | | | | | and introduces a new method .decode(). The major change is that strg.encode() will no longer try to convert Unicode returns from the codec into a string, but instead pass along the Unicode object as-is. The same is now true for all other codec return types. The underlying C APIs were changed accordingly. Note that even though this does have the potential of breaking existing code, the chances are low since conversion from Unicode previously took place using the default encoding which is normally set to ASCII rendering this auto-conversion mechanism useless for most Unicode encodings. The good news is that you can now use .encode() and .decode() with much greater ease and that the door was opened for better accessibility of the builtin codecs. As demonstration of the new feature, the patch includes a few new codecs which allow string to string encoding and decoding (rot13, hex, zip, uu, base64). Written by Marc-Andre Lemburg. Copyright assigned to the PSF.
* Hmm... better add a version annotation for the Iterator Protocol section.Fred Drake2001-05-071-0/+2
|
* Added documentation for PyIter_Check() and PyIter_Next().Fred Drake2001-05-071-1/+39
| | | | Wrapped a long line.
* This patch originated from an idea by Martin v. Loewis who submitted aMarc-André Lemburg2001-04-231-1/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | patch for sharing single character Unicode objects. Martin's patch had to be reworked in a number of ways to take Unicode resizing into consideration as well. Here's what the updated patch implements: * Single character Unicode strings in the Latin-1 range are shared (not only ASCII chars as in Martin's original patch). * The ASCII and Latin-1 codecs make use of this optimization, providing a noticable speedup for single character strings. Most Unicode methods can use the optimization as well (by virtue of using PyUnicode_FromUnicode()). * Some code cleanup was done (replacing memcpy with Py_UNICODE_COPY) * The PyUnicode_Resize() can now also handle the case of resizing unicode_empty which previously resulted in an error. * Modified the internal API _PyUnicode_Resize() and the public PyUnicode_Resize() API to handle references to shared objects correctly. The _PyUnicode_Resize() signature changed due to this. * Callers of PyUnicode_FromUnicode() may now only modify the Unicode object contents of the returned object in case they called the API with NULL as content template. Note that even though this patch passes the regression tests, there may still be subtle bugs in the sharing code.
* Michael Hudson:Fred Drake2001-04-131-1/+23
| | | | | | | Update docs for PyDict_Next() based on the most recent changes to the dictionary code. This closes SF patch #409864.
* Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.Fred Drake2001-04-131-4/+4
|
* Correct the documentation for getreadbufferproc and getwritebufferproc.Greg Stein2001-04-071-5/+6
| | | | Fixes bug #233308 from Travis Oliphant.
* Document PySequence_Size(), and describe PySequence_Length() as simply anFred Drake2001-04-041-1/+5
| | | | alternate name for the same function.
* Added documentation for PyObject_IsInstance() and PyObject_IsSubclass().Fred Drake2001-03-281-0/+36
|
* Strengthen the constraints on calling PyObject_GC_Fini().Fred Drake2001-03-231-0/+5
|
* Be more clear about the specific rules for supporting the cyclic GC in anFred Drake2001-03-221-4/+126
| | | | | | | extension object. Also included an example showing exactly what needs to be done and nothing else. This closes SF bug #228591.
* Integrated an expanded version of some text from Neil Schemenauer aboutFred Drake2001-03-211-3/+85
| | | | | | | supporting cyclic garbage collection. (This is not all of it, but I'm taking a break!) Also fixed some markup nits.
* Finally fill in the documentation for the PyDict_Next() function. It isFred Drake2001-03-161-2/+20
| | | | | | different enough to actually require an explanation. ;-) Fix a couple of PyDictObject* types that should be PyObject* types.
* Document PyErr_WarnExplicit().Guido van Rossum2001-02-281-0/+9
|
* PyTuple_*() functions take PyObject* parameters, not PyTupleObject* values.Fred Drake2001-02-121-7/+6
| | | | This closes SF bug #131304.
* Remove an now-false statement about there being only one type flagFred Drake2001-02-031-3/+1
| | | | defined.
* Document the PyInstance_*() functions and data.Fred Drake2001-01-281-2/+30
|
* Fixed a bunch of typos caught by Gilles Civario.Fred Drake2001-01-191-17/+20
|
* Undoing the whitespace patches which sneaked into the earlier patch.Marc-André Lemburg2001-01-171-6/+6
|
* This patch adds a new builtin unistr() which behaves like str()Marc-André Lemburg2001-01-171-6/+14
| | | | | | | | | | except that it always returns Unicode objects. A new C API PyObject_Unicode() is also provided. This closes patch #101664. Written by Marc-Andre Lemburg. Copyright assigned to Guido van Rossum.
* Markup nit: Command line options should be marked with \programopt.Fred Drake2001-01-041-2/+2
|
* Document Pyerr_Warn().Guido van Rossum2000-12-191-0/+34
|
* In the first discussion showing how to handle exceptions from C, make theFred Drake2000-11-291-7/+11
| | | | | | | | Python equivalent actually equivalent to the C code. Also, in the C code, place the "goto" statements on a line by themselves for better visibility of statements that affect control flow. This closes bug #123398.
* Added documentation for the Py_InitModule*() family of functions.Fred Drake2000-11-281-1/+31
|
* Added exception to the rule that the buffer returned by PyString_AsString()Fred Drake2000-10-231-4/+17
| | | | | | | | | | | | and PyString_AsStringAndSize() for strings that were just created using PyString_FromStringAndSize(NULL, n). This closes bug #117377. Added warning about passing NULL to the concrete object functions; many of them use the appropriate Py<Type>_Check() test, but do not check for NULL. "de-allocated" --> "deallocated"
* For PyErr_Format(), note that the exception parameter can be a string orFred Drake2000-10-141-2/+2
| | | | | class, but not an instance (since an instance will be created using the formatted message string as the constructor parameter).
* Fix a couple of places where the descriptions of *_GET_SIZE() macros saidFred Drake2000-10-071-2/+2
| | | | | | they were similar to *_GetSize(); should be similar to *_Size(). Error noted by William Park <parkw@better.net>.
* The _PyTuple_Resize() last_is_sticky flag must now always be false.Neil Schemenauer2000-10-051-6/+6
|
* Reversely --> ConverselyFred Drake2000-09-291-2/+2
| | | | This closes SourceForge bug #115673.
* Note that including Python.h includes limits.h when available.Fred Drake2000-09-261-2/+2
|
* Added documentation for the new PyModule_*() convenience functions.Fred Drake2000-09-231-0/+26
| | | | This closes SourceForge patch #101233.
* PyNumber_Coerce() returns an int, not a PyObject *.Fred Drake2000-09-221-1/+1
|
* Include the new text on reporting bugs in a few useful places.Fred Drake2000-09-211-0/+4
| | | | This closes SourceForge bug #114792.
* This patch adds a new Python C API called PyString_AsStringAndSize()Marc-André Lemburg2000-09-191-0/+17
| | | | | | | | | | | | | which implements the automatic conversion from Unicode to a string object using the default encoding. The new API is then put to use to have eval() and exec accept Unicode objects as code parameter. This closes bugs #110924 and #113890. As side-effect, the traditional C APIs PyString_Size() and PyString_AsString() will also accept Unicode objects as parameters.
* Document new APIs PyOS_getsig() and PyOS_setsig().Guido van Rossum2000-09-161-0/+15
| | | | | | (Is there no macro to document a typedef?) Fred, please check my latex!
* Use \shortversion in a number of places.Fred Drake2000-09-141-6/+5
| | | | This partially addresses SourceForge bug #114318.
* Avoid reference to specific versions of Python where possible.Fred Drake2000-09-141-3/+3
| | | | This partially addresses SourceForge bug #114318.
* Thomas Wouters <thomas@xs4all.net>:Fred Drake2000-09-121-7/+106
| | | | | Fix up some of the PyNumber_*() documentation. Add documentation for the InPlace API calls.
* Vladimir Marangozov <Vladimir.Marangozov@inrialpes.fr>:Fred Drake2000-09-121-53/+52
| | | | | | | Here are some changes to the C API docs. The memory examples & API have been updated because one malloc family is gone (Py_Malloc). You'll see other small additions to the "building new types" section for completeness and some cleanup at the end of the memory section.
* Added documentation for PySequence_Fast() and PySequence_Fast_GET_ITEM().Fred Drake2000-09-121-0/+17
|
* Update documentation for PyErr_Format, because the function has changed.Moshe Zadka2000-09-011-9/+19
| | | | Connected to patch 100895
* Document PyImport_AppendInittab(), PyImport_ExtendInittab(), andFred Drake2000-09-011-1/+39
| | | | | | struct _inittab. This closes SourceForge bug #111499.
* refactor __del__ exception handler into PyErr_WriteUnraisableJeremy Hylton2000-09-011-0/+11
| | | | | add sanity check to gc: if an exception occurs during GC, call PyErr_WriteUnraisable and then call Py_FatalEror.
* Document PyOS_CheckStack().Fred Drake2000-08-311-2/+12
| | | | Fix a couple of really minor markup nits.
* In the section on the "Very High Level Layer", address concerns brought upFred Drake2000-08-141-0/+9
| | | | | | | | by Edward K. Ream <edream@users.sourceforge.net> about FILE* values and incompatible C libraries in dynamically linked extensions. It is not clear (to me) how realistic the issue is, but it is better documented than not. This closes SourceForge bug #111520.
* PyRun_InteractiveOne(),Fred Drake2000-08-111-2/+20
| | | | | | | | PyRun_InteractiveLoop(): Added descriptions. PyExc_WindowsError: Added to list of standard exceptions and added note about the right preprocessor symbol to use to protect code that uses it.
* ANY becomes void, to reflect the requirement for ANSI C.Fred Drake2000-08-111-18/+11
|
* Document PyObject_AsFileDescriptorAndrew M. Kuchling2000-07-131-0/+7
|