Guido van Rossum
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
Fredrik Lundh
a5e616510e
changed misleading argument name
2001-10-18 20:58:25 +00:00
Barry Warsaw
91b81c4802
Some minor clarifications for find()'s arguments based on SF bug
...
#463572 . Closing.
2001-10-18 19:41:48 +00:00
Fred Drake
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
Fred Drake
9ae09947f4
Bump version number.
...
Remove inconsistent use of HTMLDIR.
2001-10-18 18:46:22 +00:00
Fred Drake
77165d039f
Bump release information.
2001-10-18 18:41:12 +00:00
Fred Drake
316141b333
Fix typo reported by Michael Soulier.
2001-10-18 15:22:23 +00:00
Fred Drake
ca836f7e65
Function descriptions must end as well as start!
2001-10-18 14:26:08 +00:00
Martin v. Löwis
c405133fce
Elaborate on types and meaning of the setgroups arguments.
2001-10-18 14:07:12 +00:00
Martin v. Löwis
61c5edf6fc
Expose setgroups. Fixes feature request #468116 .
2001-10-18 04:06:00 +00:00
Tim Peters
61acf067ac
SF bug [ #471111 ] inspect.getframeinfo() needs docs.
...
TeX-ified its docstring.
2001-10-16 23:01:06 +00:00
Guido van Rossum
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
Jeremy Hylton
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
Guido van Rossum
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
Fred Drake
5bf1ecd503
Update the description of PyTrace_EXCEPT.
2001-10-16 19:23:55 +00:00
Fred Drake
ab9b238ced
Fix a few usage and style-guide conformance issues.
2001-10-16 19:22:51 +00:00
Fred Drake
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
Fred Drake
a815916472
Fix thinko in a comment about seeking with a file object.
...
Reported by Francesco Trentini.
2001-10-16 03:25:00 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
c65b3d95b6
Add entries for the newly split C API manual.
2001-10-12 19:02:35 +00:00
Fred Drake
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
Jeremy Hylton
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
Barry Warsaw
c7f8b86307
Describe the HeaderParser class.
2001-10-11 15:45:05 +00:00
Tim Peters
8cd015c701
A copy-and-paste job forget the "paste" half.
2001-10-09 20:54:23 +00:00
Tim Peters
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
Barry Warsaw
dca939899d
Fix minor cut-and-paste typo.
2001-10-09 19:37:51 +00:00
Fred Drake
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
Barry Warsaw
a55d132f08
Add documentation for the MIMEAudio class/module, contributed by
...
Anthony Baxter.
2001-10-09 19:14:17 +00:00
Fred Drake
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
Fred Drake
92350b3a1f
New markup: \note{...} and \warning{...}
2001-10-09 18:01:23 +00:00
Fred Drake
6959a2fcd7
Note that the values for Boolean options are case-insensitive.
2001-10-09 14:58:24 +00:00
Fred Drake
b35f0ce2b8
Update the description of getboolean() to reflect the changes made by
...
SF patch #467580 .
2001-10-08 16:03:20 +00:00
Tim Peters
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
Fred Drake
8c2c3d301b
Update the documentation to reflect the changes to ReferenceError.
2001-10-06 06:10:54 +00:00
Fred Drake
bf88b68f38
Add documentation for the public API for weak reference objects.
2001-10-05 22:03:58 +00:00
Tim Peters
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
Fred Drake
e8f47bb93a
Remove some long-unsupported Mac OS modules.
...
This closes SF patch #460737 .
2001-10-05 16:49:31 +00:00
Martin v. Löwis
244edc8985
Add chroot call. Implements feature #459267 .
2001-10-04 22:44:26 +00:00
Fred Drake
fcc16330a4
Update a couple of old addresses that point to CNRI.
2001-10-04 20:40:07 +00:00
Tim Peters
3899d74c10
Make clear that tuple() accepts the same kind of arguments as list().
2001-10-04 06:53:20 +00:00
Fred Drake
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
Tim Peters
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
Fred Drake
d90f509b8f
Fredrik tells me the truefalse parameter for boolean() is not part of the
...
public interface, so we can simplify the documentation.
2001-10-01 21:05:30 +00:00
Tim Peters
1350c07de3
Removed stray backslash (a typo -- my fault).
2001-10-01 20:25:26 +00:00
Tim Peters
20524dbf36
The description of dictionary comparison was out of date. Rather than
...
try to explain the complex general scheme we actually use now, I decided
to spell out only what equality means (which is easy to explain and
intuitive), leaving the other outcomes unspecified beyond consistency.
2001-10-01 20:22:45 +00:00
Fred Drake
6c81e2a44f
"boolean" --> "Boolean" (per the style guide).
2001-10-01 17:04:10 +00:00
Fred Drake
0f0380a25f
Fix some minor style-guide conformance bugs.
2001-10-01 17:04:10 +00:00
Fred Drake
fe95e65668
Straighten out some markup.
...
"boolean" --> "Boolean" (per the style guide).
2001-10-01 17:03:48 +00:00
Fred Drake
73921b0eec
Refer to the objects which define __len__(), __*item__(), and __iter__()
...
as container objects rather than as mapping objects (in the index entries).
Change the section heading and intro sentence to be a little more general,
since that's how things have actually evolved.
2001-10-01 16:32:13 +00:00
Fred Drake
e9ba525c2b
Clarify comments about mailbox objects being iterable.
2001-10-01 15:49:56 +00:00
Guido van Rossum
e7877df595
Docs for SF patch #462628
2001-10-01 13:50:15 +00:00
Martin v. Löwis
0daad598d0
Patch #462122 : add readline startup and pre_event hooks.
2001-09-30 21:09:59 +00:00
Martin v. Löwis
16dc7f44b1
Patch #462190 , patch #464070 : Support quoted printable in the binascii module.
...
Decode and encode underscores for header style encoding. Fixes bug #463996 .
2001-09-30 20:32:11 +00:00
Tim Peters
af5910f025
The execfile() docs imply it acts on locals same as exec. But in truth
...
it acts more like assigning to keys in locals(), i.e. modifications to
function locals aren't reflected in the locals when execfile() returns.
2001-09-30 06:32:59 +00:00
Tim Peters
1c33daf143
Correct docs for long(float).
2001-09-30 06:18:26 +00:00
Tim Peters
d38b1c74f3
SF [ #466125 ] PyLong_AsLongLong works for any integer.
...
Generalize PyLong_AsLongLong to accept int arguments too. The real point
is so that PyArg_ParseTuple's 'L' code does too. That code was
undocumented (AFAICT), so documented it.
2001-09-30 05:09:37 +00:00
Fred Drake
ac1af8093e
Handle PEP references the same way RFC references.
2001-09-29 19:07:22 +00:00
Guido van Rossum
0d68246f01
Fix two typos in the text about compile(), and add two caveats from
...
recent user feedback: you must end the input with \n and you must use
\n, not \r\n to represent line endings.
2001-09-29 14:28:52 +00:00
Skip Montanaro
a1c3662e84
forgot to mark use of StringType and UnicodeType in the text.
2001-09-29 13:53:21 +00:00
Skip Montanaro
c7ba0c4c24
added description of StringTypes object
2001-09-29 13:49:41 +00:00
Fred Drake
583061a10f
Fix up whitespace in <args> elements; reduce sequences of consecutive
...
whitespace characters to a single space.
Small changes elsewhere, mostly to clean up the code a little.
2001-09-29 05:05:25 +00:00
Fred Drake
2b05ca3454
Minor markup improvement.
2001-09-29 05:01:59 +00:00
Tim Peters
599db7de63
The list.sort() docs require a function that returns -1, 0 or +1. That's
...
never been true, and in particular implies cmp() can't be used(!). Get
closer to the truth.
2001-09-29 01:08:19 +00:00
Fred Drake
7988e0249c
Move XML-RPC-related docs to the "Internet Protocols" chapter.
...
Add entry for the SimpleXMLRPCServer module.
2001-09-28 22:03:40 +00:00
Fred Drake
06c61b14fe
Add entry for the SimpleXMLRPCServer module.
2001-09-28 22:02:49 +00:00
Fred Drake
e486e0d066
Preliminary documentation for the SimpleXMLRPCServer module.
2001-09-28 22:02:21 +00:00
Andrew M. Kuchling
d4707e3b62
Minor additions and rewrites.
...
Bump version number.
2001-09-28 20:46:46 +00:00
Fred Drake
3c171d1b9f
Convert to string methods.
...
For the real document element, make sure the prolog is migrated into
the document element so it isn't left stranded.
Make fixup_trailing_whitespace() whitespace do what was really intended.
Add the *desc environments used in the C API manual to the list of
things that can exist at the paragraph level so they don't get wrapped
in <para>...</para>.
2001-09-28 17:14:35 +00:00
Fred Drake
3c10c68c0e
Use consistent version annotations instead of something ad hoc.
2001-09-28 16:57:16 +00:00
Fred Drake
0f9bfd3dda
Convert most uses of the string module to string methods.
...
(string.join() lives!)
2001-09-28 16:26:13 +00:00
Fred Drake
bbf7a407e8
Added note about non-support of UNC paths on Windows.
...
This fixes SF bug #465447 .
2001-09-28 16:14:18 +00:00
Fred Drake
b387860c70
State that encode() and encodestring() append a newline to the input data
...
if it does not already end with a newline.
This fixes SF bug #463330 .
2001-09-28 16:01:46 +00:00
Fred Drake
33f4d6d1db
Add entries for the email and compiler packages.
2001-09-27 20:11:07 +00:00
Fred Drake
90e687863b
Markup adjustments.
2001-09-27 20:09:39 +00:00
Fred Drake
d443d8cc00
Added dependencies for the compiler and email packages.
...
(Migrate to branch, along with new files compiler.tex and asttable.tex.)
2001-09-27 20:08:20 +00:00
Fred Drake
e2f9917f9f
Migrate the compiler documentation from the Tools/compiler/doc/ directory.
...
Changes made to make it work in the new location.
2001-09-27 20:06:07 +00:00
Fred Drake
876389e5d8
Do not distinguish \refmodule from \module in the generated output;
...
whether or not a link will be generated will depend on the link database.
Add a couple of explanatory comments for one of the stranger constructs
(giving input an empty name).
2001-09-27 17:01:59 +00:00
Fred Drake
9213b7a961
Re-write <ulink> elements as described in the conversion spec.
2001-09-27 16:52:22 +00:00
Fred Drake
baacc08ead
Turn \input, \include, and \verbatiminput into XInclude elements instead
...
of something ad-hoc.
2001-09-27 15:49:23 +00:00
Fred Drake
b6fa78930e
Add support for some more markup that had slipped in.
...
Fixed a typo in a comment.
2001-09-27 04:18:39 +00:00
Fred Drake
3fc291a1d7
Fix some markup errors.
2001-09-27 04:17:20 +00:00
Fred Drake
b802a1e7fa
Markup adjustment: \[...\] is math markup and does not translate well when
...
used with text as was done here. Fixed so that the typeset version wraps
the warning text and the HTML version does not create images of the warning
text.
2001-09-27 04:16:27 +00:00
Fred Drake
3ab0ac7cd4
Remove comment that no longer applies.
2001-09-26 22:26:45 +00:00
Barry Warsaw
c5f8fe3a27
Updates do email package documentation for markup, style, and
...
organization.
2001-09-26 22:21:52 +00:00
Fred Drake
479384e1ff
Move the styling for the HTML version of \mailheader into the CSS file.
...
In both the HTML and typeset versions of the documentation, add a colon
after the name of a mail header so that it is more easily distinguished
from other text.
2001-09-26 18:46:36 +00:00
Fred Drake
203d91a461
Note that the colon following a mail header name should not be included
...
when using the \mailheader markup.
Change a couple of inline examples to show the markup rather than the
result.
2001-09-26 18:43:20 +00:00
Greg Ward
e22871e9ed
Typo fix.
2001-09-26 18:12:49 +00:00
Fred Drake
8b3a7b58b9
Move the \mailheader description to the right place.
...
Clarify the \mimetype description; it can be used to refer to a part of a
MIME type name, so \mimetype{text} or \mimetype{plain} can be used, not
just \mimetype{text/plain}.
2001-09-26 17:01:58 +00:00
Fred Drake
a6a885b6aa
Start making some markup adjustments; Barry has indicated he will work on
...
this before we finish the integration, along with some restructuring.
2001-09-26 16:52:18 +00:00
Barry Warsaw
5e634638e6
The email package documentation, currently organized the way I think
...
Fred prefers. I'm not sure I like this organization, so it may change.
2001-09-26 05:23:47 +00:00
Fred Drake
29a67ced72
Update to support \mailheader and 5-column tables.
2001-09-25 20:58:13 +00:00
Fred Drake
9eda3aebb8
Simplify a helper by returning fewer values.
2001-09-25 20:57:36 +00:00
Fred Drake
5055545fc0
Clarified some points about the interface to the mmap() function.
...
This closes SF bug #448918 .
2001-09-25 19:00:08 +00:00
Fred Drake
c0765c2381
Minor changes.
2001-09-25 16:32:02 +00:00
Fred Drake
c825280ea5
Revise the example to be more resiliant in the face of continued use after
...
the object has been pickled; don't mutate the instance dict in the
__getstate__() method. Other minor changes for style. Broke up the
displayed interactive session to get better page-breaking behavior for
typeset versions, and to point out an important aspect of the example.
This closes SF bug #453914 .
2001-09-25 16:29:17 +00:00
Fred Drake
9081bb1d21
Added documentation for the SSL interface, contributed by Gerhard Häring.
...
This closes SF patch #461337 .
2001-09-25 15:48:11 +00:00
Fred Drake
74f1a563ff
Fix a URL (closing SF patch #462195 ).
...
Cleaned up a bunch of XXX comments containing links to additional
information, replacing them with proper references.
Replaced "MacOS" with "Mac OS", since that's what the style guide says.
2001-09-25 15:12:41 +00:00
Fred Drake
f244b2e47c
Add more signature information and some descriptions for the new APIs
...
introduced in Python 2.2.
Add documentation for the slice object interface (not complete).
Added version annotations for several of the Python 2.2 APIs already
documented.
2001-09-24 15:31:50 +00:00
Fred Drake
23a78cf1c1
Add more reference count information.
2001-09-24 15:29:47 +00:00
Andrew M. Kuchling
1497b62827
Add link to Unix Review's 2.2 article
...
Fix two errors
2001-09-24 14:51:16 +00:00
Tim Peters
2c9aa5ea8d
Generalize file.writelines() to allow iterable objects.
2001-09-23 04:06:05 +00:00
Fred Drake
d61d0d3f6d
Added API information for the PyCallIter_*() and PySeqIter_*() functions.
...
Added signatures for some new PyType_*() functions.
2001-09-23 02:05:26 +00:00
Tim Peters
8a9c284437
Make difflib.ndiff() and difflib.Differ.compare() generators. This
...
restores the 2.1 ability of Tools/scripts/ndiff.py to start producing
output before the entire comparison is complete.
2001-09-22 21:30:22 +00:00
Tim Peters
e0b2d7ac9a
Add a function to compute a class's method resolution order. This is
...
easy for 2.2 new-style classes, but trickier for classic classes, and
different approaches are needed "depending". The function will allow
later code to treat all flavors of classes uniformly.
2001-09-22 06:10:55 +00:00
Fred Drake
038d26410d
Note that files are iterable; describe what the iterator returns.
...
This closes SF bug #463738 .
2001-09-22 04:34:48 +00:00
Fred Drake
56dd35bd44
Bump version number.
2001-09-21 21:18:16 +00:00
Fred Drake
c69205526a
Added reference to Tutorial section on user-defined exceptions for
...
information on defining new exceptions.
This closes SF bug #443559 .
2001-09-21 21:12:30 +00:00
Fred Drake
13af42822c
Exceptions in interactive examlpes did not always include the indication of
...
the source file using "in ?".
Added a description of the bare "raise" statement.
Added more description and examples for user-defined exceptions; this
is part of a response to SF bug #443559 .
2001-09-21 21:10:05 +00:00
Fred Drake
e0af35eb69
Fill in a few more descriptions for xml.parsers.expat.
2001-09-20 20:43:28 +00:00
Tim Peters
2e29bfbe1a
Document new file() constructor, with the body of open()'s text, plus a
...
"new in 2.2" blurb at the end. Replace open()'s text by pointing back
to file().
2001-09-20 19:55:29 +00:00
Fred Drake
f47d8ef683
Document all the Py*_CheckExact() functions.
...
Document many more of the PyLong_{As,From}*() functions.
2001-09-20 19:18:52 +00:00
Marc-André Lemburg
494f2aea8e
Docs and News item for the codecs.py additions.
2001-09-19 11:33:31 +00:00
Fred Drake
18d8d5a708
Fix minor usage and consistency nits.
2001-09-18 17:58:20 +00:00
Guido van Rossum
83eeef4b06
SF patch #461781 by Chris Lawrence: os.path.realpath - Resolve symlinks:
...
Once upon a time, I put together a little function
that tries to find the canonical filename for a given
pathname on POSIX. I've finally gotten around to
turning it into a proper patch with documentation.
On non-POSIX, I made it an alias for 'abspath', as
that's the behavior on POSIX when no symlinks are
encountered in the path.
Example:
>>> os.path.realpath('/usr/bin/X11/X')
'/usr/X11R6/bin/X'
2001-09-17 15:16:09 +00:00
Tim Peters
5b7759f9db
Fixed typo in new 'p' description.
2001-09-15 18:16:27 +00:00
Tim Peters
88091aae7e
SF bug [ #461674 ] struct 'p' format doesn't work (maybe)
...
Rewrote the 'p' description.
2001-09-15 18:09:22 +00:00
Tim Peters
ad2dc3fc44
Update the warning about transporting marshals across boxes with different
...
ideas about sizeof(long).
2001-09-14 20:40:13 +00:00
Fred Drake
f2a5f3f721
Markup adjustments for consistency.
2001-09-14 17:48:41 +00:00
Andrew M. Kuchling
1efd7ad88e
Add support for SMTP TLS
2001-09-14 16:19:27 +00:00
Guido van Rossum
f7fcf5eea6
SF patch #461413 (Gerhard Häring): Add STARTTLS feature to smtplib
...
This patch adds the features from RFC 2487 (Secure SMTP
over TLS) to the smtplib module:
- A starttls() function
- Wrapper classes that simulate enough of sockets and
files for smtplib, but really wrap a SSLObject
- reset the list of known SMTP extensions at each call
of ehlo(). This should have been the case anyway.
2001-09-14 16:08:44 +00:00
Fred Drake
b9a96282f1
Admit that we'll never add the args for a "call" event to the profile
...
and trace functions; this now declares that None will be passed for the
"call" event.
This closes SF bug/suggestion #460315 .
2001-09-13 16:56:43 +00:00
Fred Drake
ee0fe0b743
Add missing "}".
2001-09-12 00:43:13 +00:00
Jack Jansen
95fefc7a7a
These modules now live under the Carbon package.
...
Added a few new toolbox modules.
Noted machine dependencies for some modules.
Moved waste to undoc.tex.
2001-09-11 21:25:10 +00:00
Jack Jansen
945bf5f627
Added applesingle, macresource, Nav and videoreader.
...
Moved icopen to its alphabetical place.
Moved waste here (from toolbox).
2001-09-11 21:24:07 +00:00
Jack Jansen
827713a660
Added a note that these are not available under Carbon (or
...
OSX MachO Python).
2001-09-11 20:18:04 +00:00
Fred Drake
85ddfbc4cb
Another documentation contributor.
2001-09-11 19:58:51 +00:00
Fred Drake
098d7fae39
Document clearly that the only way to retrieve the return code from the
...
child processes is to use the Popen3 and Popen4 classes.
This fixes SF bug #460512 .
2001-09-11 19:56:51 +00:00
Fred Drake
1c66f8965a
Added entry for the hmac module.
2001-09-11 16:59:42 +00:00
Fred Drake
aae8da18fd
Documentation for the new login() method of the smtplib.SMTP class,
...
contributed by Gerhard Häring.
This is part of SF patch #460112 .
2001-09-11 16:58:00 +00:00
Fred Drake
42706803cd
Documentation for the new hmac module, contributed by Gerhard Häring.
...
This is part of SF patch #460112 .
2001-09-11 16:56:09 +00:00
Fred Drake
2732cb4269
Added documentation on the getfirst() and getlist() methods of the
...
cgi.FieldStorage class.
This closes SF patch #453691 .
2001-09-11 16:27:03 +00:00
Fred Drake
3ae5726625
Updated infomation about libraries for alternate compilers on Windows.
...
This closes SF patch #459441 .
2001-09-11 15:10:42 +00:00
Andrew M. Kuchling
d6e40e24f8
Remove some XXX markers
...
Update the patch and bug counts
2001-09-10 16:18:50 +00:00
Fred Drake
ed5a7ca5ee
Work around a LaTeX2HTML bug that caused the "m" in "mutable" to be dropped
...
in one place.
2001-09-10 15:16:08 +00:00
Jack Jansen
fda3058827
Removed an erronous comment about alias files.
2001-09-10 08:55:25 +00:00
Andrew M. Kuchling
26c39bf1b5
Add section on long integer changes
...
Add removal of 3-arg pow() for floats
Rewrite introduction a bit
2001-09-10 03:20:53 +00:00
Fred Drake
2872e8a654
Do not rebuild html-$(RELEASE).tar every time we need to use it.
2001-09-06 19:35:02 +00:00
Fred Drake
c93cf676da
Bump version number.
2001-09-06 19:28:06 +00:00
Fred Drake
05a73b1f9a
Update link to the PyOpenGL project in the "gl" module docs.
...
This closes SF bug #459256 .
2001-09-06 19:23:03 +00:00
Fred Drake
00bb329521
Document the built-in iter() function.
2001-09-06 19:04:29 +00:00
Fred Drake
7feae2d28c
Bump version number.
2001-09-06 19:02:57 +00:00
Fred Drake
a20c265aba
Added an additional link to NIST information on secure hashing.
...
This closes SF bug #458785 .
2001-09-06 18:59:43 +00:00
Fred Drake
ba5c41d4c5
Clarified the interaction between string literals and continuation lines.
...
Fixes bug reported as SF bug #453728 .
2001-09-06 18:41:15 +00:00
Fred Drake
8b09f4985c
Make the examples for "Default Argument Values" more presentable and
...
less hostile to newbie use at the interactive prompt.
This is in response to SF bug #458654 .
2001-09-06 18:21:30 +00:00
Fred Drake
9c75ff785a
Fix parameter for PyInt_Check().
...
Add refcount information for other recently documented APIs.
2001-09-06 18:06:46 +00:00
Fred Drake
f8d7a5d391
Document the PyMethod_* type object, functions, and macros.
2001-09-06 17:12:44 +00:00
Fred Drake
396ca574dd
Document the rule that Python.h must be included before any standard
...
headers. This is the final checkin for SF bug #458768 .
2001-09-06 16:30:30 +00:00
Fred Drake
9b88b4c9e8
Do not #include <stdio.h> since Python.h already does that.
2001-09-06 16:20:33 +00:00
Fred Drake
adaca02f9e
Use the standard argument convention for main(), and conform to the
...
Python/C style guide.
2001-09-06 16:17:24 +00:00
Fred Drake
4d17b303bb
Several updates to cover omissions noted by Rich Salz.
...
This closes SF bug #458771 .
2001-09-06 15:51:56 +00:00
Fred Drake
f5072b9314
Document the "unixfrom" attribute of the rfc822.Message class.
...
Based on a patch by Skip Montanaro, this closes SF bug #458885 .
2001-09-06 15:07:55 +00:00
Martin v. Löwis
b0162f9afc
Patch #416079 : fix the debug string output when receiving telnet commands.
...
added all the telnet options known to arpa/telnet.h
added all the options registered with IANA as of today
added the possibility for the user to have it's own option negotiation callback
2001-09-06 08:51:38 +00:00
Skip Montanaro
bb5a465ca9
typo...
2001-09-05 19:27:13 +00:00
Martin v. Löwis
7c82a3e0fc
Patch #449815 : Set filesystemencoding based on CODESET.
2001-09-05 17:09:48 +00:00
Andrew M. Kuchling
2f0047af3b
Note some changes that I need to write about
2001-09-05 14:53:31 +00:00
Martin v. Löwis
44f8696171
Patch #428326 : New class threading.Timer.
2001-09-05 13:44:54 +00:00
Tim Peters
7eea37e831
At Guido's suggestion, here's a new C API function, PyObject_Dir(), like
...
__builtin__.dir(). Moved the guts from bltinmodule.c to object.c.
2001-09-04 22:08:56 +00:00
Andrew M. Kuchling
33a3b63e21
Correction: the Borland C port isn't fully operational yet
2001-09-04 21:25:58 +00:00
Fred Drake
757f7809e1
Add more detail to the descriptions of the shutil functions.
...
This closes SF bug #458223 .
2001-09-04 18:26:27 +00:00
Fred Drake
c05fc7dd9d
Added documentation for sys.maxunicode and sys.warnoptions.
...
Fixed a markup error which caused an em dash to be presented as a minus sign.
This closes SF bug #458350 .
2001-09-04 18:18:36 +00:00
Tim Peters
32f453eaa4
New restriction on pow(x, y, z): If z is not None, x and y must be of
...
integer types, and y must be >= 0. See discussion at
http://sf.net/tracker/index.php?func=detail&aid=457066&group_id=5470&atid=105470
2001-09-03 08:35:41 +00:00
Fred Drake
b86677079d
Move the long minidom example to a separate file; \verbatiminput does the
...
right thing with page breaks in long examples, while the verbatim
environment does not. This causes the example to wrap to the next page
instead of overwriting the page footer and bottom margin.
2001-09-02 06:07:36 +00:00
Fred Drake
481cf2c064
Added the "Host" header to the "GET" example.
...
This closes SF bug #457100 .
2001-09-01 02:35:23 +00:00
Andrew M. Kuchling
0e03f588f5
Add Jack Jansen's explanation of the MacOS X changes
2001-08-30 21:30:16 +00:00
Tim Peters
d507dab91f
SF patch #455966 : Allow leading 0 in float/imag literals.
...
Consequences for Jython still unknown (but raised on Jython-Dev).
2001-08-30 20:51:59 +00:00
Neil Schemenauer
55cdc88c09
Update documentation for GC API. Closes SF patch #421893 .
2001-08-30 15:24:17 +00:00
Fred Drake
3c0fc84b15
Update the links to the FIPS document that defines the Secure Hash
...
Algorithm. This closes SF bug #454917 .
2001-08-30 14:42:40 +00:00
Tim Peters
692323488b
Add a new function imp.lock_held(), and use it to skip test_threaded_import
...
when that test is doomed to deadlock.
2001-08-30 05:16:13 +00:00
Fred Drake
f9dc04341d
Fix a minor markup typo.
2001-08-29 02:34:10 +00:00
Barry Warsaw
da21ce3e31
On Fred's suggestion, convert sprintf() examples to use
...
PyString_FromFormat(). Also fixed one grammar problem, and a few
other mark-up issues. Sample code not checked.
2001-08-29 01:41:58 +00:00
Andrew M. Kuchling
0ab31b8562
Add METH_O and METH_NOARGS change
...
Rewrite snprintf() item a bit
Bump version number
2001-08-29 01:16:54 +00:00
Fred Drake
b5f17f2dc5
Revise comments about TeX & LaTeX for accuracy.
...
This closes SF bug #456222 .
2001-08-28 18:09:11 +00:00
Fred Drake
d800cff80d
Added explanation that [...] * n generates shallow copies of [...], so
...
the contents will be shared by multiple references.
This closes SF bug #455694 .
2001-08-28 14:56:05 +00:00
Fred Drake
5cb29a49c8
Fix a number of minor markup errors, and improve the consistency a bit.
2001-08-28 14:25:03 +00:00
Eric S. Raymond
46ccd1dae5
Plant a mention in the description of backreferences of the fact that
...
while \0 doesn't do what one might expect, \g<0> does.
2001-08-28 12:50:03 +00:00
Barry Warsaw
8c64a54f75
Refcount info for PyString_FromFormat() and PyString_FromFormatV().
...
Closes SF patch #455666 .
2001-08-28 02:32:04 +00:00
Barry Warsaw
c86aa57f58
Documentation for PyString_FromFormat() and PyString_FromFormatV().
...
Closes SF patch #455666 .
2001-08-28 02:31:28 +00:00
Michael W. Hudson
53da317801
Docs for the PEP 264 changes.
2001-08-27 20:02:17 +00:00
Guido van Rossum
88e0b5bee0
SF patch #454553 by Walter Dörwald: auto-guess content-type header for
...
ftp urls.
2001-08-23 13:38:15 +00:00
Skip Montanaro
0f10f84028
indicate that mktime is platform-dependent. See SF bug 434143.
2001-08-22 12:44:27 +00:00
Skip Montanaro
5ff41d16a8
indicate that the years for which the calendar function will work are
...
platform dependent. See SF bug 434143.
2001-08-22 12:43:38 +00:00
Fred Drake
16bb41934c
New \grammartoken markup, similar to \token but allowed everywhere.
2001-08-20 21:36:38 +00:00
Fred Drake
2a274a7e41
Add another name.
2001-08-20 21:33:41 +00:00
Fred Drake
cc8f44b884
Split "Extending & Embedding" into separate files, one per chapter.
2001-08-20 19:30:29 +00:00
Fred Drake
31d833d575
Added documentation for BoundedSemaphore(), contributed by Skip Montanaro.
...
This closes SF patch #452836 .
2001-08-20 18:49:00 +00:00
Fred Drake
0e40c3d012
Document PyTuple_GET_SIZE(), removing confusing sentence from PyDict_Copy()
...
description.
This fixes SF bug #453111 .
2001-08-20 16:48:59 +00:00
Eric S. Raymond
29bb115bae
Clean up some argument profiles, enrich the docstring.
2001-08-20 13:16:30 +00:00
Tim Peters
dbec7d2c16
Improve Windows time.clock() blurb; was missing return type and unit.
2001-08-19 01:38:03 +00:00
Eric S. Raymond
b60f2d0977
Framework code for compilerlike scripts.
2001-08-18 09:24:38 +00:00
Barry Warsaw
dbfe5e8507
Document that uu.decode() will always raise a uu.Error if out_file
...
isn't given, and the file in the uu header already exists. Also add a
description of the uu.Error exception class.
2001-08-17 20:01:06 +00:00
Fred Drake
2dc07946bf
Make sure that ampersand escaping is still performed on the contents of
...
local module tables (the lists of modules documented within a chapter,
inserted at the beginning of the chapter). If this is not done here,
the text is not part of the resulting documents when latex2html does the
processing normally.
This fixes a little bit more of SF bug #451556 .
2001-08-17 17:20:44 +00:00
Fred Drake
cb19976f1a
fix_font(): Instead of using a long if/elsif cluster, use a bloody
...
dictionary. Added some entries to the dictionary to fix part of
SF bug #451556 .
2001-08-16 21:56:24 +00:00
Fred Drake
457c4190f9
Fix typo reported by Joonas Paalasmaa: dada-->data
2001-08-16 21:25:24 +00:00
Fred Drake
739282da83
Re-write the description of the os.spawn*() functions, and cover the
...
whole family instead of just two.
This closes SF bug #451630 .
2001-08-16 21:21:28 +00:00
Martin v. Löwis
e3eb1f2b23
Patch #427190 : Implement and use METH_NOARGS and METH_O.
2001-08-16 13:15:00 +00:00
Fred Drake
ce1650f3a5
A large contribution from Dave Kuhlman describing what each of the slots
...
in the type object is used for, for many of the more commonly used slots.
Thanks!
(But there is still a lot more to write on this topic.)
Markup and organizational changes by your friendly neighborhood
documentation czar.
2001-08-15 19:07:18 +00:00
Fred Drake
87731762f2
Dave Kuhlman has contributed a nice improvement to the "Defining New Types"
...
section of the Extending & Embedding manual -- thanks!
2001-08-15 19:00:29 +00:00
Andrew M. Kuchling
94a7eba9db
Note addition of cleanfuture.py
2001-08-15 15:55:48 +00:00
Fred Drake
ce575bac5e
Fix a minor typo and mark an exception name that was missed.
2001-08-14 21:51:50 +00:00
Fred Drake
c0cf726d8c
Add material about the "r" and "u" prefixes for string literals; should
...
be reviewed for clarity.
Work around a bogosity in the HTML version of the escape sequences table
conversion.
2001-08-14 21:43:31 +00:00
Fred Drake
0cac5f697b
Added some examples of table markup.
2001-08-14 21:36:19 +00:00
Fred Drake
3e2aca48bd
Add information about __floordiv__() and __truediv__() methods for
...
implementing numeric objects in Python.
2001-08-14 20:28:08 +00:00
Fred Drake
d3ba10f4b5
Clarify the prompt in an example.
...
This closes SF bug #450633 .
2001-08-14 19:55:42 +00:00
Barry Warsaw
5ef99a0bc5
Describe the new semantics for setting and deleting a function's
...
__dict__ attribute. Deleting it, or setting it to a non-dictionary
result in a TypeError. Note that getting it the first time magically
initializes it to an empty dict so that func.__dict__ will always
appear to be a dictionary (never None).
Closes SF bug #446645 .
2001-08-14 18:22:24 +00:00
Fred Drake
680cabb225
Add "exceptions" to the list of fundamental modules
...
created by Py_Initialize().
This closes SF bug #450621 .
2001-08-14 15:32:16 +00:00
Fred Drake
280f7253e4
Insert omitted "the".
2001-08-14 11:42:13 +00:00
Fred Drake
bf781a95c0
Add the smtpd module to the list of undocumented modules; Barry needs to
...
write the documentation for this module.
2001-08-14 11:38:35 +00:00
Fred Drake
6943a29cbf
David Goodger <dgoodger@atsautomation.com>:
...
Documentation for difflib/ndiff refactoring: more of the ndiff functionality
has been moved to the underlying library (difflib).
This closes SF patch #445413 .
2001-08-13 19:31:59 +00:00
Fred Drake
84e58ab722
For the escape() function, added a reference to the quoteattrs() function
...
in xml.sax.saxutils, since that is the right function to use for quoting
attribute values.
This closes SF bug #444707 .
Cleaned up a variety of other minor markup errors.
2001-08-11 03:28:41 +00:00
Andrew M. Kuchling
9e9c1358e8
Add section on PEP 238 changes
...
Minor grammatical changes, reformattings, and an error fix from Keith Briggs
2001-08-11 03:06:50 +00:00
Fred Drake
1cf0f1751f
Add a note that the quoteattr() function is useful for HTML and SGML
...
attributes as well.
2001-08-10 22:14:17 +00:00
Fred Drake
11ee90289c
Added documentation for PyDict_Update() and PyDict_Merge().
2001-08-10 21:31:12 +00:00
Fred Drake
1cb560a653
Do more to be compatible with Windows/CygWin. Make error messages more
...
informative when a child process dies with an error.
This is a variation of parts of SF patch #429611 .
2001-08-10 20:17:09 +00:00
Fred Drake
9443dc31c1
Remove the use of the "cat" program. This improves portability to non-Unix
...
platforms.
This is part the response to SF patch #429611 .
2001-08-10 20:12:09 +00:00
Fred Drake
8a7b59e7b4
Added this LaTeX style file to the package since not all LaTeX installations
...
have it, especially on non-Unix platforms. (MikTeX in particular does not
have it.)
This is part of the response to SF patch #429611 .
2001-08-10 19:47:41 +00:00
Fred Drake
d635e3c468
Added a warning about reference cycles and memory consumption to the
...
section on functions which return stack frames.
This closes SF bug #449258 .
2001-08-10 17:37:33 +00:00
Fred Drake
6d8d72b0cb
Usage fix, problem reported by Keith Briggs.
2001-08-10 16:15:08 +00:00
Fred Drake
e89659c02d
Added documentation for the new rich comparison support.
...
This closes SF patch #428320 .
Added documentation for the new floordiv() and truediv() functions.
This is part of SF bug #449093 .
Re-organized the listing of functions to get better logical grouping.
2001-08-10 15:55:09 +00:00
Fred Drake
024ef6f493
Remove the bogus flags parameter from the PyFile_WriteString() signature;
...
it has no such parameter.
This closes SF bug #449761 .
2001-08-10 14:27:38 +00:00
Martin v. Löwis
9b75dca192
Expose nl_langinfo through locale where available.
2001-08-10 13:58:50 +00:00
Martin v. Löwis
8cc965c1fb
Patch #448474 : Add support for tell() and seek() to gzip.GzipFile.
2001-08-09 07:21:56 +00:00
Fred Drake
0197858f62
Added documentation for PyNumber_*FloorDivide(), PyNumber_*TrueDivide(),
...
PyInterpreterState_*Head(), PyInterpreterState_Next(), and
PyThreadState_Next().
Wrapped some long lines, added some others.
2001-08-08 19:14:53 +00:00
Fred Drake
03590c6bdc
Reference counting information for PyNumber_*FloorDivide() and
...
PyNumber_*TrueDivide().
2001-08-08 18:50:18 +00:00
Fred Drake
e54acfd8b2
Add option to push the development docs to SF without announcing, for
...
when the changes are just too small.
2001-08-08 05:41:01 +00:00
Fred Drake
ecab00176f
More names....
2001-08-08 05:39:52 +00:00
Fred Drake
3a5ec57456
Clean up some of the markup here -- be more consistent in the use of
...
semantic labels instead of presentational markup.
2001-08-08 05:39:29 +00:00
Fred Drake
a7d608d1cf
"Thin" version of floor division docs: add // to the list of operators
...
and //= to the list of other delimiter tokens.
I'll work on it again when it's not so late...
2001-08-08 05:37:21 +00:00
Andrew M. Kuchling
8c69c91be3
Document two new items
...
Correct error noticed by Keith Briggs
Re-indent a paragraph
2001-08-07 14:28:58 +00:00
Fred Drake
58212724f2
Add a comment on time.time() returning non-decreasing values except when
...
the clock is set back.
This closes SF bug #447945 .
2001-08-05 15:43:04 +00:00
Martin v. Löwis
c9908c4f5c
Document IPv6 changes. Contributed by itojun.
2001-08-04 22:22:45 +00:00
Fred Drake
53765753c4
Lots of new text and example code on embedding Python in C, contributed
...
by Albert Hofkamp. Some editing has been done for style and markup
consistency.
This also supplies an example of importing modules and calling a function
defined in the module, so this closes SF bug #440037 as well.
(The long example code was moved to a separate file so that it would
format properly.)
2001-08-04 01:58:36 +00:00
Fred Drake
b3cc29b493
Note that the mimetypes.MimeTypes class was added in Python 2.2.
2001-08-04 00:48:49 +00:00
Fred Drake
d5efb17086
Add documentation for the new aspects of the mimetypes module.
...
This closes the SF bug (feature request) #439710 .
2001-08-03 21:03:14 +00:00
Fred Drake
d86038d1be
Apply the new \mailheader macro where appropriate, and fix a few small
...
markup inconsistencies.
2001-08-03 18:39:36 +00:00
Fred Drake
7eac0cb04c
Define the \mailheader macro and document conventions for using it.
2001-08-03 18:36:17 +00:00
Fred Drake
30cf118cf7
Minor markup nits and slight style-guide conformance changes.
2001-08-03 17:11:33 +00:00
Jack Jansen
cb60dae6a1
Documented the runtimemodel attribute.
2001-08-03 13:19:56 +00:00
Fred Drake
5d54879647
Fix some of the example code; the reference objects do not support a
...
get() method; just calling them is sufficient. (There was a get() method
for this in an early version of the implementation.)
Reported by Mats Wichmann.
2001-08-03 03:50:28 +00:00
Fred Drake
8dd6ffd0ec
User-defined methods *can* contain things other than user-defined functions
...
as the callable, so use more flexible language.
2001-08-02 21:34:53 +00:00
Fred Drake
51629c245a
Add a caveat about boundary conditions and RE concatenation, so that the
...
documents do not make an overly-strong assertion about the properties of
RE concatenation.
Add an example of RE{m,} syntax and what it will and will not match.
2001-08-02 20:52:00 +00:00
Fred Drake
f90490ef94
Move away from apply() to using extended call syntax for some example
...
fragments when discussing equivalence of thhe C API to what a Python
programmer sees.
Added descriptions of PyEval_SetProfile() and PyEval_SetTrace().
2001-08-02 18:00:28 +00:00
Fred Drake
044bb4d22a
Explain that __init__() methods do not get to return values.
2001-08-02 15:53:05 +00:00
Fred Drake
388f37e6f6
Add anentry for the distutils.sysconfig module docs.
2001-08-02 15:13:58 +00:00
Fred Drake
ab70b38367
Update some incorrect comments about the bdist commands that exist.
...
Add an entry for the distutils.sysconfig module docs.
2001-08-02 15:13:15 +00:00
Fred Drake
25376c4f8b
Documentation for the distutils.sysconfig module.
2001-08-02 15:12:07 +00:00
Fred Drake
905dc558f1
Cleaned up the description of readline.set_completer().
...
Thanks to Nathaniel Gray for reporting the confusion.
2001-08-01 21:42:45 +00:00
Fred Drake
236ddd6834
Added more names.
2001-08-01 17:19:11 +00:00
Fred Drake
20c94913de
Minor re-wording in the exaplantion of sequence comparisons.
...
This closes SF bug #445749 .
2001-08-01 17:17:13 +00:00
Fred Drake
e74f8de385
Added an example of a string value for the replacement parameter to
...
re.sub().
This closes SF bug #446136 .
Fixed description of RE modifiers so that RE{#} and RE{#,} are more
clearly described and disambiguated (plain RE{#} had not been described
at all). Reported by Jeremy Craven via email.
2001-08-01 16:56:51 +00:00