63e40a598d
Do not use PyModule_GetDict().
...
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.
2002-04-12 19:08:31 +00:00
e77e5ef2af
Change example of retrieving & calling a Python function to not use
...
PyModule_GetDict(), which is also more flexible: it does not assume that the
"module" is a real module.
2002-04-12 19:04:17 +00:00
292da58a5c
Change the type of the tp_dealloc back to what it really is.
...
Change a section title to fit in better.
2002-04-12 18:28:08 +00:00
ee48519bc6
Modernize the minimal example of an extension type.
2002-04-12 16:17:06 +00:00
28de8d4b37
Add a (very) simple description of PyType_Ready().
2002-04-12 16:15:10 +00:00
0babc44ab2
Update the type of tp_dealloc.
2002-04-12 15:37:43 +00:00
e027d9818f
Add Raymond Hettinger's d.pop(). See SF patch 539949.
2002-04-12 15:11:59 +00:00
2a519f8fe6
Document __unicode__. Fixes #541245 .
2002-04-11 12:39:35 +00:00
81bdc93d2f
Explain octal escapes. Fixes #542226 .
2002-04-11 12:24:12 +00:00
17850f79a8
Add a name
2002-04-10 21:53:22 +00:00
2854c478be
Remove mention of 'pre' module
...
(2.2 bugfix candidate?)
2002-04-10 21:28:31 +00:00
e3c764b6c2
Document PyType_CheckExact(), PyType_IS_GC().
...
Update description of PyType_Check().
2002-04-10 17:52:52 +00:00
3b2625ff82
document all the valid encoding values
2002-04-10 04:37:09 +00:00
3c1ff5c766
When adding a name to the table of macros and environments, make sure it
...
is not already present. If it is, raise an exception, since that should not
happen in a well-defined conversion.
2002-04-10 04:20:33 +00:00
0047e16d1b
Added support for \csimplemacro and csimplemacrodesc.
2002-04-10 04:19:12 +00:00
4d61775a35
Started filling in the information about some of the basic types and macros
...
used to define Python objects.
2002-04-09 21:22:07 +00:00
375e30225e
Update to use the new \csimplemacro macro
2002-04-09 21:09:42 +00:00
79bf99c505
Document the \csimplemacro macro and the csimplemacrodesc environment.
2002-04-09 20:17:42 +00:00
19f827e765
Add \csimplemacro to parallel the csimplemacrodesc environment.
...
Fix a typo in the comments for csimplemacrodesc.
2002-04-09 20:16:47 +00:00
6b35370c65
Update docs for bool changes by Guido around April 6
2002-04-09 18:15:00 +00:00
eee12e9aba
Ignore an output directory for intermediates here as well.
2002-04-09 14:54:26 +00:00
fd867719bc
Fix typo: coverted --> converted. Reported by Francois Pinard.
2002-04-09 14:39:10 +00:00
77f4438f1a
Update the table of releases.
2002-04-08 21:57:31 +00:00
688357e035
Patch #512005 : getrusage() returns struct-like object.
2002-04-08 21:28:20 +00:00
bc82ab1c9f
Do not call "knee" a standard module, and point to the new location.
...
This addresses the issue in SF bug #515745 .
2002-04-08 05:22:30 +00:00
87bbdd3085
Minor clarification about what's actually promised for PyMem_Malloc(0).
...
I probably didn't do a correct thing for the LaTeX spelling of the
integer 1.
2002-04-06 09:14:33 +00:00
68304ccce3
Move reference material on PyArg_Parse*() out of the Extending & Embedding
...
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 .
2002-04-05 23:01:14 +00:00
9651198db4
Remove weird spacing in typeset version of the chapter head.
2002-04-05 19:54:19 +00:00
d15a0a05d3
Fix bug in command line handling, noted by Fredrik Lundh.
2002-04-05 18:09:22 +00:00
e03e1fe5cc
Add support for the "Aesop Meta Tag". Not widely used, but not a bad idea,
...
either.
2002-04-05 17:34:50 +00:00
d3dab2b192
Update doc to reflect Tim's changes to bool.
2002-04-05 02:21:09 +00:00
a8e5d432a5
Minor style change.
2002-04-04 22:56:57 +00:00
9b3e2ca74d
Add support for \textgreater, \textless.
...
Updated productionlist environment.
2002-04-04 21:39:42 +00:00
a2c2595024
Add a version annotation regarding the urlopen(proxies={...}).
2002-04-04 20:58:02 +00:00
5ca3a08cc0
The rest of the documentation for manual proxy configuration for a basic
...
urlopen().
This is part of SF patch #523415 .
2002-04-04 20:34:36 +00:00
d21670328c
Documentation for manual proxy configuration, by Andy Gimblett.
...
This closes SF patch #523415 .
2002-04-04 20:09:50 +00:00
e13602ee49
Mark the notice about the new development version of the docs as not needing
...
to be archived. Most of these are pretty bland. ;-)
2002-04-04 18:06:06 +00:00
2e1c09c1fd
Removed old Digital Creations copyright/license notices (with
...
permission from Paul Everitt). Also removed a few other references to
Digital Creations and changed the remaining ones to Zope Corporation.
2002-04-04 17:52:50 +00:00
ce5df49957
SF 539024, Fix broken link to numpy
2002-04-04 14:02:45 +00:00
243ea71669
Correct the descriptions of the PyObject_As*Buffer() return values.
...
This closes SF bug #539081 .
2002-04-04 04:10:36 +00:00
3a52ff6df4
Add empty section for bool
2002-04-03 22:44:47 +00:00
77f6a65eb0
Add the 'bool' type and its values 'False' and 'True', as described in
...
PEP 285. Everything described in the PEP is here, and there is even
some documentation. I had to fix 12 unit tests; all but one of these
were printing Boolean outcomes that changed from 0/1 to False/True.
(The exception is test_unicode.py, which did a type(x) == type(y)
style comparison. I could've fixed that with a single line using
issubtype(x, type(y)), but instead chose to be explicit about those
places where a bool is expected.
Still to do: perhaps more documentation; change standard library
modules to return False/True from predicates.
2002-04-03 22:41:51 +00:00
b81fbad9c0
Updated PEP link to point to the now-canonical site.
2002-04-03 02:52:50 +00:00
dbfe768f66
Update the PEP URL format to point to python.org.
2002-04-03 02:47:14 +00:00
103b548a76
Add a note warning against semicolons following PyObject_HEAD.
...
Minor cleanups.
2002-04-02 15:42:46 +00:00
45afd54c8f
Add an item
2002-04-02 14:25:25 +00:00
aee113d368
Add an experimental mechanism to support extending the pprint formatting.
...
Partly responds to SF bug #505152 .
2002-04-02 05:08:35 +00:00
4dfb7a81c1
Explain that os.spawn*() return the process handle on Windows.
...
Clarify that os.waitpid() on Windows takes a process handle, not a process ID.
This closes SF bug #537582 .
2002-04-01 23:30:47 +00:00
d764b0a484
There is no PyArg_ConvertTuple(); call it by the right name.
...
This closes SF bug #537511 .
2002-04-01 23:12:25 +00:00
d5a072f2eb
Fix up the documentation of the type codes to give both the C and Python
...
types for each code, and give the actual C types.
Clarified the support for slice operations and note when some TypeError
exceptions are raised.
This closes SF bugs 518767 and 536469.
2002-04-01 23:05:10 +00:00
88955cbe1f
Change reference to execframes to naming.
2002-04-01 21:34:28 +00:00
e604875b81
Restore a minimal definition of execution frame, since other parts of
...
the manual refer to it.
XXX Not sure that it belongs in this section, or that the concept is
particularly important for writing documentation. Perhaps references
to the frame should be removed entirely.
2002-04-01 21:33:55 +00:00
1824b59e89
Update programmer's note on nested functions.
2002-04-01 21:30:15 +00:00
f3255c8540
Reword explanation of global statement since an undeclared global is a
...
free variable and is subject to those rules.
2002-04-01 21:25:32 +00:00
f0c1f1badb
Note the sole case in which the ban on "from ... import *" within a
...
function is enforced.
2002-04-01 21:19:44 +00:00
15b68976da
Remove the following restriction:
...
Names bound by import statements may not occur in global
statements in the same scope.
Why not?
2002-04-01 21:18:02 +00:00
d09ed68aeb
Note that it is illegal to delete a cell variable.
...
Note that deleteing an unbound local will raise a NameError.
2002-04-01 21:15:14 +00:00
2225add242
Given lambda its own section, instead of burying it in boolean operators.
2002-04-01 21:05:21 +00:00
53ed917d3a
Update / simplify Identifiers section for nested scopes.
...
How do I create a cross reference to section 4.1?
2002-04-01 20:52:24 +00:00
e7d5773ed0
Update docs for nested scopes.
...
Replace section 4.1 with section A.3.
The new section 4.1 is titled "Naming and binding." It includes the
text of section A.3 augmented with some of the detailed text from the
old section 4.1.
The \dfn, \index stuff is probably wrong, but I tried.
Also update other parts of appendix A to mention that nested scopes
and generators are standard features.
2002-04-01 20:38:01 +00:00
f54519d9e4
Update to push the docs to python.org instead of python.sf.net.
2002-04-01 20:15:05 +00:00
f4dd65db1d
Copy section on generators from the 2.2 document with a bit of rewriting
...
Add an item
2002-04-01 19:28:09 +00:00
9da3efd120
Mention 2.2.1 in intro and in bug/patch counts
...
Fix two typos spotted by Joonas Paalasmaa
2002-04-01 19:22:34 +00:00
8392f36579
Update documentation of code objects.
...
Split the description of co_flags into two paragraphs. The first
describes the flags that are used for non-future purposes, where
CO_GENERATOR was added. The second describes __future__'s use of
co_flags and mentions the only one currently meaningful,
CO_FUTURE_DIVISION.
2002-04-01 18:53:36 +00:00
c9319b37a5
Minor adjustments.
2002-04-01 18:49:45 +00:00
26c49b66bb
Small fixes for description of function attributes.
...
func_closure is a readonly attribute.
Add \ttindex{} for func_closure.
Remove discussion of func_closure specific to 2.1.
2002-04-01 17:58:39 +00:00
fe5a5388c3
Use the right types for a couple of fields of the type structure.
2002-03-29 22:46:04 +00:00
0ffd14c9ea
Started updating information about defining attributes on types.
...
There's still a long way to go, but we're starting to see some real
content in the docs.
2002-03-29 22:45:28 +00:00
b1af6376e9
Mark a couple of types that had not been marked.
2002-03-28 23:46:41 +00:00
0f9a34da2c
Added comments for more entries of the type structure in the example
...
type implementation.
2002-03-28 23:45:22 +00:00
2ab0a10913
The new files included by \verbatiminput in newtypes.tex.
2002-03-28 23:32:53 +00:00
81b750d467
Move some of the longer example code to external fragments, and
...
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.
2002-03-28 23:12:09 +00:00
e9fba9188e
Added index entries.
2002-03-28 22:36:56 +00:00
00f712ee24
Extend \verbatiminput so that the typeset version provides the same appearance
...
as a verbatim environment. (The HTML version is already fine.)
2002-03-28 22:28:43 +00:00
8d62e94761
Minor wording change.
2002-03-28 21:06:17 +00:00
bb6bbc45c0
add exception class hierarchy. This should probably be done differently,
...
but at least the content is there.
2002-03-28 20:53:22 +00:00
31f8483eef
Allow a page break in a code longish example.
2002-03-28 20:19:23 +00:00
47cdf6fb6f
Add documentation on the hasfree data object.
2002-03-28 19:34:53 +00:00
e3a3ceb2b1
Minor consistency adjustments.
2002-03-28 12:40:45 +00:00
7bf9715a8b
Introduce two new flag bits that can be set in a PyMethodDef method
...
descriptor, as used for the tp_methods slot of a type. These new flag
bits are both optional, and mutually exclusive. Most methods will not
use either. These flags are used to create special method types which
exist in the same namespace as normal methods without having to use
tedious construction code to insert the new special method objects in
the type's tp_dict after PyType_Ready() has been called.
If METH_CLASS is specified, the method will represent a class method
like that returned by the classmethod() built-in.
If METH_STATIC is specified, the method will represent a static method
like that returned by the staticmethod() built-in.
These flags may not be used in the PyMethodDef table for modules since
these special method types are not meaningful in that case; a
ValueError will be raised if these flags are found in that context.
2002-03-28 05:33:33 +00:00
ed6a886d9f
Ignore new output directory.
2002-03-27 20:37:04 +00:00
2e64c34850
Expose C library's gettext. Fixes #516412 .
2002-03-27 18:49:02 +00:00
8a79727b53
add seealso referring to site module doc where people can learn how to
...
extend sys.path using .pth files.
2002-03-27 17:29:50 +00:00
9e38c100ab
fix a typo in PyErr_Format table and add row for 'p' format char
...
closes bug 534495
2002-03-27 13:42:50 +00:00
03594bbb0e
Fill in this document a bit, adding reminders of items that should be included
2002-03-27 02:29:48 +00:00
4e526feb6a
Add the "What's New" document to the index of HTML documents.
2002-03-26 20:29:11 +00:00
69f0a8e42f
The <link> to the stylesheet should include the type attribute.
2002-03-26 19:57:52 +00:00
3014086fbf
Wire up the makefile to more fully support the "What's New" documents.
2002-03-26 19:53:56 +00:00
9ac14decde
Wire in the "What's New" document.
2002-03-26 19:18:18 +00:00
03e1031d67
Add a starter for the next "What's New" document.
2002-03-26 19:17:43 +00:00
15fc72ce77
Make \url to force horizontal mode.
2002-03-26 19:14:41 +00:00
57f8e06e4f
Document the finditer() function and method.
...
This closes SF bug #520904 .
Explain that many of the escapes supported by string literals are also
supported by the RE compiler, and list which ones.
This closes SF bug #529923 .
2002-03-25 20:22:59 +00:00
3787c9d94c
Added description of binhex.Error.
2002-03-25 16:37:56 +00:00
1e962cb61b
document InvalidURL exception
2002-03-24 16:55:57 +00:00
ccbb0edf0e
Add local_hostname to SMTP.__init__().
2002-03-24 15:41:40 +00:00
194152845c
Fix example for PyErr_SetFromErrno() (need to pass exception type).
2002-03-23 20:57:11 +00:00
79f181395b
Add more example exceptions that unpickling can raise.
2002-03-22 22:16:03 +00:00
cf43004b83
Fix broken HTML in the head; this was reported by a user as causing Opera 6.01
...
to crash. The user has reported the problem to Opera, but we still should
generate something that passes for HTML.
2002-03-22 17:22:38 +00:00
e22d3dfcc1
Fix grammar
2002-03-21 12:58:54 +00:00
b25c2b0a4a
[Apply SF patch #504943 ]
...
This patch makes it possible to pass Warning instances as the first
argument to warnings.warn. In this case the category argument
will be ignored. The message text used will be str(warninginstance).
2002-03-21 10:38:40 +00:00
Fred Drake
Guido van Rossum
Martin v. Löwis
Andrew M. Kuchling
Skip Montanaro
Neal Norwitz
Tim Peters
Jeremy Hylton
Neil Schemenauer
Walter Dörwald