Michael W. Hudson
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
Fred Drake
b6b2aa6c75
Fix error in explanation of the interaction between $ and MULTILINE mode.
...
Reported by Steve Alexander.
2002-02-25 18:56:45 +00:00
Tim Peters
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
Greg Ward
f8b1f2431b
Grammar tweak.
2002-02-22 21:24:32 +00:00
Fred Drake
216cbca195
Typo: thsi -> this. Closes SF bug #521450 .
2002-02-22 15:40:23 +00:00
Fred Drake
8371e840d2
Correct the refcount information for the PyWeakref_GetObject() function.
...
This closes SF bug #520087 .
2002-02-20 05:07:36 +00:00
Neal Norwitz
ba902fda3c
SF #515041 , Update path for 2.3
2002-02-19 02:58:54 +00:00
Fred Drake
e73ad2a21f
Use the standard expression for the availability statement for alarm().
2002-02-15 20:59:43 +00:00
Skip Montanaro
8d1fdafd89
note that the alarm function is not available on Windows.
2002-02-15 20:36:19 +00:00
Fred Drake
960d7a68d0
Added deprecatioon information for mac.xstat().
...
This closes SF bug #505150 .
2002-02-15 14:35:09 +00:00
Fred Drake
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
Fred Drake
7bc6f7ac7b
Consistently use \textasciicircum to produce a ^ character.
...
LaTeX really falls flat on this one!
2002-02-14 15:19:30 +00:00
Fred Drake
c121745fda
Update the instructions on reporting bugs to reflect that anonymous reports
...
are no longer accepted.
2002-02-04 21:43:08 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
375bbc306e
Update version number to match Include/patchlevel.h.
2002-02-04 19:48:25 +00:00
Tim Peters
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
Skip Montanaro
c318260a71
added handle_error method description
2002-01-31 17:32:24 +00:00
Tim Peters
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
Fred Drake
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
Martin v. Löwis
ef180dc3d0
Document that get_referrers can return unreachable but uncollected objects.
...
Fixes #505453 .
2002-01-26 20:11:50 +00:00
Fred Drake
744f67fb62
Add keyword.kwlist to the public API.
2002-01-24 16:38:53 +00:00
Fred Drake
db2d3d1b3a
libkeyword.tex was missing from the list of dependencies for the
...
Library Reference.
2002-01-24 16:38:08 +00:00
Skip Montanaro
ea3ceaa913
PyDict_Next: update doc to indicate that pkey and pvalue return values are
...
borrowed references.
2002-01-23 10:54:41 +00:00
Skip Montanaro
a23bc42ad5
add missing return value info for PyDict_DelItem
2002-01-23 08:18:30 +00:00
Fred Drake
aae728f292
Fix typo reported by François Pinard.
2002-01-21 16:09:18 +00:00
Fred Drake
ac6dd0a817
Updated GNU info dir segment from Milan Zamazal.
2002-01-17 21:27:00 +00:00
Fred Drake
826e98214b
Update email address.
2002-01-17 21:05:14 +00:00
Fred Drake
d6bdb075ca
Update the list of output formats.
2002-01-17 12:35:20 +00:00
Fred Drake
ac96868d2d
Consistency nits.
2002-01-17 04:51:55 +00:00
Fred Drake
efff11b37c
Minor consistency nit.
2002-01-17 04:44:34 +00:00
Michael W. Hudson
8fbd4a3e78
That hasn't been my email address for a while!
2002-01-16 14:55:05 +00:00
Guido van Rossum
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
Thomas Heller
3d62f8ca35
Fix a simple typo. Has this to be fixed also in other branches?
2002-01-14 08:37:39 +00:00
Martin v. Löwis
a55ffaeee9
Add a per-message fallback mechanism for translations.
2002-01-11 06:58:49 +00:00
Martin v. Löwis
1be6419871
Add fallback argument to translation(). Request fallbacks on install.
...
Fixes #500595 .
2002-01-11 06:33:28 +00:00
Marc-André Lemburg
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
Fred Drake
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
Fred Drake
5e74d36f9d
Fix indentation error in example from the Tkinter Life Preserver.
...
This closes SF bug #499505 .
2002-01-05 03:56:54 +00:00
Fred Drake
d93d68bd13
Fix minor typo reported in SF patch #497951 .
2002-01-05 01:52:41 +00:00
Guido van Rossum
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
Fred Drake
089c7d1d5e
Another name; should be added to Python 2.2.1.
2001-12-27 18:40:18 +00:00
Fred Drake
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
Fred Drake
7c9a53dfc0
Elaborate the descriptions for onecmd(), precmd(), and postcmd() so they are
...
useful.
2001-12-27 05:10:18 +00:00
Fred Drake
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
Fred Drake
7fa4ec5498
Added another name.
2001-12-26 22:08:35 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
ef338ec5f9
More index entries.
2001-12-26 19:48:43 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Andrew M. Kuchling
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
Fred Drake
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
Fred Drake
dce2e1161a
Fix typo in httplib example.
...
This fixes SF bug #495221 .
2001-12-21 03:52:04 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Andrew M. Kuchling
5e08d10dd9
Update the documentation links
...
Remove reference to this being a draft
2001-12-20 16:33:45 +00:00
Andrew M. Kuchling
adc7df5778
Use the final patch/bug numbers
2001-12-20 16:04:24 +00:00
Fred Drake
4b1b3bfac1
Add entry for the pydoc documentation.
2001-12-18 16:32:30 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
0c0b5305ae
Mark the mpz module deprecated as of Python 2.2.
2001-12-16 01:54:55 +00:00
Fred Drake
b9c0ef5db7
Update to reflect recently added markup.
2001-12-15 22:24:06 +00:00
Fred Drake
c57772870b
Add a link to the mxNumber package.
2001-12-15 20:37:40 +00:00
Fred Drake
b40501b05e
Add link to the gmpy project.
2001-12-15 18:37:24 +00:00
Fred Drake
08d752cf28
Update to use the notice environment so a multi-paragraph note can be
...
appropriately marked.
2001-12-14 22:55:14 +00:00
Fred Drake
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
Fred Drake
6ca33771f8
Add a new environment for whole-paragraph (or longer) notes & warnings.
2001-12-14 22:50:06 +00:00
Fred Drake
dda7dcb3f7
Add a missing "cycle".
2001-12-14 21:19:08 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
e6965cd9f0
Bump version numbers for the trunk.
2001-12-14 16:45:04 +00:00
Fred Drake
7b82271bb5
Reflect change of Digital Creations to Zope Corporation.
2001-12-14 16:42:56 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
a0b767625b
Minor adjustments.
2001-12-13 04:25:37 +00:00
Michael W. Hudson
850d3980ab
Fix for
...
[ #429329 ] actual-parameters *arg, **kws not doc'd
2001-12-12 11:56:33 +00:00
Fred Drake
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
Fred Drake
8d0645cb84
Add a note about yield requiring a __future__ directive.
2001-12-12 06:06:43 +00:00
Fred Drake
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
Fred Drake
3a8e59ebe1
Clean up a sad sentence in the yield description.
2001-12-11 21:58:35 +00:00
Fred Drake
e31e9cebc0
Document generators and the yield statement, avoiding implementation details.
2001-12-11 21:10:08 +00:00
Fred Drake
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
Fred Drake
54e6294197
A number of small adjustments.
2001-12-11 19:40:16 +00:00
Fred Drake
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
Tim Peters
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
Fred Drake
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
Fred Drake
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
Fred Drake
cf72abab8c
Update link to the SAX homepage.
2001-12-10 18:10:37 +00:00
Fred Drake
6048ce95a9
Added documentation for str.decode().
...
This closes SF bug #490823 .
2001-12-10 16:43:08 +00:00
Guido van Rossum
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
Fred Drake
73f0a4ecd7
Script to generate the table of distribution packages, plugging in the size
...
information automatically.
2001-12-08 00:26:07 +00:00
Fred Drake
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
Guido van Rossum
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
Fred Drake
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
Fred Drake
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
Fred Drake
c6259d73c2
Another name.
2001-12-07 18:27:38 +00:00
Guido van Rossum
44b3f76adf
More info about the cycle detector.
2001-12-07 17:57:56 +00:00
Tim Peters
874c4f0f99
Trivial spelling repair on new cyclic garbage text.
2001-12-07 17:51:41 +00:00
Fred Drake
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
Andrew M. Kuchling
038215ab0c
Use an immutable tuple for __slots instead of a mutable list
...
Bump version number
2001-12-07 14:22:13 +00:00
Tim Peters
b404145936
s/it/if/ in descriptions of spawn mode argument.
2001-12-06 23:37:17 +00:00
Tim Peters
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
Fred Drake
32a3587345
Document that PyString_FromString() cannot take NULL as a parameter.
...
This closes SF bug #489872 .
2001-12-06 20:38:15 +00:00
Andrew M. Kuchling
22d35a7337
[Bug #459270 ] Fix incorrect filename for system-wide config file
2001-12-06 16:34:53 +00:00
Fred Drake
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
Fred Drake
d761662b66
asyncore.loop() description contributed by Skip Montanaro.
...
This closes SF bug #489513 .
2001-12-05 21:37:50 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
d2a557e51e
Added entry for the "cgitb" module docs.
2001-12-04 22:48:17 +00:00
Fred Drake
6e70e8b401
Documentation for the "cgitb" module.
2001-12-04 22:47:42 +00:00
Guido van Rossum
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
Guido van Rossum
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
b48b6d0737
Remove meaningless comment.
2001-12-04 16:32:04 +00:00
Jeremy Hylton
db5a93cd6a
Update docs to reflect new compile() and compileFile()
2001-12-04 02:48:52 +00:00
Fred Drake
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
Fred Drake
fcf94681ed
Update lambda description to reflect nested scopes. This was noted by
...
Andrew Koenig.
2001-12-03 21:47:37 +00:00
Fred Drake
1a76386194
Added documentation on the ScrolledText module.
2001-12-03 21:18:30 +00:00
Andrew M. Kuchling
c54fc3179f
Oops! Forgot the value parameter.
2001-12-03 20:58:29 +00:00
Andrew M. Kuchling
9455df2a5a
Add __delete__ method of properties
...
Reflow paragraph
2001-12-03 20:55:37 +00:00
Fred Drake
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
Fred Drake
5172adca81
Minor clarification of the zip() description, based on a comment sent to
...
python-docs.
2001-12-03 18:35:05 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
c7b78381da
Another name.
2001-12-02 15:13:35 +00:00
Fred Drake
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
Fred Drake
381832ead5
Drop xmllib in favor of SAX.
2001-11-30 19:30:03 +00:00
Fred Drake
1e53fa7907
Add a couple of entries to the whitespace-cleanups table.
2001-11-30 19:25:39 +00:00
Fred Drake
0467775715
Add description of tkCommonDialog.
2001-11-30 19:24:49 +00:00
Fred Drake
95e33f03ba
Added two new conversion specifications.
2001-11-30 19:06:18 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
89d63cc450
Minor adjustments to markup for the getDOMImplementation() description.
2001-11-30 16:58:15 +00:00
Fred Drake
bd34b6bc3d
Added the convenience constants that are present in PyXML to make these
...
more similar.
2001-11-30 15:37:33 +00:00
Fred Drake
38f3b72f9f
Updated documentation for the new httplib interface, by Kalle Svensson.
...
This closes SF bug #458447 .
2001-11-30 06:06:40 +00:00
Fred Drake
454af89712
Update the signature of PyFile_WriteString().
2001-11-29 22:42:59 +00:00
Fred Drake
44b6f84e56
More information about Tix support, contributed by Mike Clarkson.
2001-11-29 21:09:08 +00:00
Fred Drake
6995bb61b6
Various cleanups & markup fixes, mostly relating to the stat and statvfs
...
result object changes.
2001-11-29 20:48:44 +00:00
Fred Drake
ed0a71911c
Neil Schemenauer suggested a small improvement to one of the example REs.
2001-11-29 20:23:14 +00:00
Fred Drake
389aa17ad3
writeline() --> writelines()
...
This closes SF bug #487147 .
2001-11-29 19:04:50 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
48704ee478
Add synopsis for the SimpleXMLRPCServer module; used in the chapter-level
...
list of modules.
2001-11-28 07:32:53 +00:00
Fred Drake
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
Fred Drake
beafc795df
Typo, spotted by Fredrik Lundh.
2001-11-26 21:46:53 +00:00
Fred Drake
b03d0cc45e
Typo, spotted by Detlef Lannert.
2001-11-26 21:39:40 +00:00
Fred Drake
fcb05ab512
Tk-related modules should no longer be listed here.
2001-11-26 21:38:50 +00:00
Fred Drake
2744f43f71
Fix typo, extra markup constructs.
...
This closes SF bug #485252 .
2001-11-26 21:30:36 +00:00
Fred Drake
cd8474e6a2
Add documentation for the PyCell* APIs.
2001-11-26 21:29:17 +00:00
Andrew M. Kuchling
ccf04658b0
Correctly create new-style classes in the examples
...
Mention change to _PyTuple_Resize
2001-11-26 18:15:44 +00:00
Martin v. Löwis
560da62fc7
Rename get_referents to get_referrers. Fixes #483815 .
2001-11-24 09:24:51 +00:00
Fred Drake
27ae311864
Avoid trailing blank lines in the output.
2001-11-19 05:28:29 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
63c4f907a9
Another name...
2001-11-19 04:35:58 +00:00
Fred Drake
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
Barry Warsaw
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
Fred Drake
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
Tim Peters
af0a883041
Relatively large expansion of the docs for gc.garbage.
2001-11-18 04:51:17 +00:00
Fred Drake
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
Fred Drake
50ecc15d05
Add omitted word for clarity.
2001-11-17 06:39:18 +00:00
Barry Warsaw
0c0565dd7f
Toughen up the security warnings a bit.
2001-11-16 22:28:17 +00:00
Barry Warsaw
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
Fred Drake
dd2487d759
Post-release bumps. Do *NOT* merge into the 2.2b2 branch.
2001-11-16 17:34:38 +00:00
Fred Drake
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
Fred Drake
5545219bf6
Document the urlsplit() and urlunsplit() functions.
2001-11-16 03:22:15 +00:00
Fred Drake
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
Barry Warsaw
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
Barry Warsaw
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
Barry Warsaw
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
Fred Drake
fd4f069b12
The turtle docs will be moving to another location in the Tkinter chapter.
2001-11-15 22:10:46 +00:00
Fred Drake
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
Fred Drake
bc1491f60f
Thanks for the Tkinter chapter, Mike!
2001-11-15 17:26:10 +00:00
Fred Drake
53556861df
Add entries for the new Tkinter chapter.
2001-11-15 17:25:29 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
9c7a07f7a4
Bump release number & date.
2001-11-14 22:28:26 +00:00
Jeremy Hylton
1336e99054
Fred observes that the typo was not the only problem with this sentence.
2001-11-14 21:38:13 +00:00
Jeremy Hylton
4a98f70a09
typo
2001-11-14 21:32:27 +00:00
Tim Peters
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
Thomas Heller
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
Thomas Heller
bfeeeee851
Fix obvious typos.
2001-11-12 07:46:31 +00:00
Fred Drake
94ead57dc3
Added version annotations, remove hard tabs.
2001-11-09 23:34:26 +00:00
Jeremy Hylton
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
Fred Drake
da4ffeecf5
No need to have documentation for a module which not accepted in the library.
2001-11-09 21:45:55 +00:00
Barry Warsaw
3b0c82a2f1
Updated the documentation for formatdate().
2001-11-09 17:08:13 +00:00
Thomas Heller
3988574075
Remove my name, probably bad style.
2001-11-09 17:04:43 +00:00
Thomas Heller
3e77423a64
Script to print undocumented symbols found in Python header files.
2001-11-09 16:50:35 +00:00
Fred Drake
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
Fred Drake
399bc8c281
Fix a variety of typographical, grammatical, and clarity problems reported
...
by Detlef Lannert.
2001-11-09 03:49:29 +00:00
Fred Drake
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
Fred Drake
59bfe280f5
Another name!
2001-11-07 06:23:27 +00:00
Fred Drake
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
Fred Drake
1a670c8414
Adjust the module synopsis to avoid margin overruns in the PDF format.
2001-11-06 22:14:35 +00:00
Fred Drake
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
Fred Drake
5976816698
Remove stray quotes; probably left over from conversion from docstrings.
2001-11-06 22:11:34 +00:00
Fred Drake
806d332f02
Remove extra period.
2001-11-06 22:10:47 +00:00
Andrew M. Kuchling
1f774b062e
Update obsolete e-mail address, and remove myself as a module author
2001-11-05 21:34:36 +00:00
Andrew M. Kuchling
4794f0b234
Update obsolete e-mail address
2001-11-05 21:31:33 +00:00
Andrew M. Kuchling
47ccfe2d8f
Remove obsolete e-mail address
2001-11-05 21:31:15 +00:00
Andrew M. Kuchling
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
Andrew M. Kuchling
10f9c075b9
Remove obsolete e-mail address
2001-11-05 21:25:42 +00:00
Barry Warsaw
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
Andrew M. Kuchling
c44403995e
Remove email*.tex subsections; they're all \input by email.tex
2001-11-05 01:55:43 +00:00
Andrew M. Kuchling
43dc1fc926
Minor grammar and typo fixes
2001-11-05 01:55:03 +00:00
Tim Peters
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
Tim Peters
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
Andrew M. Kuchling
bc4a1c2588
[Patch #476612 ] Change docs to describe PEP247 interface
2001-11-02 21:44:09 +00:00
Fred Drake
622087a3ed
Fix stupid bug recently introduced for DVI version of the docs (used to
...
generate PostScript).
2001-11-02 20:53:19 +00:00
Fred Drake
d9272d6f11
Add deprecation notice to statcache.
2001-11-02 20:20:19 +00:00
Fred Drake
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
Fred Drake
3808045d00
Correct misspelling of "separate" in two places.
...
This closes SF bug #476898 .
2001-11-01 19:48:01 +00:00
Andrew M. Kuchling
2dab9c7d9b
Fix markup typo
2001-10-31 13:16:10 +00:00
Andrew M. Kuchling
bbde5880a5
Add paragraph about difflib suggested by David Goodger
...
Bump version number
2001-10-31 13:13:36 +00:00
Andrew M. Kuchling
72a7fb78cb
Fix grammar error
2001-10-30 22:18:21 +00:00
Andrew M. Kuchling
433b5c4d34
Rewrites and additions resulting from today's feedback
2001-10-30 21:36:04 +00:00
Fred Drake
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
Fred Drake
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
Andrew M. Kuchling
7aa63c245f
Various minor rewrites
...
Bump version number
2001-10-30 14:35:03 +00:00
Andrew M. Kuchling
7cc13de554
Corrections noted by Michael McLay
2001-10-30 14:22:11 +00:00
Fred Drake
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
Fred Drake
b4ea9d0502
Promote built-in functions to come before built-in types.
2001-10-30 06:22:02 +00:00
Tim Peters
003047a5f2
Mention the new file() builtin in the section on file objects.
2001-10-30 05:54:04 +00:00
Tim Peters
a427a2b8d0
Rename "dictionary" (type and constructor) to "dict".
2001-10-29 22:25:45 +00:00
Fred Drake
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
Andrew M. Kuchling
1117d930fa
dictionary -> dict
2001-10-29 20:37:47 +00:00
Andrew M. Kuchling
4f9e220e7f
Fix two typos noted by Jens Quade
...
Bump version number
2001-10-29 18:09:42 +00:00
Fred Drake
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
Fred Drake
1b58bff8a0
More refcount information.
2001-10-29 17:43:14 +00:00
Fred Drake
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
Fred Drake
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
Andrew M. Kuchling
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
Fred Drake
b0c079e3e5
PyObject_CallFunctionObArgs() ---> PyObject_CallFunctionObjArgs()
...
PyObject_CallMethodObArgs() ---> PyObject_CallMethodObjArgs()
2001-10-28 02:39:03 +00:00
Andrew M. Kuchling
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