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
1abca4a515
SF# 522426, add doc for common parameter for filecmp.cmpfiles()
2002-03-20 18:55:09 +00:00
1268678395
Adjust some poor wording in the text that explains what events are used
...
for (reported by Keith Briggs).
Wrap some very long lines.
2002-03-19 14:37:44 +00:00
2f31d561d5
Clarify that copy_reg.pickle() is not intended for use with "classic" classes.
...
This was stated before, but a minor grammatical error made it difficult to be
sure of the meaning.
This closes SF bug #530143 .
2002-03-19 03:33:33 +00:00
f6eafc3fe1
Fix up unescaped tilde; reported by several people.
2002-03-18 16:47:14 +00:00
a8b663806b
Remove extra verb; reported by Detlef Lannert.
2002-03-18 16:45:01 +00:00
5c137c2251
Patch #495598 : add an -q (quiet) option to pycompile.
2002-03-18 12:44:08 +00:00
10acc8f9e2
added note that xmlrpclib won't marshal instances of subclasses of the
...
builtin types
2002-03-17 23:15:02 +00:00
587c98c863
Patch #430706 : Persistent connections in BaseHTTPServer.
2002-03-17 18:37:22 +00:00
8e0c82a35f
Fix stupid typo in example.
2002-03-16 14:01:12 +00:00
83d14c12a6
Markup error: braces not properly marked in dictionary display
...
grammer productions.
Fixes SF bug #520959 .
2002-03-16 06:35:54 +00:00
f275803fe9
Clarify the descriptions of the positive and negative lookbehind assertions.
...
Added examples of positive lookbehind assertions.
This closes SF bug #529708 .
2002-03-16 05:58:12 +00:00
0e4cd7f267
pdfTeX 0.13 and 0.14 do not agree on the name of the macro, and I will not
...
change the installed version on either of the machines I use to format the
docs. Instead, use a compatibility hack to support both versions. This is
also better for external users of the Python styles.
2002-03-16 04:52:36 +00:00
5381588073
Revise the markup related to the grammar productions to increase the
...
level of predictability. This is not really "good" markup, but is arguably
better than we had before.
This closes SF bug #523117 .
2002-03-15 23:21:37 +00:00
7fe80a1085
Make the release status obvious in the title area.
2002-03-15 22:38:16 +00:00
dc8d40717c
update text to refer to ServerProxy class in preference to Server, which is
...
only retained for backward compatibility with older versions of the library.
2002-03-14 17:35:25 +00:00
5d117472b4
Describe how to support the iterator protocol in extension types.
...
This closes SF bug #420851 .
2002-03-13 03:55:11 +00:00
e789ea19c1
Extend the list of special characters and magic markup used to produce them
...
to include various characters used in code samples, URLs, and other special
contexts.
This closes SF bug #525684 .
2002-03-13 02:48:24 +00:00
f171ad9d99
Change the way \textasciitilde is implemented so it works more consistently
...
(dropping tildes into data that still goes through LaTeX-like processing is
a bad idea).
2002-03-13 02:44:50 +00:00
6ccdccd35d
Add a note that Py_None needs the same reference count treatment as any
...
other PyObject *.
This closes SF bug #494007 .
2002-03-12 20:12:54 +00:00
f981617645
"level" keyword argument in example should be "stacklevel".
...
This closes SF bug #517684 .
2002-03-12 19:49:31 +00:00
8f01b680c8
Change Windows file.truncate() to (a) restore the original file position,
...
and (b) stop trying to prevent file growth.
Beef up the file.truncate() docs.
Change test_largefile.py to stop assuming that f.truncate() moves the
file pointer to the truncation point, and to verify instead that it leaves
the file position alone. Remove the test for what happens when a
specified size exceeds the original file size (it's ill-defined, according
to the Single Unix Spec).
2002-03-12 03:04:44 +00:00
314bae50b9
Documentation for PyObject_GetIter(), contributed by Greg Chapman
...
(with only minor changes by Fred).
This closes SF bug #498607 .
2002-03-11 18:46:29 +00:00
e38b7e8fe9
Make the extension manual format using the Makefile; recent changes broke
...
the dependency information.
2002-03-11 18:42:08 +00:00
fb05db2cae
file_truncate(): provide full "large file" support on Windows, by
...
dropping MS's inadequate _chsize() function. This was inspired by
SF patch 498109 ("fileobject truncate support for win32"), which I
rejected.
libstdtypes.tex: Someone who knows should update the availability
blurb. For example, if it's available on Linux, it would be good to
say so.
test_largefile: Uncommented the file.truncate() tests, and reworked to
do more. The old comment about "permission errors" in the truncation
tests under Windows was almost certainly due to that the file wasn't open
for *write* access at this point, so of course MS wouldn't let you
truncate it. I'd be appalled if a Unixish system did.
CAUTION: Someone should run this test on Linux (etc) too. The
truncation part was commented out before. Note that test_largefile isn't
run by default.
2002-03-11 00:24:00 +00:00
27761f39a5
Patch #500136 : Update Update ext build documentation. 2.2.1 candidate.
2002-03-09 10:06:14 +00:00
632bda3aa0
Add more explanation of how data_files is used (esp. where the files end up
...
in the installation and how that location is determined).
2002-03-08 22:02:06 +00:00
10b3eac278
[Bug #486527 ] Note that the caller has to ensure there are no control
...
characters in strings being passed via XML-RPC.
Fix some typos.
2.2.1 bugfix candidate.
2002-03-08 17:46:02 +00:00
02d2212c8e
Add entry for mac/libscrap.tex.
2002-03-08 03:18:19 +00:00
f3e6f06a45
I started writing more documentation on the Scrap module at one point, but
...
it is difficult to do without a Mac box to try things out on. This expands
on what was there only a little bit; hopefully someone with a Mac can work
on this as well!
2002-03-08 03:15:49 +00:00
a4f8313cbb
add SSL class submitted by Tino Lange
2002-03-08 01:53:24 +00:00
6cb64f9e46
"Shortcut" should be "short-circuit".
...
This closes SF bug #526277 .
2002-03-08 00:54:43 +00:00
da8a6dd072
Added missing version annotation for dict().
2002-03-06 02:29:30 +00:00
58fb237948
Add implementations for \textgreater and \textless, defined in (relatively)
...
recent versions of LaTeX2e but not support in LaTeX2HTML.
2002-03-05 04:04:06 +00:00
9479c958c5
Remove extra indenatation from sample interpreter session.
...
Remove whitespace from the middle of an inline RE example; it was OK for
the typeset formats, but LaTeX2HTML is more touchy about this.
2002-03-05 04:02:39 +00:00
a8e1d81bdc
add simple example of avoiding backtracking
2002-03-04 23:08:28 +00:00
29001ff234
Patch #523268 , #522027 : return enhanced tuples.
2002-03-01 10:47:37 +00:00
dbd55b3737
Patch #523268 , #522027 : return enhanced tuples.
2002-03-01 10:38:44 +00:00
9986633609
Patch 520694: arraymodule.c improvements:
...
- make array.array a type
- add Py_UNICODE arrays
- support +=, *=
2002-03-01 10:27:01 +00:00
494cdb6d78
Add 2002 to PSF copyrights.
...
Doc/README is odd; it assigns some copyright to the PSF in 2000, when
I didn't think it existed...
2002-02-27 13:29:46 +00:00
b6b2aa6c75
Fix error in explanation of the interaction between $ and MULTILINE mode.
...
Reported by Steve Alexander.
2002-02-25 18:56:45 +00:00
9f4341b3b0
SF bug #501591 : dir() doc is old
...
Bugfix candidate.
+ Updated dir() description to match actual 2.2 behavior.
+ Replaced the dir(sys) example with dir(struct), because the former
was way out of date and is bound to change frequently, while the
latter is stable.
+ Added a note cautioning that dir() is supplied primarily for
convenience at an interactive prompt (hoping to discourage its
use as the foundation of introspective code outside the core).
2002-02-23 04:40:15 +00:00
f8b1f2431b
Grammar tweak.
2002-02-22 21:24:32 +00:00
216cbca195
Typo: thsi -> this. Closes SF bug #521450 .
2002-02-22 15:40:23 +00:00
8371e840d2
Correct the refcount information for the PyWeakref_GetObject() function.
...
This closes SF bug #520087 .
2002-02-20 05:07:36 +00:00
ba902fda3c
SF #515041 , Update path for 2.3
2002-02-19 02:58:54 +00:00
e73ad2a21f
Use the standard expression for the availability statement for alarm().
2002-02-15 20:59:43 +00:00
8d1fdafd89
note that the alarm function is not available on Windows.
2002-02-15 20:36:19 +00:00
960d7a68d0
Added deprecatioon information for mac.xstat().
...
This closes SF bug #505150 .
2002-02-15 14:35:09 +00:00
928051fb26
The "%" character does not need to be escaped in verbatim environments.
...
This closes SF bug #517811 .
2002-02-15 04:12:59 +00:00
7bc6f7ac7b
Consistently use \textasciicircum to produce a ^ character.
...
LaTeX really falls flat on this one!
2002-02-14 15:19:30 +00:00
c121745fda
Update the instructions on reporting bugs to reflect that anonymous reports
...
are no longer accepted.
2002-02-04 21:43:08 +00:00
baf43c5036
When linking to an index page, explicitly name index.html instead of
...
using "./". The later does not work nicely when browsing docs on a local
disk (as in the installed docs on Windows).
2002-02-04 21:15:42 +00:00
210d3cca86
Update version number to match Include/patchlevel.h.
...
Make sure we clean up all the temp files craeted for the typeset formats.
2002-02-04 19:49:29 +00:00
375bbc306e
Update version number to match Include/patchlevel.h.
2002-02-04 19:48:25 +00:00
ab034fab03
Implement os.waitpid() for Windows, in a way that's compatible with Linux
...
where their capabilities intersect. Would be nice if people using non-
MSVC compilers (Borland etc) took a whack at doing something similar for
them (this code relies on the MS _cwait function).
2002-02-01 11:27:43 +00:00
c318260a71
added handle_error method description
2002-01-31 17:32:24 +00:00
c48a3ca161
Add new constants usable with os.popen() on Windows.
...
NOTE: this seems a mess wrt which symbols are available on which
platforms. I can't fix it, but I didn't add to it <wink>, and
included an XXX comment about names claimed to be available on
Windows that aren't. If anyone can figure out the whole ugly truth,
I'm sure a better organization will suggest itself.
2002-01-30 05:49:46 +00:00
c26467d53f
Revise cheeseshop example so that the order of the keyword output is
...
completely determined by the example; dict insertion order and the string
hash algorithm no longer affect the output.
This fixes SF bug #509281 .
2002-01-29 14:53:30 +00:00
ef180dc3d0
Document that get_referrers can return unreachable but uncollected objects.
...
Fixes #505453 .
2002-01-26 20:11:50 +00:00
744f67fb62
Add keyword.kwlist to the public API.
2002-01-24 16:38:53 +00:00
db2d3d1b3a
libkeyword.tex was missing from the list of dependencies for the
...
Library Reference.
2002-01-24 16:38:08 +00:00
ea3ceaa913
PyDict_Next: update doc to indicate that pkey and pvalue return values are
...
borrowed references.
2002-01-23 10:54:41 +00:00
a23bc42ad5
add missing return value info for PyDict_DelItem
2002-01-23 08:18:30 +00:00
aae728f292
Fix typo reported by François Pinard.
2002-01-21 16:09:18 +00:00
ac6dd0a817
Updated GNU info dir segment from Milan Zamazal.
2002-01-17 21:27:00 +00:00
826e98214b
Update email address.
2002-01-17 21:05:14 +00:00
d6bdb075ca
Update the list of output formats.
2002-01-17 12:35:20 +00:00
ac96868d2d
Consistency nits.
2002-01-17 04:51:55 +00:00
efff11b37c
Minor consistency nit.
2002-01-17 04:44:34 +00:00
8fbd4a3e78
That hasn't been my email address for a while!
2002-01-16 14:55:05 +00:00
4f3a62d9bc
There's no need for typechecks on the second and third argument of
...
new.instancemethod() -- the instancemethod object is now a perfectly
general container.
This fixes SF bug ##503091 (Pedro Rodriquez): new.instancemethod fails
for new classes
This is a 2.2.1 candidate.
2002-01-15 19:21:05 +00:00
3d62f8ca35
Fix a simple typo. Has this to be fixed also in other branches?
2002-01-14 08:37:39 +00:00
a55ffaeee9
Add a per-message fallback mechanism for translations.
2002-01-11 06:58:49 +00:00
1be6419871
Add fallback argument to translation(). Request fallbacks on install.
...
Fixes #500595 .
2002-01-11 06:33:28 +00:00
3e3eacb5fc
Fixed "u#" parser marker to pass through Unicode objects as-is without
...
going through the buffer interface API.
Added tests for this to the _testcapi module and updated docs.
2002-01-09 16:21:27 +00:00
7731ed47cb
Do not mask the name of a built-in function in example code.
...
Based on comment sent to python-docs.
2002-01-05 04:00:03 +00:00
5e74d36f9d
Fix indentation error in example from the Tkinter Life Preserver.
...
This closes SF bug #499505 .
2002-01-05 03:56:54 +00:00
d93d68bd13
Fix minor typo reported in SF patch #497951 .
2002-01-05 01:52:41 +00:00
c33e077838
SF patch #497420 (Eduardo Pérez): ftplib: ftp anonymous password
...
Instead of sending the real user and host, use "anonymous@" (i.e. no
host name at all!) as the default anonymous FTP password. This avoids
privacy violations.
2001-12-28 20:54:28 +00:00
089c7d1d5e
Another name; should be added to Python 2.2.1.
2001-12-27 18:40:18 +00:00
687bde9433
Added some missing index entries, noted by L. Peter Deutsch.
...
This should be included in Python 2.2.1.
2001-12-27 18:38:10 +00:00
7c9a53dfc0
Elaborate the descriptions for onecmd(), precmd(), and postcmd() so they are
...
useful.
2001-12-27 05:10:18 +00:00
fd7f115a0e
Fix wrongly-named formal parameters in three places: begin_y was used twice
...
instead of begin_y and begin_x for derwin(), subpad(), and subwin().
Reported for derwin() by Eric Huss.
Added class annotations for the window methods so they would be properly
described in the index.
2001-12-26 22:08:44 +00:00
7fa4ec5498
Added another name.
2001-12-26 22:08:35 +00:00
ab2dc1d730
Added index entries similar to some recommended by Skip, and used the word
...
"interpolation" in the text, to make the string formatting material easier to
find.
This closes SF bug #487165 .
Bugfix: this should be applied for Python 2.2.1.
2001-12-26 20:06:40 +00:00
3d422662ad
Make this do the right thing with entries which start with the percent sign,
...
in response to Skip's comments in SF bug #487165 .
Make use of string methods instead of string module functions in most places.
Add (and make the default) a way to collapse symbol entries into a single
"Symbols" section in the generated index. This is similar to what makeindex
does, but does not include entries beginning with an underscore.
2001-12-26 19:55:14 +00:00
ef338ec5f9
More index entries.
2001-12-26 19:48:43 +00:00
8b8fe288b3
Close an improperly-closed verbatim environment.
...
This closes SF patch #496215 .
Add a little more detail to the example that had not been closed.
Bugfix: this should be made part of 2.2.1.
2001-12-26 16:53:48 +00:00
39960f6ec9
Fix the erroneous availability annotation for s.makefile() from the last
...
checkin (my fault!).
Wrap some long lines and fix some markup inconsistencies.
2001-12-22 19:07:58 +00:00
87fa3aa12c
Add notes that fromfd() and s.makefile() are Unix-specific.
...
This fixes SF bug #495896 .
Fix up various markup consistency & style guide conformance nits.
2001-12-21 17:45:03 +00:00
09aa55a090
Doc changes on the trunk will not be in Python 2.2, so let's call it 2.2+.
2001-12-21 16:46:28 +00:00
bec5b362db
1.00 at last!
...
Describe super() very briefly
A few minor reformattings and wording changes
Set the release date (presumably tomorrow...)
2001-12-21 04:39:11 +00:00
5c7983113c
Add a reference to the signal module to the os.kill() description.
...
This closes SF bug #495609 .
2001-12-21 03:58:47 +00:00
dce2e1161a
Fix typo in httplib example.
...
This fixes SF bug #495221 .
2001-12-21 03:52:04 +00:00
23d45f4744
Fix up some examples in the tutorial so we don't contradict our own
...
advice on docstrings.
This fixes SF bug #495601 .
2001-12-20 23:54:56 +00:00
8c8e871530
Fix the availability statement for the spawn*() functions to reflect the
...
actual availability on Windows.
This fixes SF bug #495191 .
2001-12-20 17:24:11 +00:00
34a37b807a
Re-commit Ping's patch to the cgi and cgitb documentation, using the
...
right version this time. Thanks, Ping!
(This was from SF patch #494582 , "\index -> \indexii" version.)
2001-12-20 17:13:09 +00:00
5e08d10dd9
Update the documentation links
...
Remove reference to this being a draft
2001-12-20 16:33:45 +00:00
adc7df5778
Use the final patch/bug numbers
2001-12-20 16:04:24 +00:00
4b1b3bfac1
Add entry for the pydoc documentation.
2001-12-18 16:32:30 +00:00
96be564027
Add documentation for the pydoc module; contributed by Ka-Ping Yee.
...
This closes SF patch #494622 .
2001-12-18 16:31:44 +00:00
732299ff63
Add documentation for the help() built-in; contributed by Ka-Ping Yee.
...
This is part of SF patch #494622 .
2001-12-18 16:31:08 +00:00
e088970ce0
Merge in Ping's changes to the cgitb documentation, and add a version
...
annotation as well.
This closes SF patch #494582 .
2001-12-18 15:51:55 +00:00
0c0b5305ae
Mark the mpz module deprecated as of Python 2.2.
2001-12-16 01:54:55 +00:00
b9c0ef5db7
Update to reflect recently added markup.
2001-12-15 22:24:06 +00:00
c57772870b
Add a link to the mxNumber package.
2001-12-15 20:37:40 +00:00
b40501b05e
Add link to the gmpy project.
2001-12-15 18:37:24 +00:00
08d752cf28
Update to use the notice environment so a multi-paragraph note can be
...
appropriately marked.
2001-12-14 22:55:14 +00:00
591dd8f620
Update information about __del__() & reference cycles for CPython.
...
This partially fixes SF bug #492619 .
Fix a typo & use the new notice environment instead of (ab)using the \note
and \warning macros.
2001-12-14 22:52:41 +00:00
6ca33771f8
Add a new environment for whole-paragraph (or longer) notes & warnings.
2001-12-14 22:50:06 +00:00
dda7dcb3f7
Add a missing "cycle".
2001-12-14 21:19:08 +00:00
b062cb22d0
Work around the problem of spaces after a "}" being dropped by LaTeX2HTML if
...
they were represented by newlines in the document source.
Partially fixes SF bug #493243 .
2001-12-14 16:57:31 +00:00
e27f86820a
The valign attribute to control the vertical alignment of a table cell should
...
be on the <tr> element, not the <table> element.
Partially fixes SF bug #493243 .
2001-12-14 16:54:53 +00:00
e6965cd9f0
Bump version numbers for the trunk.
2001-12-14 16:45:04 +00:00
7b82271bb5
Reflect change of Digital Creations to Zope Corporation.
2001-12-14 16:42:56 +00:00
526c7a0101
Ensure that complex() only accepts a string argument as the first arg,
...
and only if there is no second arg.
This closes SF patch #479551 .
2001-12-13 19:52:22 +00:00
5f29319197
Replace the "Cookbook approach" with the approach documented in
...
PC/example_nt/readme.txt; this one does not rely on any external scripts.
This "fixes" SF bug #221671 and most of SF bug #225003 .
2001-12-13 17:20:32 +00:00
a0b767625b
Minor adjustments.
2001-12-13 04:25:37 +00:00
850d3980ab
Fix for
...
[ #429329 ] actual-parameters *arg, **kws not doc'd
2001-12-12 11:56:33 +00:00
5f443cb550
Added the iSilo documentation to the standard target for distribution files
...
for "online" (as opposed to typeset) formats.
2001-12-12 06:22:43 +00:00
8d0645cb84
Add a note about yield requiring a __future__ directive.
2001-12-12 06:06:43 +00:00
1529ef860e
Document that isleap() returns exactly 1 or 0, which is guaranteed by the
...
docstring.
This closes SF bug #485794 .
Additional (very) small details were added.
2001-12-12 05:40:46 +00:00
3a8e59ebe1
Clean up a sad sentence in the yield description.
2001-12-11 21:58:35 +00:00
e31e9cebc0
Document generators and the yield statement, avoiding implementation details.
2001-12-11 21:10:08 +00:00
be6dd3083c
Remove crufty whitespace in a block of index entries.
...
Minor, but generates slightly smaller HTML & makes it easier to see what's
happening when debugging the HTML.
2001-12-11 20:49:23 +00:00
54e6294197
A number of small adjustments.
2001-12-11 19:40:16 +00:00
145b479508
Added discussion of protecting against screwing up the exception state in
...
an object's deallocator, including an example of how to do this.
2001-12-11 19:28:22 +00:00
f582b82fe9
SF bug #491415 PyDict_UpdateFromSeq2() unused
...
PyDict_UpdateFromSeq2(): removed it.
PyDict_MergeFromSeq2(): made it public and documented it.
PyDict_Merge() docs: updated to reveal <wink> that the second
argument can be any mapping object.
2001-12-11 18:51:08 +00:00
c82bd7281f
Save a new version of the productionlist environment for safe-keeping; this
...
will be replaced shortly. See the comments for more details.
2001-12-11 18:47:36 +00:00
1d3e6c15ce
Fix whitespace in example of bad indentation: a comment indicated that one
...
line was not indented at all, so the example is no longer indented at all.
All of the errors being shown remain.
Typo: characteru --> character
2001-12-11 17:46:38 +00:00
cf72abab8c
Update link to the SAX homepage.
2001-12-10 18:10:37 +00:00
6048ce95a9
Added documentation for str.decode().
...
This closes SF bug #490823 .
2001-12-10 16:43:08 +00:00
146483964e
Patch supplied by Burton Radons for his own SF bug #487390 : Modifying
...
type.__module__ behavior.
This adds the module name and a dot in front of the type name in every
type object initializer, except for built-in types (and those that
already had this). Note that it touches lots of Mac modules -- I have
no way to test these but the changes look right. Apologies if they're
not. This also touches the weakref docs, which contains a sample type
object initializer. It also touches the mmap test output, because the
mmap type's repr is included in that output. It touches object.h to
put the correct description in a comment.
2001-12-08 18:02:58 +00:00
73f0a4ecd7
Script to generate the table of distribution packages, plugging in the size
...
information automatically.
2001-12-08 00:26:07 +00:00
f9d580346b
Add change notes where im_class is discussed, since the exact meaning changes
...
with Python 2.2.
2001-12-07 23:13:53 +00:00
b62f0e1a7b
Correct the description of im_class. (Fred, this is changed in 2.2.
...
Should this be labeled as changed? How?)
2001-12-07 22:03:18 +00:00
7961930595
Revise description of dumbdbm.open() to reflect that the flag argument is
...
ignored and that mode was ignored before Python 2.2.
This closes SF bug #490098 .
2001-12-07 21:56:13 +00:00
8b7bb7a0f2
Describe the behavior of the read() method when the list of filenames
...
includes files that do not exist, explain the intended use of the interface,
and show how to ensure an expected file really exists.
This closes SF bug #490399 .
2001-12-07 21:35:57 +00:00
c6259d73c2
Another name.
2001-12-07 18:27:38 +00:00
44b3f76adf
More info about the cycle detector.
2001-12-07 17:57:56 +00:00
874c4f0f99
Trivial spelling repair on new cyclic garbage text.
2001-12-07 17:51:41 +00:00
024e647972
Added more information about reference counting limitations and the cycle
...
detector.
This closes SF bug #484950 .
2001-12-07 17:30:40 +00:00
038215ab0c
Use an immutable tuple for __slots instead of a mutable list
...
Bump version number
2001-12-07 14:22:13 +00:00
b404145936
s/it/if/ in descriptions of spawn mode argument.
2001-12-06 23:37:17 +00:00
c7cb69263d
For ratecv, document that None should be the initial state argument (when
...
I was squashing spurious overflows in the implementation, I got hung up
on this point).
2001-12-06 23:16:09 +00:00
32a3587345
Document that PyString_FromString() cannot take NULL as a parameter.
...
This closes SF bug #489872 .
2001-12-06 20:38:15 +00:00
22d35a7337
[Bug #459270 ] Fix incorrect filename for system-wide config file
2001-12-06 16:34:53 +00:00
a16433b14e
Re-enabled debugging prints in poplib & documented the set_debuglevel()
...
method.
This closes SF patch #486079 .
2001-12-05 22:37:21 +00:00
d761662b66
asyncore.loop() description contributed by Skip Montanaro.
...
This closes SF bug #489513 .
2001-12-05 21:37:50 +00:00
c2f496a138
Add a note to the description of the interaction between the softspace
...
attribute of file objects, the print statement, and other file operations.
This closes SF bug #484857 .
Fix minor markup nits.
2001-12-05 05:46:25 +00:00
39368c1053
Added documentation of the sendall() method, and a note to the send() method
...
that it does not guarantee that all data is sent.
This closes SF patch #474307 .
2001-12-05 05:25:59 +00:00
d2a557e51e
Added entry for the "cgitb" module docs.
2001-12-04 22:48:17 +00:00
6e70e8b401
Documentation for the "cgitb" module.
2001-12-04 22:47:42 +00:00
4ed6be7107
Import the keyword module instead of relying on our own list of
...
reserved words. No longer need to import string.
2001-12-04 20:39:36 +00:00
41c6719fe4
Put the keywords back in alphabetical order. Apparently somebody
...
didn't use reswords.py, as the comment clearly states. :-(
2001-12-04 20:38:44 +00:00
ecd8157a2c
Include a warning that scripts should not have the same name as standard
...
modules, or the module cannot be properly imported. (Based on a suggestion
sent to python-docs.)
Update the displayed dir() of the sys and __builtin__ module with Python 2.2.
2001-12-04 19:47:46 +00:00
6016dbecca
Talk about str() in the discussion of string representations of values, and
...
give examples for which str() and repr() yield different results.
This closes SF bug #485446 .
2001-12-04 19:20:43 +00:00
bb7775a6ae
Fix SF bug #479967 : Appearantly I broke something that made the index
...
insertion work. This fix makes things at least somewhat more explicit, and
adds a little sanity checking (and verbosity!) to
add_bbl_and_idx_dummy_commands().
2001-12-04 17:03:54 +00:00
97e3201220
Add a note that the rgbimg module is only built on 32-bit machines (prompted
...
by a question to webmaster).
Re-wrapped a long line.
2001-12-04 16:49:00 +00:00
b48b6d0737
Remove meaningless comment.
2001-12-04 16:32:04 +00:00
db5a93cd6a
Update docs to reflect new compile() and compileFile()
2001-12-04 02:48:52 +00:00
b38784e4a0
Slightly improved indexing for the string-% operator, thanks to comments
...
from Skip Montanaro. There is one weirdness in the final index for HTML, but
that is low priority.
2001-12-03 22:15:56 +00:00
fcf94681ed
Update lambda description to reflect nested scopes. This was noted by
...
Andrew Koenig.
2001-12-03 21:47:37 +00:00
1a76386194
Added documentation on the ScrolledText module.
2001-12-03 21:18:30 +00:00
c54fc3179f
Oops! Forgot the value parameter.
2001-12-03 20:58:29 +00:00
9455df2a5a
Add __delete__ method of properties
...
Reflow paragraph
2001-12-03 20:55:37 +00:00
1da50f6c6e
Add a scalar product to the example list comprehensions based on a suggestion
...
sent to python-docs.
2001-12-03 18:54:33 +00:00
5172adca81
Minor clarification of the zip() description, based on a comment sent to
...
python-docs.
2001-12-03 18:35:05 +00:00
14f5c5fa01
Make no assumption about how modules are built when referring to them; this
...
can vary by platform and installation.
Based on suggestion to python-docs.
2001-12-03 18:33:13 +00:00
1722e4a952
Re-word the intro slightly to avoid reader misunderstanding: strings are not
...
mutable! We do not want to shock anyone.
This closes SF bug #483805 .
Re-factor so that the description of the "access" keyword parameter is not
repeated in both the descriptions of mmap(). Also, only make sure the first
description of mmap() appears in the index. The the index link is followed,
the first is now used to locate the page on the screen; chances are really good
both will be visible. This avoids the problem that the index entry for the
second is selected and the first version is not visible, making the reader
consider that mmap() is not available on Windows.
2001-12-03 18:27:22 +00:00
551ffae30c
Clarify that the Python runtime may behave mysteriously when an exception
...
is not handled properly.
This closes SF bug #485153 .
2001-12-03 17:56:09 +00:00
3570551d6f
Remove most references to __members__ and __methods__, leaving only one pair
...
of references that now state that these attributes have been removed,
directing the reader to the dir() function.
This closes SF bug #456420 .
2001-12-03 17:32:27 +00:00
f07125ee53
PyErr_Format() does not return a new reference; it always returns NULL.
...
This closes SF bug #488387 .
2001-12-03 16:36:43 +00:00
b22c6720aa
Clean up some material that is not part of the standard documentation.
...
This closes SF bug #487308 .
2001-12-03 06:12:23 +00:00
c7b78381da
Another name.
2001-12-02 15:13:35 +00:00
d745b4e7a4
Add reference to the "String Methods" section to make that information
...
easier to find. Based on the comment from Steve Alexander on the
zope-coders mailing list.
2001-12-02 15:10:46 +00:00
381832ead5
Drop xmllib in favor of SAX.
2001-11-30 19:30:03 +00:00
1e53fa7907
Add a couple of entries to the whitespace-cleanups table.
2001-11-30 19:25:39 +00:00
0467775715
Add description of tkCommonDialog.
2001-11-30 19:24:49 +00:00
95e33f03ba
Added two new conversion specifications.
2001-11-30 19:06:18 +00:00
10cd315963
Change the chapter title to reflect the Tk affinity.
...
Use the new seealso* environment in the section pointing out other GUI
toolkits.
2001-11-30 18:17:24 +00:00
5ed35fd149
Add a new environment in the Python docs markup: seealso*. This is similar
...
to seealso, but does not add the "See also:" header or put the content in a
box in the HTML version.
Updated the description of \seeurl to better indicate when it should be used;
the old description was written before we had \seetitle.
2001-11-30 18:09:54 +00:00
89d63cc450
Minor adjustments to markup for the getDOMImplementation() description.
2001-11-30 16:58:15 +00:00
bd34b6bc3d
Added the convenience constants that are present in PyXML to make these
...
more similar.
2001-11-30 15:37:33 +00:00
38f3b72f9f
Updated documentation for the new httplib interface, by Kalle Svensson.
...
This closes SF bug #458447 .
2001-11-30 06:06:40 +00:00
454af89712
Update the signature of PyFile_WriteString().
2001-11-29 22:42:59 +00:00
44b6f84e56
More information about Tix support, contributed by Mike Clarkson.
2001-11-29 21:09:08 +00:00
6995bb61b6
Various cleanups & markup fixes, mostly relating to the stat and statvfs
...
result object changes.
2001-11-29 20:48:44 +00:00
ed0a71911c
Neil Schemenauer suggested a small improvement to one of the example REs.
2001-11-29 20:23:14 +00:00
389aa17ad3
writeline() --> writelines()
...
This closes SF bug #487147 .
2001-11-29 19:04:50 +00:00
1cec7fab1d
New section of regular expression examples contributed by Skip Montanaro,
...
with some extensions and changes from me.
This closes SF patch #472825 .
2001-11-29 08:45:22 +00:00
92024d1a99
Clarify the description of the creation of an owned reference from an API
...
function.
This closes SF bug #486657 .
2001-11-29 07:16:19 +00:00
99181ac64e
Add an index entry for the discussion of PyEval_CallObject().
...
This is related to SF bug #485165 .
2001-11-29 05:02:34 +00:00
ea4d2c0241
A few small changes:
...
- Change PREFIX to PREFIXES, which contains a sequence of prefix strings.
This is useful since we want to look for both Py and PY.
- Wrap a long line.
- Collect struct tags as well as typedef names. Since we generally only
use one of the other, that improves coverage.
- Make the script executable on Unix.
This could use a better approach to determine if a symbol is documented,
and could easily avoid keeping the massive string in memory. That would
take time to actually write more code, though, so we'll bail on that
for now.
2001-11-29 04:30:46 +00:00
5107b4cf5f
Re-arrange the modules in the "Internet Data Handling" chapter to try to
...
achieve a more sensible organization.
2001-11-28 07:50:45 +00:00
6a6bb1828b
Clarify that on some systems, lockf() using LOCK_EX requires that the file
...
is opened for writing; this closes SF bug #485342 .
Added notes that file objects are also accepted in the place of file
descriptors.
2001-11-28 07:48:32 +00:00
48704ee478
Add synopsis for the SimpleXMLRPCServer module; used in the chapter-level
...
list of modules.
2001-11-28 07:32:53 +00:00
c37b65ee10
Clean up some markup cruft. A number of the macros that take no
...
parameters (like \UNIX) are commonly entered using an empty group to
separate the markup from a following inter-word space; this is not
needed when the next character is punctuation, or the markup is the
last thing in the enclosing group. These cases were marked
inconsistently; the empty group is now *only* used when needed.
2001-11-28 07:26:15 +00:00
beafc795df
Typo, spotted by Fredrik Lundh.
2001-11-26 21:46:53 +00:00
b03d0cc45e
Typo, spotted by Detlef Lannert.
2001-11-26 21:39:40 +00:00
fcb05ab512
Tk-related modules should no longer be listed here.
2001-11-26 21:38:50 +00:00
2744f43f71
Fix typo, extra markup constructs.
...
This closes SF bug #485252 .
2001-11-26 21:30:36 +00:00
cd8474e6a2
Add documentation for the PyCell* APIs.
2001-11-26 21:29:17 +00:00
ccf04658b0
Correctly create new-style classes in the examples
...
Mention change to _PyTuple_Resize
2001-11-26 18:15:44 +00:00
560da62fc7
Rename get_referents to get_referrers. Fixes #483815 .
2001-11-24 09:24:51 +00:00
27ae311864
Avoid trailing blank lines in the output.
2001-11-19 05:28:29 +00:00
00c96aeba6
Adjust input pre-processing so that a comment on the last line does not
...
break the processor; this will do the right thing.
2001-11-19 05:27:40 +00:00
e70dbe0fc5
Update the platform notes for the CGIHTTPServer module; it works on more
...
platforms now, and has since Python 2.0.
This closes SF bug #482943 .
2001-11-19 05:16:35 +00:00
63c4f907a9
Another name...
2001-11-19 04:35:58 +00:00
7064d3b581
Fix the default value for feature_namespaces, per discussions on the XML-SIG
...
mailing list. This causes the docs to match the default implementation.
2001-11-19 04:34:50 +00:00
69ab5836ae
Paul Rubin reminds me that of course a class's constructor /could/ get
...
called, if the pickler found a __getinitargs__() method.
2001-11-18 16:24:01 +00:00
ebbd14d7c2
Clarified a couple of issues for the startElement*() handlers:
...
- the attrs value may be re-used by the parser, so the implementation
cannot rely on owning the object.
- an element with no namespace encountered in namespace mode will have a URI
of None, not "" (startElementNS() only).
Fixed a couple of minor markup issues as well.
2001-11-18 04:58:28 +00:00
af0a883041
Relatively large expansion of the docs for gc.garbage.
2001-11-18 04:51:17 +00:00
ef6373a4f6
Exhibit good form in C code: always provide docstrings in method tables, and
...
always fill in all slots of table entries.
Fixed a few minor markup errors.
2001-11-17 06:50:42 +00:00
50ecc15d05
Add omitted word for clarity.
2001-11-17 06:39:18 +00:00
0c0565dd7f
Toughen up the security warnings a bit.
2001-11-16 22:28:17 +00:00
5e17d20743
Add a clarification that the email package always deals in native line
...
endings, and that it is smtplib's job to convert those to RFC 2821
line endings when sending the message.
2001-11-16 22:16:04 +00:00
dd2487d759
Post-release bumps. Do *NOT* merge into the 2.2b2 branch.
2001-11-16 17:34:38 +00:00
666ca80b63
Clean up some markup a little bit more. Make this work with the PDF format,
...
which is a little more strict than the other formats on some things (fixable,
but not tonight).
2001-11-16 06:02:55 +00:00
5545219bf6
Document the urlsplit() and urlunsplit() functions.
2001-11-16 03:22:15 +00:00
c66ff203bb
Switched a couple of sections around.
...
Cleaned up some markup nits.
Add a few more of the Tk-related modules to the list of modules.
2001-11-16 01:05:27 +00:00
69b2d75fc7
A few minor updates to make it clear(er) that pickle should be used
...
instead of marshal for object serialization.
Fred, please proofread!
2001-11-15 23:55:12 +00:00
f595fd975d
A massive rewrite affecting both the pickle and cPickle module
...
documentation. This addresses previously undocumented parts of the
public interfaces, the differences between pickle and cPickle,
security concerns, and on and on.
Fred please proofread!
2001-11-15 23:39:07 +00:00
d44e7ad702
Minor updates to add more pointers to the pickle documentation, and to
...
clarify some of the interface.
2001-11-15 23:37:26 +00:00
fd4f069b12
The turtle docs will be moving to another location in the Tkinter chapter.
2001-11-15 22:10:46 +00:00
482b9a8c0c
Clean up the descriptions of multi-signature functions so we do the right
...
thing in the index.
2001-11-15 20:41:03 +00:00
bc1491f60f
Thanks for the Tkinter chapter, Mike!
2001-11-15 17:26:10 +00:00
53556861df
Add entries for the new Tkinter chapter.
2001-11-15 17:25:29 +00:00
7cf4e5b329
Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter
...
Life Preserver" by Matt Conway.
2001-11-15 17:22:04 +00:00
e1d4ad3a31
Finally commit the font changes that have been live on the development site
...
for a month or more.
2001-11-14 22:35:59 +00:00
9c7a07f7a4
Bump release number & date.
2001-11-14 22:28:26 +00:00
1336e99054
Fred observes that the typo was not the only problem with this sentence.
2001-11-14 21:38:13 +00:00
4a98f70a09
typo
2001-11-14 21:32:27 +00:00
5ebfd36afa
CVS patch #477161 : New "access" keyword for mmap, from Jay T Miller.
...
This gives mmap() on Windows the ability to create read-only, write-
through and copy-on-write mmaps. A new keyword argument is introduced
because the mmap() signatures diverged between Windows and Unix, so
while they (now) both support this functionality, there wasn't a way to
spell it in a common way without introducing a new spelling gimmick.
The old spellings are still accepted, so there isn't a backward-
compatibility issue here.
2001-11-13 23:11:19 +00:00
64cdb48c80
No need to preprocess the header files - use ctags -I flag instead to
...
remove DL_IMPORT.
2001-11-12 12:52:01 +00:00
bfeeeee851
Fix obvious typos.
2001-11-12 07:46:31 +00:00
94ead57dc3
Added version annotations, remove hard tabs.
2001-11-09 23:34:26 +00:00
89c3a22a27
Add PyObject_CheckReadBuffer(), which returns true if its argument
...
supports the single-segment readable buffer interface.
Add documentation for this and other PyObject_XXXBuffer() calls.
2001-11-09 21:59:42 +00:00
da4ffeecf5
No need to have documentation for a module which not accepted in the library.
2001-11-09 21:45:55 +00:00
3b0c82a2f1
Updated the documentation for formatdate().
2001-11-09 17:08:13 +00:00
3988574075
Remove my name, probably bad style.
2001-11-09 17:04:43 +00:00
3e77423a64
Script to print undocumented symbols found in Python header files.
2001-11-09 16:50:35 +00:00
30bd666c35
Cleaned up some markup stupidity and a usage problem reported by Detlef
...
Lannert. Added descriptions of HTTP_PORT and HTTPS_PORT.
2001-11-09 05:03:05 +00:00
399bc8c281
Fix a variety of typographical, grammatical, and clarity problems reported
...
by Detlef Lannert.
2001-11-09 03:49:29 +00:00
0b66310476
When referring to a formal parameter from the description, use the name given
...
with the signature, not an ad hoc abbreviated form.
2001-11-07 06:28:47 +00:00
59bfe280f5
Another name!
2001-11-07 06:23:27 +00:00
66ded524ba
apply() documentation: Remove a detail about the implementation that does
...
not affect the API. Clean up the text about call syntax apply() is
equivalent to. Based on comments by Thomas Guettler.
2001-11-07 06:22:25 +00:00
1a670c8414
Adjust the module synopsis to avoid margin overruns in the PDF format.
2001-11-06 22:14:35 +00:00
10b81ce4e5
A variety of small cleanups, including one to avoid a margin overrun in the
...
PDF version.
2001-11-06 22:13:19 +00:00
5976816698
Remove stray quotes; probably left over from conversion from docstrings.
2001-11-06 22:11:34 +00:00
806d332f02
Remove extra period.
2001-11-06 22:10:47 +00:00
1f774b062e
Update obsolete e-mail address, and remove myself as a module author
2001-11-05 21:34:36 +00:00
4794f0b234
Update obsolete e-mail address
2001-11-05 21:31:33 +00:00
47ccfe2d8f
Remove obsolete e-mail address
2001-11-05 21:31:15 +00:00
f010df4ee5
Update URL, and remove e-mail address reference (readers can get it from
...
the Web page)
2001-11-05 21:30:10 +00:00
10f9c075b9
Remove obsolete e-mail address
2001-11-05 21:25:42 +00:00
2bb077f630
Finally fleshed out the examples section with 4 code samples! Some of
...
my own doing, some originally written by Matthew Dixon Cowles.
2001-11-05 17:50:53 +00:00
c44403995e
Remove email*.tex subsections; they're all \input by email.tex
2001-11-05 01:55:43 +00:00
43dc1fc926
Minor grammar and typo fixes
2001-11-05 01:55:03 +00:00
169ded0d68
Finish SF patch 477059: __del__ on new classes vs. GC.
...
Just doc and NEWS here, about the change in gc.garbage meaning.
2001-11-03 19:57:21 +00:00
7533587d43
Improved error msg when a symbolic group name is redefined. Added docs
...
and NEWS. Bugfix candidate? That's a dilemma for Anthony <wink>: /F
did fix a longstanding bug here, but the fix can cause code to raise an
exception that previously worked by accident.
2001-11-03 19:35:43 +00:00
bc4a1c2588
[Patch #476612 ] Change docs to describe PEP247 interface
2001-11-02 21:44:09 +00:00
622087a3ed
Fix stupid bug recently introduced for DVI version of the docs (used to
...
generate PostScript).
2001-11-02 20:53:19 +00:00
d9272d6f11
Add deprecation notice to statcache.
2001-11-02 20:20:19 +00:00
67bd68392c
Make sure there are no weird nesting behaviors; the PDF version will not
...
format if there are (building the "bookmarks" for the reader breaks).
2001-11-02 19:41:23 +00:00
3808045d00
Correct misspelling of "separate" in two places.
...
This closes SF bug #476898 .
2001-11-01 19:48:01 +00:00
2dab9c7d9b
Fix markup typo
2001-10-31 13:16:10 +00:00
bbde5880a5
Add paragraph about difflib suggested by David Goodger
...
Bump version number
2001-10-31 13:13:36 +00:00
72a7fb78cb
Fix grammar error
2001-10-30 22:18:21 +00:00
433b5c4d34
Rewrites and additions resulting from today's feedback
2001-10-30 21:36:04 +00:00
345b8df2c4
Always use --dvips-safe when generating HTML for the standard documentation
...
since we do not have anything that causes dvips to be run except when
PostScript is specifically requested, which is a separate target.
2001-10-30 16:28:46 +00:00
3ce28e4bd0
Add a new option, --dvips-safe, which sets the $DVIPS_SAFE option in
...
LaTeX2HTML. This is not safe to do in general (for the reasons LaTeX2HTML
protects against dvips to begin with), but is safe if we do not actually
need to run dvips. Note that we also assume it is safe if the user
specifically requests PostScript generation. See the comments for further
explanation.
2001-10-30 16:09:51 +00:00
7aa63c245f
Various minor rewrites
...
Bump version number
2001-10-30 14:35:03 +00:00
7cc13de554
Corrections noted by Michael McLay
2001-10-30 14:22:11 +00:00
99de218cfc
Promote file objects out of the "Other Objects" category, so they become
...
visible in the table of contents.
2001-10-30 06:23:14 +00:00
b4ea9d0502
Promote built-in functions to come before built-in types.
2001-10-30 06:22:02 +00:00
003047a5f2
Mention the new file() builtin in the section on file objects.
2001-10-30 05:54:04 +00:00
a427a2b8d0
Rename "dictionary" (type and constructor) to "dict".
2001-10-29 22:25:45 +00:00
e59feb5edc
Revise the PDF support in the LaTeX style sheet. This still isn't quite
...
right, but the tests for whether we are generating PDF are a bit more
readable, and some unnecessary indirection has been removed.
2001-10-29 21:02:28 +00:00
1117d930fa
dictionary -> dict
2001-10-29 20:37:47 +00:00
4f9e220e7f
Fix two typos noted by Jens Quade
...
Bump version number
2001-10-29 18:09:42 +00:00
589abb7212
Add additional information on exceptions from time.mktime() and related to
...
improper time tuples passed to various functions. Based on comments from
Andreas Jung.
2001-10-29 18:01:24 +00:00
1b58bff8a0
More refcount information.
2001-10-29 17:43:14 +00:00
b0109ffb3b
Ignore all *.tex files in the typesetting output directories since there are
...
a bunch of them now.
2001-10-29 17:42:17 +00:00
520b0093db
Make sure we generate versions of each file in the Python/C API manual with
...
reference-count annotations; this is needed for the typeset forms of the
manuals.
2001-10-29 17:40:40 +00:00
2836907bbb
Fix some markup errors noted by MH
...
Use attribute assignment to illustrate __slots__ raising an error
2001-10-29 15:47:33 +00:00
b0c079e3e5
PyObject_CallFunctionObArgs() ---> PyObject_CallFunctionObjArgs()
...
PyObject_CallMethodObArgs() ---> PyObject_CallMethodObjArgs()
2001-10-28 02:39:03 +00:00
cf31d5d5d0
Fill in remaining XXX spots
...
- Describe UnpackTuple()
- Credit __unicode__ to MAL
Use \pep macro everywhere in body text.
(Listening to "The Great Gate of Kiev" -- appropriately triumphal
music for this check-in...)
2001-10-26 20:37:55 +00:00
e21e2bb121
Fix up a number of small problems with the DOM documentation.
...
There's still a lot to do, but it's better now.
2001-10-26 20:09:49 +00:00
b83769cb82
Finish off the type/class section; I don't think there's much else
...
to be covered in an overview article like this.
2001-10-26 20:07:03 +00:00
41cf5e0069
Remove unused variable.
2001-10-26 19:50:26 +00:00
ef428a292a
Explain what [].insert() does when the target index is negative.
2001-10-26 18:57:14 +00:00
d5be3b75dd
Add notes pointing out that these classes are kept for backward compatibility
...
and suggeest that new code that does not require compatibility with older
Python versions subclass dictionary, list, or str.
2001-10-26 18:37:27 +00:00
7408da54e2
Many, many small fixes and improvements, most suggested by Detlef Lannert.
2001-10-26 17:40:22 +00:00
c44e9eca66
Added docs for PyObject_CallFunctionObArgs() and PyObject_CallMethodObArgs().
...
Minor cleanups & markup consistency fixes.
2001-10-26 16:38:38 +00:00
81c7aa2c7b
Added refcount data for PyObject_CallFunctionObArgs() and
...
PyObject_CallMethodObArgs().
2001-10-26 16:29:22 +00:00
ef7d08a661
Some style changes and typo fixes.
2001-10-26 15:04:33 +00:00
fb6499fd9c
Clean up the tables of child links generated by stock LaTeX2HTML so we get
...
consistent (lack of) vertical space between sections, and remove some of the
unnecessary cruft that was added in (finally we get to *remove* something
that got generated!).
2001-10-26 14:16:23 +00:00
de3d060eb2
Typo: destuction --> destruction
...
Reported by Thomas Heller.
2001-10-26 11:27:54 +00:00
1fc240e851
Generalize dictionary() to accept a sequence of 2-sequences. At the
...
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).
2001-10-26 05:06:50 +00:00
af07b2c34f
Add yet more markup that let's a stylesheet pick out a small bit of the
...
presentation. This is acceptable since it only occurs in the formatted
output and does not affect the document markup.
2001-10-26 03:09:27 +00:00
7f10cce4c1
Enforce a bit of markup consistency.
...
When describing a Boolean return value, use "true" and "false" instead of
"1" and "0".
Style-guide conformance: no "iff" -- to obscure for many readers. ;-(
2001-10-26 03:04:23 +00:00
3a2c462436
Minor textual adjustment, and style-guide conformance (no use of "iff").
2001-10-26 03:00:39 +00:00
107771a228
Applying proposed patch for bug #474583 , optional support for
...
non-standard but common types. Including Martin's suggestion to add
rejected non-standard types from patch #438790 . Specifically,
guess_type(), guess_extension(): Both the functions and the methods
grow an optional "strict" flag, defaulting to true, which determines
whether to recognize non-standard, but commonly found types or not.
Also, I sorted, reformatted, and culled duplicates from the big
types_map dictionary. Note that there are a few non-equivalent
duplicates (e.g. .cdf and .xls) for which the first will just get
thrown away. I didn't remove those though.
Finally, use of the module as a script as grown the -l and -e options
to toggle strictness and to do guess_extension(), respectively.
Doc and unittest updates too.
2001-10-25 21:49:18 +00:00
61f794918f
Typo: NamedNodeList --> NamedNodeMap
2001-10-25 20:42:57 +00:00
847c51a181
Slightly better conformance to the Python C style guide.
2001-10-25 15:53:44 +00:00
af876d77e0
One more LaTeX-ism that we'd rather ignore.
2001-10-25 15:14:57 +00:00
a281665972
No need to run make twice here.
2001-10-25 15:13:30 +00:00
0099d8f8fb
Update the rules so that changes to the HTML stylesheet cause appropriate
...
work to be done, but do not require the HTML to be re-built.
2001-10-25 15:12:31 +00:00
bc006af3d0
Make the deprecation notice use the same form as other such notices.
...
This has sat around in a deprecated state for a *long* time!
2001-10-24 21:56:59 +00:00
0559d95fd6
Minor revision of the text.
2001-10-24 21:10:52 +00:00
08fd51509c
When describing "import *", add a level of indirection between "*" and the
...
set of names imported (the "public names"), adding a definition of "public
names" that describes the use of __all__.
This closes SF bug #473986 .
Flesh out the vague reference to __import__().
2001-10-24 19:50:31 +00:00
c84f2c5068
Documentation for the new PyArg_UnpackTuple() function.
2001-10-23 21:10:18 +00:00
4855b02554
Fill out section on how to write a new-style class
2001-10-23 20:26:16 +00:00
98791affc8
Doc and NEWS changes due to Jeremy adding traceback objects to gc.
2001-10-23 01:59:54 +00:00
d05e051aa7
Fixed an example in the use of email.Utils.getaddresses(). The
...
failobj has to be a list or the `+' can fail.
2001-10-22 20:53:45 +00:00
a219b411af
Add better support for Mozilla's use of <link> elements.
2001-10-22 16:57:49 +00:00
32e3232a55
Update bug/patch counts
2001-10-22 15:32:05 +00:00
f10584cb11
Do a little bit more to try and add <link> elements to the header, not that
...
Mozilla 0.9.5 can make intelligent use of them. Specifically, this causes
the "Acknowledgements" and "Global Module Index" pages to acquire "up"
links in the Mozilla "Site Navigation Bar".
This partially responds to SF bug #469772 .
2001-10-22 15:07:16 +00:00
5d9a6b575c
Clarify that the resource module does not attempt to mask platform
...
differences by defining symbols not defined on particular platforms.
This closes SF bug #473433 .
2001-10-22 14:18:23 +00:00
beb385568c
Add correction from /F about SRE
...
\filename{} should be \file{}
2001-10-22 14:11:06 +00:00
279e744573
Partly fill out the PEP 252 section
2001-10-22 02:03:40 +00:00
8b42f01667
A bunch of minor rewordings
2001-10-22 02:00:11 +00:00
9dbc0bcf9d
Update description of border()
2001-10-20 16:07:41 +00:00
0aa811c527
Use the \note and \warning macros where appropriate.
2001-10-20 04:24:09 +00:00
64a5aaf05c
Describe the content given as the parameter to the \note and \warning macros
...
in more detail, and use them where appropriate.
2001-10-20 04:18:14 +00:00
0c77cf15c0
Additional rules to support the iSilo conversion.
2001-10-19 21:12:57 +00:00
5a4bdb7be8
Hush up CVS.
2001-10-19 21:09:19 +00:00
cc2e306592
Support for the iSilo conversion.
2001-10-19 21:08:36 +00:00
aad8bb5d7a
When stating that some parameters to makefile() are similar to the open()
...
parameters, given a hyperlink to the right part of the documentation to
make it easier to look those up. Also, refer to the file() function/
constructor instead of open() now that that is where the actual docs for
those parameters live.
This closes SF bug #472004 .
2001-10-19 17:22:29 +00:00
b5507ecd3c
Additional test and documentation for the unicode() changes.
...
This patch should also be applied to the 2.2b1 trunk.
2001-10-19 12:02:29 +00:00
e736d93eab
Added a note about the somewhat kludgey behavior of the message
...
epilogue, based on the discussion in this SF bug report:
https://sourceforge.net/tracker/index.php?func=detail&aid=472481&group_id=25568&atid=384678
2001-10-19 04:34:42 +00:00
b6c1d5239c
SF patch #443759 : Add Interface to readline's add_history
...
This was submitted by Moshe, but apparently he's too busy to check it
in himself. He wrote:
Here is a function in GNU readline called add_history,
which is used to manage the history list. Though Python
uses this function internally, it does not expose it to
the Python programmer. This patch adds direct interface
to this function with documentation.
This could be used by friendly modules to "seed" the
history with commands.
2001-10-19 01:18:43 +00:00
a5e616510e
changed misleading argument name
2001-10-18 20:58:25 +00:00
91b81c4802
Some minor clarifications for find()'s arguments based on SF bug
...
#463572 . Closing.
2001-10-18 19:41:48 +00:00
db7287c0f5
Straighten out the exec*() function descriptions a bit, and clarify a few
...
points in the spawn*() description.
2001-10-18 18:58:30 +00:00
9ae09947f4
Bump version number.
...
Remove inconsistent use of HTMLDIR.
2001-10-18 18:46:22 +00:00
77165d039f
Bump release information.
2001-10-18 18:41:12 +00:00
316141b333
Fix typo reported by Michael Soulier.
2001-10-18 15:22:23 +00:00
ca836f7e65
Function descriptions must end as well as start!
2001-10-18 14:26:08 +00:00
c405133fce
Elaborate on types and meaning of the setgroups arguments.
2001-10-18 14:07:12 +00:00
61c5edf6fc
Expose setgroups. Fixes feature request #468116 .
2001-10-18 04:06:00 +00:00
61acf067ac
SF bug [ #471111 ] inspect.getframeinfo() needs docs.
...
TeX-ified its docstring.
2001-10-16 23:01:06 +00:00
3c28863e08
Partial patch from SF #452266 , by Jason Petrone.
...
This changes Pythread_start_thread() to return the thread ID, or -1
for an error. (It's technically an incompatible API change, but I
doubt anyone calls it.)
2001-10-16 21:13:49 +00:00
511e2cacc4
[ #403753 ] zlib decompress; uncontrollable memory usage
...
Mostly by Toby Dickenson and Titus Brown.
Add an optional argument to a decompression object's decompress()
method. The argument specifies the maximum length of the return
value. If the uncompressed data exceeds this length, the excess data
is stored as the unconsumed_tail attribute. (Not to be confused with
unused_data, which is a separate issue.)
Difference from SF patch: Default value for unconsumed_tail is ""
rather than None. It's simpler if the attribute is always a string.
2001-10-16 20:39:49 +00:00
7a59445e37
Document required return values -1, 0, 1 for tp_compare handler, as
...
suggested in SF patch #424475 . Also document exception return.
2001-10-16 20:32:05 +00:00
5bf1ecd503
Update the description of PyTrace_EXCEPT.
2001-10-16 19:23:55 +00:00
ab9b238ced
Fix a few usage and style-guide conformance issues.
2001-10-16 19:22:51 +00:00
64d7863797
Added information about setprofile() and settrace() hooks being thread-
...
specific, and updated some of the comments about the profile hook.
This closes SF bug #471725 .
2001-10-16 14:54:22 +00:00
a815916472
Fix thinko in a comment about seeking with a file object.
...
Reported by Francesco Trentini.
2001-10-16 03:25:00 +00:00
327798ca4a
Added notes to clarify that binascii.crc32(), zlib.crc32(), and
...
zlib.adler32() are not suitable as general hash functions.
2001-10-15 13:45:49 +00:00
0fae49fc7b
Added documentation for the functions listed in marshal.h.
...
Prompted by Jim Ahlstrom. This closes SF patch #470614 .
2001-10-14 04:45:51 +00:00
c65b3d95b6
Add entries for the newly split C API manual.
2001-10-12 19:02:35 +00:00
3adf79e3e2
Break the Python/C API manual into smaller files by chapter. This manual
...
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.
2001-10-12 19:01:43 +00:00
cb43c085e2
Document that keyfile and certfile are now optional.
...
XXX Forgot to mention this in the last socketmodule.c checkin.
2001-10-11 16:17:22 +00:00
c7f8b86307
Describe the HeaderParser class.
2001-10-11 15:45:05 +00:00
8cd015c701
A copy-and-paste job forget the "paste" half.
2001-10-09 20:54:23 +00:00
659a60311d
Allow the profiler's calibration constant to be specified in the constructor
...
call, or via setting an instance or class vrbl.
Rewrote the calibration docs.
Modern boxes are so friggin' fast, and a profiler event does so much work
anyway, that the cost of looking up an instance vrbl (the bias constant)
per profile event just isn't a big deal.
2001-10-09 20:51:19 +00:00
dca939899d
Fix minor cut-and-paste typo.
2001-10-09 19:37:51 +00:00
e0063d20a7
Update the documentation for the isinstance() function to reflect recent
...
changes in the implementation.
Indented all descriptions consistently.
2001-10-09 19:31:08 +00:00
a55d132f08
Add documentation for the MIMEAudio class/module, contributed by
...
Anthony Baxter.
2001-10-09 19:14:17 +00:00
938a8d723c
Improve the documentation for the os.P_* constants used with the os.spawn*()
...
functions to include information about how they affect the operation of
those functions when used as the "mode" parameter.
This closes SF bug #468384 .
Added warnings to the os.tempnam() and os.tmpnam() functions regarding their
security problem. These warning mirror the warnings added to the runtime
by Skip Montanaro.
2001-10-09 18:07:04 +00:00
92350b3a1f
New markup: \note{...} and \warning{...}
2001-10-09 18:01:23 +00:00
6959a2fcd7
Note that the values for Boolean options are case-insensitive.
2001-10-09 14:58:24 +00:00
b35f0ce2b8
Update the description of getboolean() to reflect the changes made by
...
SF patch #467580 .
2001-10-08 16:03:20 +00:00
0a1fc4e389
Remove code and docs for the OldProfile and HotProfile classes: code
...
hasn't worked in years, docs were wrong, and they aren't interesting
anymore regardless.
2001-10-07 03:12:08 +00:00
8c2c3d301b
Update the documentation to reflect the changes to ReferenceError.
2001-10-06 06:10:54 +00:00
bf88b68f38
Add documentation for the public API for weak reference objects.
2001-10-05 22:03:58 +00:00
9835206268
A regexp example was rendered as
...
foo\d
when it was clearly intended to render as
foo$
Fred, is this a right way to fix it? If not, the earlier place in the
same paragraph that does render as
foo$
is also wrong.
2001-10-05 20:06:47 +00:00
e8f47bb93a
Remove some long-unsupported Mac OS modules.
...
This closes SF patch #460737 .
2001-10-05 16:49:31 +00:00
244edc8985
Add chroot call. Implements feature #459267 .
2001-10-04 22:44:26 +00:00
fcc16330a4
Update a couple of old addresses that point to CNRI.
2001-10-04 20:40:07 +00:00
3899d74c10
Make clear that tuple() accepts the same kind of arguments as list().
2001-10-04 06:53:20 +00:00
6f3d82693a
Expand the documentation of the low-level tracing/profiling interface.
...
This reflects what is currently in CVS, which may change before 2.2 is final.
2001-10-03 21:52:51 +00:00
0481d24dd5
CVS patch [ #466628 ] Doc changes for doctest patch ( #466616 ), from
...
Tim Hochberg. Doctest no longer searches imported objects.
2001-10-02 21:01:22 +00:00
Skip Montanaro
Fred Drake
Martin v. Löwis
Andrew M. Kuchling
Neil Schemenauer
Neal Norwitz
Walter Dörwald
Tim Peters
Piers Lauder
Michael W. Hudson
Greg Ward
Guido van Rossum
Thomas Heller
Marc-André Lemburg
Jeremy Hylton
Barry Warsaw
Fredrik Lundh