94fedf9bfd
Expand the API notes.
2005-08-17 12:23:45 +00:00
0c230b9dac
Note that the PyNumber protocol can access most set methods directly.
2005-08-17 10:05:22 +00:00
c47e01d020
Numerous fix-ups to C API and docs. Added tests for C API.
2005-08-16 10:44:15 +00:00
beb3101b05
Add a C API for sets and frozensets.
2005-08-16 03:47:52 +00:00
0e03272350
bug [ 1061920 ] "k" specifier in PyArg_ParseTuple incomplete documentated
2005-07-17 20:05:25 +00:00
fb662972e0
Add a(nother) warning about mixing Py_NewInterpreter and the
...
PyGILState_* functions.
2005-06-20 16:37:03 +00:00
7b279078c0
fix some silly whitespace stuff (must have hit M-q or something?)
2005-06-20 12:12:45 +00:00
c49322951f
Fix grammar (it's -> its).
2005-06-18 17:54:13 +00:00
33ceda85d0
Function signatures for tp_descr_get and tp_descr_set.
2005-03-24 07:45:53 +00:00
5bbe6ad2b5
Fix name for PyDateTime_FromDateAndTime.
...
Closes bug #1124278 .
2005-02-17 05:17:17 +00:00
7706c2da14
Update references specifying "Macintosh" to mean OS X semantics and not Mac OS
...
9.
Applies patch #1095802 . Thanks Jack Jansen.
2005-02-13 22:50:04 +00:00
140042446f
Clean up discussion of new C thread idiom
...
(closes SF patch #1031233 ; modified)
2005-01-19 04:18:39 +00:00
68804315e0
SF Patch #1093896 : miscellaneous doc typos
2005-01-01 00:28:46 +00:00
8ef9b3e527
SF bug #1082944 : Incorrect docs for PyUnicode_TailMatch
...
* Note correct return type is int.
* Note that -1 returned on failure.
2004-12-10 17:12:32 +00:00
a9cadcd41b
Correct the handling of 0-termination of PyUnicode_AsWideChar()
...
and its usage in PyLocale_strcoll().
Clarify the documentation on this.
Thanks to Andreas Degert for pointing this out.
2004-11-22 13:02:31 +00:00
7f468f29f4
SF patch 1044089: New C API function PyEval_ThreadsInitialized(), by Nick
...
Coghlan, for determining whether PyEval_InitThreads() has been called.
Also purged the undocumented+unused _PyThread_Started int.
2004-10-11 02:40:51 +00:00
975e725fc7
Fix typo in PyDict_Items doc
2004-09-29 21:39:26 +00:00
69652035bc
SF patch #998993 : The UTF-8 and the UTF-16 stateful decoders now support
...
decoding incomplete input (when the input stream is temporarily exhausted).
codecs.StreamReader now implements buffering, which enables proper
readline support for the UTF-16 decoders. codecs.StreamReader.read()
has a new argument chars which specifies the number of characters to
return. codecs.StreamReader.readline() and codecs.StreamReader.readlines()
have a new argument keepends. Trailing "\n"s will be stripped from the lines
if keepends is false. Added C APIs PyUnicode_DecodeUTF8Stateful and
PyUnicode_DecodeUTF16Stateful.
2004-09-07 20:24:22 +00:00
336e85f56a
Patch #900727 : Add Py_InitializeEx to allow embedding without signals.
2004-08-19 11:31:58 +00:00
f54ac7e0ee
Spelling fix
2004-08-10 19:01:50 +00:00
4eb1a00cc1
[Patch #1003861 from Dima Dorfman] Fix markup in concrete.tex:
...
PyObject* o -> PyObject *o to be consistent with the
rest of the file
- Correct markup for Py_True
- Remove duplicate description of PyBool_Check
2004-08-07 20:19:24 +00:00
672d2ba773
Use LaTeX markup
2004-08-07 20:17:48 +00:00
fe80b63663
[Bug #991883 ] Document calling condition
2004-08-07 17:53:05 +00:00
e9ddfbb412
SF #989185 : Drop unicode.iswide() and unicode.width() and add
...
unicodedata.east_asian_width(). You can still implement your own
simple width() function using it like this:
def width(u):
w = 0
for c in unicodedata.normalize('NFC', u):
cwidth = unicodedata.east_asian_width(c)
if cwidth in ('W', 'F'): w += 2
else: w += 1
return w
2004-08-04 07:38:35 +00:00
2be406bd9f
let's avoid the extra nesting where reasonable
2004-08-03 16:02:35 +00:00
7fdd92f31f
Fix typo though
2004-08-02 21:56:33 +00:00
829d6c4138
Fix doubled word.
2004-08-02 08:36:07 +00:00
fd7dc5169c
Typo repair.
2004-08-02 04:30:37 +00:00
0c6199e8ed
Completed a sentence I left dangling.
2004-08-02 04:14:10 +00:00
cfd575d398
PyImport_ImportModule, PyImport_ImportModuleEx, PyImport_ExecCodeModule:
...
in failure cases, incompletely initalized module objects are no longer
left behind in sys.modules.
2004-08-02 03:46:45 +00:00
6d3db7000e
Add missing doc for Py_True/Py_False. Use the correct macro to define
...
Py_RETURN_FALSE and Py_RETURN_TRUE.
2004-07-29 02:16:04 +00:00
33ee76ae9e
A little boolean music if you please, maestro... (Not sure I have the
...
versionadded{} args quite right).
2004-07-28 14:17:04 +00:00
e03664ff22
Two typo fixes
2004-07-26 19:25:54 +00:00
fe0808382b
Fix an uncorrect function prototype.
...
Will backport to release23-maint.
BTW: Shouldn't it read PY_LONG_LONG instead of 'long long' ?
2004-07-23 14:49:52 +00:00
8ff9f9f4aa
Supply missing word in new datetime docs, aggravated by copy-paste-edit.
2004-07-17 01:42:26 +00:00
eda29306b3
Formalize that the Py_VISIT macro requires that the tp_traverse
...
implementation it's used in must give its arguments specific names.
2004-07-15 04:05:59 +00:00
aa6389e13b
Documented the new Py_VISIT macro to simplify implementation of
...
tp_traverse handlers. (Tim made me do it. ;)
2004-07-14 19:08:17 +00:00
8c5aeaa277
Implemented a new Py_CLEAR macro. This macro should be used when
...
decrementing the refcount of variables that might be accessed as a
result of calling Python
2004-07-14 19:07:35 +00:00
e45d5a3b00
Claifications: visit procs are supplied by the core, users aren't
...
expected to write their own. A NULL "object" must not be passed to
the visit callback. A non-zero return from a visit proc isn't
necessarily an error return (and it doesn't matter to the tp_traverse
code *what* it might signify, their only job is to return it).
2004-07-13 17:18:10 +00:00
183dabcd73
SF patch 986010: add missing doc for datetime C API, from
...
Anthony Tuininga.
This is a derived patch, taking the opportunity to add some organization
to the now-large pile of datetime-related macros, and to factor out
tedious repeated text.
Also improved some clumsy wording in NEWS.
2004-07-11 19:26:19 +00:00
711e7d97e4
Add PyArg_VaParseTupleAndKeywords(). Document this function and
...
PyArg_VaParse().
Closes patch #550732 . Thanks Greg Chapman.
2004-07-10 22:20:32 +00:00
d9dfe0213f
Remove a few elderly sentences
2004-07-10 13:48:54 +00:00
ff8113f8d0
Replace example with simpler alternative using PyGILState_{Ensure,Require). Can someone please confirm this change is OK?
2004-07-10 13:42:52 +00:00
371d98ab15
[Bug #987835 ] Add documentation from PEP 311. (Untested TeX code.)
2004-07-10 13:31:18 +00:00
ee5e4cd899
[Bug #984017 ] Incorrect prototype, fixed by Timothy Stranex
2004-07-07 13:07:47 +00:00
d88471f432
Change signatures for arguments to "s" and friends to be the proper ``const
...
char *`` instead of just ``char *``. Also added the mentioning of "const" in
some places where it was left out even when the signature already stated the
fact.
Closes bug #980925 .
2004-07-01 20:55:42 +00:00
6d3a0d2dff
[Bug #948970 ] Add PyExc_* symbols to index.
...
(I ran this through texcheck, but don't have LaTeX installed on this machine and therefore haven't
verified that the changes are accepted by LaTeX.)
2004-06-29 13:52:14 +00:00
ef82d2fdfe
Patch #923098 : Share interned strings in marshal.
2004-06-27 16:51:46 +00:00
9ddf40b4e1
SF patch 876130: add C API to datetime module, from Anthony Tuininga.
...
The LaTeX is untested (well, so is the new API, for that matter).
Note that I also changed NULL to get spelled consistently in concrete.tex.
If that was a wrong thing to do, Fred should yell at me.
2004-06-20 22:41:32 +00:00
d68d3ee3dd
Note that memory returned by PyBuffer_New is not specifically aligned.
...
Closes SF bug #472568 .
2004-06-08 02:58:50 +00:00
1b50b43bee
[Bug #936837 ] Add missing word
2004-06-05 19:00:55 +00:00
9bc4f2def3
Drop claims that Unicode always means UCS-2. Fixes #881861 .
2004-06-03 09:55:28 +00:00
974ed7cfa5
- SF #962502 : Add two more methods for unicode type; width() and
...
iswide() for east asian width manipulation. (Inspired by David
Goodger, Reviewed by Martin v. Loewis)
- Move _PyUnicode_TypeRecord.flags to the end of the struct so that
no padding is added for UCS-4 builds. (Suggested by Martin v. Loewis)
2004-06-02 16:49:17 +00:00
dd07e59eee
Document PyModule_AddIntConstant to take a long. Fixes #962471 .
...
Will backport to 2.3.
2004-06-02 12:45:27 +00:00
e440e47e91
Patch #957398 : Add public API for Generator Object/Type.
2004-06-01 15:22:42 +00:00
043fff0881
minor wording cleanup
2004-05-12 03:20:37 +00:00
e9c2ecfb96
Removed 'U' from the documentation for Py_BuildValue to bring it in line
...
with the elimination of 'U' in modsupport.c on 2000/04/28 (replaced
with 'u' and 'u#' per fdrake's comments).
2004-05-04 19:25:56 +00:00
1328b52c6f
Two new public API functions, Py_IncRef and Py_DecRef. Useful for
...
dynamic embedders of Python.
2004-04-22 17:23:49 +00:00
e5fced781b
SF bug #936827 : PyNumber_And() 's description
...
Fix typo.
2004-04-17 11:57:40 +00:00
34c43202eb
Emphasize the requirement that Python.h be included first more strongly.
...
Closes SF bug #837228 ; backporting for Python 2.3.4.
2004-03-31 07:45:46 +00:00
d0c3b26bd0
improve the very-high-level API docs (contributed by Jeff Epler)
...
Closes SF patch #798638 .
2004-03-25 15:44:56 +00:00
85309512ec
Remove note that PyErr_SetInterrupt() is obsolete; add comment about the
...
fact that it was marked obsolete but is still needed.
Closes SF bug #919299 . Someone else should backport this to Python 2.3.
2004-03-25 14:25:28 +00:00
5232f50b19
SF bug: #921927 : Fixed a typo/thinko spelling "parameter" as "paramter"
2004-03-25 08:51:36 +00:00
c69ebe8d50
Enable the profiling of C functions (builtins and extensions)
2004-03-24 21:57:10 +00:00
65d63424b4
Minor grammatical fixes.
2004-03-18 01:38:11 +00:00
9b976e6636
Extremely minor typo fixed.
2004-03-18 00:49:01 +00:00
c1e4f9dd92
Use a new macro, PySequence_Fast_ITEMS to factor out code common to
...
three recent optimizations. Aside from reducing code volume, it
increases readability.
2004-03-12 08:04:00 +00:00
70a30e8c94
markup correction
2004-02-17 04:17:36 +00:00
d3f4a1a00a
Patch #893566 : Document that tp_dealloc may be called from any thread.
2004-02-15 21:01:17 +00:00
8178a22e20
Documentation for PyDescr_NewClassMethod was missing - here's at least
...
the function prototype.
Already backported to release23-maint.
2004-02-09 10:47:11 +00:00
4cd5a08d8b
Fix small factual error.
2004-01-04 03:11:45 +00:00
7a700b873b
clean up indexing for None, NotImplemented
...
closes SF bug #820344
2004-01-01 05:43:53 +00:00
f72af655c5
At 2.2, the Py<type>_Check() family of API functions (macros) changed
...
semantics to include subtypes. Most concrete object APIs then had
a Py<type>_CheckExact() macro added to test for an object's type
not including subtypes.
The PyDict_CheckExact() macro wasn't created at that time, so I've added
it for API completeness/symmetry - even though nobody has complained
about its absence in the time since 2.2 was released.
Not a backport candidate.
2003-12-26 00:07:51 +00:00
13cd8898d2
The semantics of PyList_Check() and PyDict_Check() changed at 2.2, along
...
with most other concrete object checks, but the docs weren't brought into
line.
PyList_CheckExact() was added at 2.2 but never documented.
backport candidate.
2003-12-25 23:57:52 +00:00
5469324cde
Note that \var{ppos} values are not consecutive and should not be altered.
2003-12-13 19:48:41 +00:00
8f5cdaa784
* Added a new method flag, METH_COEXIST.
...
* Used the flag to optimize set.__contains__(), dict.__contains__(),
dict.__getitem__(), and list.__getitem__().
2003-12-13 11:26:12 +00:00
e180307c10
Fix missing paren.
2003-12-07 12:49:48 +00:00
2619c9ec89
SF patch #838938 : Typos in the docs (Extending/Embedding + Python/C API)
...
(Contributed by Florent Rougon.)
2003-12-07 11:40:17 +00:00
bc0f2ab9bb
Expose dict_contains() and PyDict_Contains() with is about 10% faster
...
than PySequence_Contains() and more clearly applicable to dicts.
Apply the new function in setobject.c where __contains__ checking is
ubiquitous.
2003-11-25 21:12:14 +00:00
28eae084bf
fix use of undefined markup
2003-11-10 14:48:48 +00:00
35d8360bf7
Document Py_RETURN_NONE.
2003-11-09 04:15:30 +00:00
5ce2fecf8e
Patch #837322 : Clarify owning, borrowing, stealing. Backported to 2.3.
2003-11-06 21:08:11 +00:00
9c7ed4c6df
Document that varlist can be NULL.
2003-10-26 17:20:07 +00:00
01a74b2fa1
Make CObjects mutable. Fixes #477441 .
2003-10-19 18:30:01 +00:00
95cf84a4f3
Patch #821093 : Fix various typos.
2003-10-19 07:32:24 +00:00
7decf5e5af
SF #822262 , Typo in Doc/api/intro.tex
2003-10-13 17:47:30 +00:00
cb2da43db8
Extended tuple's C API to include a new function, PyTuple_Pack() that is
...
useful for rapidly building argument tuples without having to invoke the
more sophisticated machinery of Py_BuildValue().
2003-10-12 18:24:34 +00:00
92016dcc91
SF 810242. Fix doubled word errors.
2003-09-22 15:27:11 +00:00
4ccf6e738e
fix \NULL with following space and no {}
2003-09-07 02:32:55 +00:00
77e0212b8a
Fix minor LaTeX bug of not ending a \NULL{} with the curly braces to get the
...
spacing correct in the output.
2003-09-07 02:22:16 +00:00
9bd308f67b
Fix doubled word typos.
2003-08-25 04:43:53 +00:00
f4bb1f946e
Fix typo.
2003-08-23 03:38:11 +00:00
f17d65da3a
SF patch#786531 'the the' typo. Contributed by George Yoshida
2003-08-12 00:01:16 +00:00
12c484dab8
SF patch #783807 : Clarify PySequence_Setitem ref counting
...
(Contributed by Jay T Miller.)
2003-08-09 04:37:14 +00:00
b93b3e790e
Error noted in email to python-docs: PyObject corresponds to
...
PyObject_HEAD, not PyObject_VAR_HEAD.
2003-07-07 17:20:40 +00:00
eec26f982a
Correct documentation of check interval - it's 100 by default, not 10 any
...
longer. Pointed out by Alex Martelli.
2003-07-02 21:38:34 +00:00
6595e15331
Document PyThreadState_SetAsyncExc().
2003-06-29 02:14:31 +00:00
847207acff
SF bug #719367 , string exceptions are deprecated
...
Remove references to string based exceptions in the doc.
2003-05-29 02:17:23 +00:00
2748a4aa7e
Typo fix.
2003-05-29 01:41:51 +00:00
5467d4c0e3
Patch #612627 : Add encoding attribute to file objects, and determine
...
the terminal encoding on Windows and Unix.
2003-05-10 07:10:12 +00:00
Raymond Hettinger
Georg Brandl
Michael W. Hudson
Neil Schemenauer
Thomas Heller
Brett Cannon
Fred Drake
Marc-André Lemburg
Tim Peters
Nicholas Bastin
Walter Dörwald
Martin v. Löwis
Andrew M. Kuchling
Hye-Shik Chang
Neal Norwitz
Skip Montanaro
Jim Fulton
Andrew MacIntyre
Greg Ward