513069028f
Fix API typo. The write buffer is not const. Closes SF 606216.
2002-09-08 04:39:28 +00:00
2c0d3224fc
tightened up the definition of \b and \B some more based upon discussion
...
after the last checkin.
2002-09-07 18:48:14 +00:00
44c42b9cf3
Added a tutorial note and example regarding the scope of loop variables
...
in a list comprehension. Includes a justification and a comparision
to regular for-loops.
Closes SF bug 605047.
2002-09-06 18:06:04 +00:00
5ccaf8f129
Apply diff3.txt (plus additional documentation)
...
from SF patch http://www.python.org/sf/554192
This adds two new functions to mimetypes:
guess_all_extensions() which returns a list of all known
extensions for a mime type, and add_type() which adds one
mapping between a mime type and an extension.
2002-09-06 16:15:58 +00:00
2c519981fb
update docs to reflect that \b considers underscore to be part of a word.
2002-09-06 14:38:23 +00:00
d918884bb8
Fix typo
2002-09-04 23:52:42 +00:00
a04c3d86ae
Fix typo
2002-09-04 15:12:07 +00:00
8e790e7007
expose PYTHON_API_VERSION macro as sys.api_version. Closes patch # 601456.
2002-09-03 13:25:17 +00:00
f62a89b1e0
Ignore encoding declarations inside strings. Fixes #603509 .
2002-09-03 11:52:44 +00:00
65b7282ef7
Add reminder about PEP293
2002-09-03 00:53:21 +00:00
3aeb632c31
PEP 293 implemention (from SF patch http://www.python.org/sf/432401 )
2002-09-02 13:14:32 +00:00
53d58bb369
Further SET_LINENO reomval fixes. See comments in patch #587933 .
...
Use a slightly different strategy to determine when not to call the line
trace function. This removes the need for the RETURN_NONE opcode, so
that's gone again. Update docs and comments to match.
Thanks to Neal and Armin!
Also add a test suite. This should have come with the original patch...
2002-08-30 13:09:51 +00:00
ee113f08f8
add warning about exception messages
2002-08-28 01:14:57 +00:00
9240be2a35
Note change in behavior from 1.5.2. The new argument to NameError is
...
an error message and not just the missing name.
Closes SF Bug 599869.
2002-08-27 23:53:23 +00:00
80a04a4894
Add strong security warning about the rexec module.
...
Closes SF patch #600861 .
Minor markup changes.
2002-08-27 16:46:06 +00:00
246beb2526
Don't use tempfile.mktemp(), since it produces annoying warnings, and
...
usually isn't what we want anyway.
2002-08-27 16:34:54 +00:00
ea76c98014
Implemented <, <=, >, >= for sets, giving subset and proper-subset
...
meanings. I did not add new, e.g., ispropersubset() methods; we're
going nuts on those, and, e.g., there was no "friendly name" for
== either.
2002-08-25 18:43:10 +00:00
7ad09552d0
Correct documentation of allow_reuse_address to match the actual script.
...
Closes SF bug 599681.
2002-08-25 16:27:33 +00:00
e87ab3fefe
Removed < <= > >= from the API. Implemented as comparisons of the
...
underlying dictionaries, there were no reasonable use cases (lexicographic
sorting of a list of sets is somewhat esoteric). Frees the operators
for other uses (such as strict subset and superset comparisons).
Updated documentation and test suite accordingly.
2002-08-24 07:33:06 +00:00
055be47b43
Fix typo reported to python-docs.
2002-08-23 21:19:53 +00:00
fa8dd5f407
Fix markup and punctuation
2002-08-23 18:10:54 +00:00
b81b252fab
s/_as_Temporarily_Immutable/_as_temporarily_immutable/g, because the
...
latter is what the code actually does.
2002-08-23 17:48:23 +00:00
54fd3e6ffc
pop(): An arbitrary element is removed, not a random element.
2002-08-23 17:45:43 +00:00
d10c6c949a
Adjust the markup in a few places so this will actually format.
...
Remove the third column in the tables since it isn't used.
2002-08-23 17:22:36 +00:00
d526011091
Add an entry for the sets module documentation.
...
Move another entry so the boilerplate doesn't get mixed up with
document-specific content.
2002-08-23 15:38:02 +00:00
584cb198f7
Load docs for sets.py
2002-08-23 15:18:38 +00:00
373198e751
Fix peculiar (and ungrammatical) wording in an example program.
2002-08-22 19:15:35 +00:00
13090e1025
Give the section on PEP 263 a more meaningful title, so readers will
...
be able to locate this information without knowing the PEP number.
2002-08-22 16:51:08 +00:00
5ec486b87a
Add a note that apply() is needed since the extended call syntax is
...
completely equivalent.
2002-08-22 14:27:35 +00:00
61cf4407be
Added a main() function and support to run this module as a script.
...
Closes SF feature request #588768 .
2002-08-21 20:56:21 +00:00
5b09eeea89
Clarify that even though some of the relevant specifications define the
...
order in which form variables should be encoded in a request, a CGI script
should not rely on that since a client may not conform to those specs, or
they may not be relevant to the request.
Closes SF bug #596866 .
2002-08-21 19:24:21 +00:00
a6e16a86c4
Replace all cases of "while 1" with "while True".
...
Though slightly slower, has better clarity and teaching value.
2002-08-21 04:54:00 +00:00
ffefb1df56
Clarify the endpos argument to the rx.match() method.
...
Closes SF bug #597177 .
2002-08-20 13:57:47 +00:00
bc4651083e
Cover the sets module.
...
(There's a link to PEP218; has PEP218 been updated to match the actual
module implementation?)
2002-08-20 01:34:06 +00:00
6974aa93c1
Create two subsections of the "Core Language Changes" section, because
...
the list is getting awfully long
Mention Karatsuba multiplication and some other items
2002-08-20 00:54:36 +00:00
11b795cd0f
Add versionadded for operator.pow
2002-08-19 22:38:01 +00:00
017778332f
Extend some comments on the order of values in the returns from
...
dict.items/keys/values/iteritems/iterkeys/itervalues().
2002-08-19 21:58:58 +00:00
45ec02aed1
SF patch 576101, by Oren Tirosh: alternative implementation of
...
interning. I modified Oren's patch significantly, but the basic idea
and most of the implementation is unchanged. Interned strings created
with PyString_InternInPlace() are now mortal, and you must keep a
reference to the resulting string around; use the new function
PyString_InternImmortal() to create immortal interned strings.
2002-08-19 21:43:18 +00:00
5959c559df
Added __pow__(a,b) to the operator module. Completes the pattern of
...
all operators having a counterpart in the operator module.
Closes SF bug #577513 .
2002-08-19 03:19:09 +00:00
dd32a91cc0
This is my patch
...
[ 587993 ] SET_LINENO killer
Remove SET_LINENO. Tracing is now supported by inspecting co_lnotab.
Many sundry changes to document and adapt to this change.
2002-08-15 14:59:02 +00:00
90e9a79afd
Add 'in' change
...
Revise sentence
Add two reminders
2002-08-15 00:40:21 +00:00
794643c314
Py_InitModule() and friends now accept NULL for the 'methods'
...
argument. This makes sense now that extension types can support
__init__ directly rather than requiring function constructors.
2002-08-14 20:59:38 +00:00
b8c20a723f
More updates describing FutureWarnings.
2002-08-14 16:40:54 +00:00
2f238c1b22
mkstemp's last argument changed from binary=True to text=False.
2002-08-14 16:37:10 +00:00
29ce2d7d1e
Document PyExc_FutureWarning
2002-08-14 16:06:28 +00:00
5c08a99b77
Remove a broken example of extreme backward compatibility; it is
...
simply not relevant any more.
Closes SF bug #595032 .
2002-08-14 15:26:18 +00:00
918af2aef7
The auto-reply text for the python-docs address. This is not automatically
...
updated when checkins are made, but I can get that updated when needed.
2002-08-12 22:01:42 +00:00
a132f6c38b
Accomodate the packaging changes when we unpack into the dev/doc/ area
...
on python.org.
2002-08-09 22:56:46 +00:00
1a0199a74f
Lots of changes to the packaging of the documentation, all to keep
...
directories clean where the packages are unpacked. Each package now
contains a single directory, Python-Docs-<version>/, which contains the
files for that version of the documentation.
Closes SF feature request #567576 .
2002-08-09 20:20:50 +00:00
830a5151c1
Doc portion of SF 589982 (tempfile.py rewrite, by Zack Weinberg).
...
Fred, please review!
2002-08-09 16:16:30 +00:00
ae7ef57cba
GvR pointed out that only enclosing function bodies are part of nested scopes.
2002-08-07 20:20:52 +00:00
b2865919cc
Document that heappop() and heapreplace() raise IndexError if the heap
...
is empty.
2002-08-07 18:56:08 +00:00
83dcf5a290
Apply character{} markup.
2002-08-07 16:53:17 +00:00
22c001bd29
Described responsibilty of weakly referenced extension types to initialize
...
the weakreflist to NULL in the constructor and to fill the tp_flags
slot with Py_TPFLAGS_HAVE_WEAKREFS. Closes SF bug 586583.
2002-08-07 16:18:54 +00:00
861bb02448
Describe nested scopes in the tutorial. Closes SF bug 500704.
2002-08-07 16:09:48 +00:00
3cfdc3402e
Documented os.fsync and os.fdatasync. Closes SF bug 584695.
2002-08-07 15:48:17 +00:00
442c7c7743
Clarify that the bool instances are acceptable return values from
...
__nonzero__(), in response to SF bug #579991 .
2002-08-07 15:40:15 +00:00
f7aa164d7a
Fix up some more markup problems.
2002-08-07 13:24:09 +00:00
95fa4ddf7b
Change the markup a bit more; the parameter was not marked as \var in the
...
sample code, and the note was marked as a logical thing.
2002-08-07 12:39:33 +00:00
63d5bead18
Fix markup errors.
2002-08-07 12:01:41 +00:00
d9fdb51df6
Document handling of raw-unicode-escapes. Closes SF bug 587087.
2002-08-06 22:36:26 +00:00
d37f75b88a
Added a note about the inability to specify a pathname to a non-existing
...
file in unix-Python.
2002-08-06 22:15:23 +00:00
4104b50b52
Changed a sentence that confused some people.
2002-08-06 22:14:23 +00:00
31f3db39f3
Fix the markup so it doesn't break formatting.
2002-08-06 21:36:06 +00:00
2d3c03df9a
Added references to the email package.
...
Closes SF bug #586937 .
2002-08-06 21:26:01 +00:00
43af5b5852
Add some fine points: METH_KEYWORDS implies METH_VARARGS, and ob_size
...
is no longer unused in type objects.
2002-08-06 17:18:56 +00:00
97c5fccd77
Remove mention of deprecated xreadlines method.
2002-08-06 17:03:25 +00:00
0fc01865f3
Document file.next(). Mark xreadlines obsolete (both method and
...
module). (One thing remains to be done: the gzip class has an
xreadline method; this ought to be replaced by an iterator as well.)
2002-08-06 17:01:28 +00:00
817918cc3c
Committing patch #591250 which provides "str1 in str2" when str1 is a
...
string of longer than 1 character.
2002-08-06 16:58:21 +00:00
545092b063
Add comment about os.path.walk()'s behavior with symbolic links.
2002-08-06 16:07:07 +00:00
950725f755
Mention list.sort()
...
Document heapq module
Add PEP263 section (not sure I really understand the PEP's effect on 8-bit
strings, though -- will have to experiment with it)
2002-08-06 01:40:48 +00:00
e72a9a13a1
SF patch #591305 Documentation err in bytecode defs
2002-08-05 23:33:54 +00:00
acb45d72b4
Note that True and False are pickable objects
2002-08-05 03:55:36 +00:00
00f1e3f5a5
Patch #534304 : Implement phase 1 of PEP 263.
2002-08-04 17:29:52 +00:00
c8389c91c2
Remove a syntax error in the example, spotted by Walter Hofman.
2002-08-04 15:27:25 +00:00
c61ec523ed
Add two reminders
2002-08-04 01:20:05 +00:00
0ad679ff0f
Document new heapreplace() function.
2002-08-03 18:53:28 +00:00
6e0da82a97
Document new heapify() function.
2002-08-03 18:02:09 +00:00
1acab695a7
Minor markup changes.
2002-08-02 19:46:42 +00:00
b481286504
Add a comment showing how one of the macros should be used.
2002-08-02 18:30:22 +00:00
ad09bbfce3
Add heapq module docs to the dependency information.
2002-08-02 18:20:34 +00:00
975121664e
Add docs for heapq.py.
2002-08-02 18:03:24 +00:00
de994d9130
indicate that 'b' is added to the mode flag if not given
2002-08-02 17:20:46 +00:00
74824584ef
Added new footnote about list.sort() stability. Repaired footnote about
...
using sort() with comparison functions (it made reference to the non-
existent "builtin-in function sort()").
BTW, I changed list.sort's docstring to contain the word "stable" -- the
easiest way to tell whether a particular Python version's sort *is* stable
is to look for "stable" in the docstring. I'm not sure whether to
advertise this <wink>.
2002-08-01 03:10:45 +00:00
543fb35cca
Replace DL_EXPORT with PyMODINIT_FUNC
2002-07-31 06:17:46 +00:00
5b11bdd0ed
SF patch #581414 : info reader bug
...
The "Matching vs. Searching" Info node is unreachable from the Info
program (but is fine in Emacs's Info mode). This patch seems to fix
it. This is the only occurrence where the info reader fails, so
probably it could be addressed in the python docs as a workaround.
Forwarded the report to the info maintainer.
2002-07-30 17:51:20 +00:00
085358a3e2
New functions for extension writers on Windows:
...
PyErr_SetExcFromWindowsErr(), PyErr_SetExcFromWindowsErrWithFilename().
Similar to PyErr_SetFromWindowsErrWithFilename() and
PyErr_SetFromWindowsErr(), but they allow to specify
the exception type to raise. Available on Windows.
See SF patch #576458 .
2002-07-29 14:27:41 +00:00
52f1b76f6c
Add posix.lchown()
2002-07-28 20:29:03 +00:00
0cec0ffc78
Patch #573770 : Implement lchown.
2002-07-28 16:33:45 +00:00
4ddfd50d85
Fix SF bug 587012, doc mentions inexistent builtin unistr
2002-07-28 13:55:20 +00:00
db40afaabe
Small clarifications when referring to the sys.exc_* variables so that
...
readers are not given the wrong impression that they should be using those
on a regualar basis.
This closes SF bug #585598 .
2002-07-25 21:11:23 +00:00
403e351dfc
Flesh out description of getlogin() and recommend against using it.
2002-07-24 15:32:25 +00:00
ef5d06bd3f
[Bug #580462 ] Mention changes to GC API
...
Mention portable strptime()
Move C-level sections farther down in the file
2002-07-22 19:21:06 +00:00
a982eb1eb5
Sort changed modules into alphabetical order; no other changes
2002-07-22 18:57:36 +00:00
3c305d966d
Rewrite a paragraph, and use correct mark-up
2002-07-22 18:50:11 +00:00
bba23a897e
SF bug #583894 , add doc for DL_IMPORT/DL_EXPORT deprecation
2002-07-22 13:18:59 +00:00
1cfcafceb6
add versionadded to doc
2002-07-20 00:46:12 +00:00
18eb8b85b3
Doc patch from SF 474274 (pure Python strptime by Brett Cannon).
2002-07-19 17:09:36 +00:00
4da01ed9a8
Substantially flesh out extended slice section. I think this is probably
...
done now.
2002-07-19 15:48:56 +00:00
f0d777c56b
A few days ago, Guido said (in the thread "[Python-Dev] Python
...
version of PySlice_GetIndicesEx"):
> OK. Michael, if you want to check in indices(), go ahead.
Then I did what was needed, but didn't check it in. Here it is.
2002-07-19 15:47:06 +00:00
8235ea1c3a
Land Patch [ 566100 ] Rationalize DL_IMPORT and DL_EXPORT.
2002-07-19 06:55:41 +00:00
f0b095d804
Added documentation for the buffer_text and related attributes of the
...
xmlparser object provided by pyexpat, new in Python 2.3.
2002-07-17 20:31:52 +00:00
50ceb68b4f
Change staticforward and statichere to just use static.
...
Removed ^M from some line-ends.
2002-07-17 16:42:48 +00:00
a3cd9bbaa3
Remove now-obsolete staticforward/statichere discussion.
2002-07-17 16:40:39 +00:00
2095b9690f
reduce(): Clarified what is returned in the case of a sequence 1 item long and
...
initial/default value.
2002-07-17 13:55:33 +00:00
9534e14033
Record the decision that StopIteration is a sink state (see recent
...
discussion in python-dev with subject "Termination of two-arg iter()").
Implementation will follow.
2002-07-16 19:53:39 +00:00
54ed2d32f9
Clarify that the description of sys.path[0] is only valid upon program
...
start-up.
2002-07-15 16:08:10 +00:00
346386fedc
Add more items
...
Use \cfunction instead of \function in various places
Add contributor names
2002-07-12 20:24:42 +00:00
3e59f72075
Clarify the return value of __nonzero__(): It *must* be an integer.
...
Closes SF bug #579991 .
2002-07-12 17:15:10 +00:00
20e5abc86e
Make another pass through Misc/NEWS and add stuff.
...
Bump version number.
2002-07-11 20:50:34 +00:00
e995d16f71
Add some items
...
Expand the "Other Language Changes" section
Rewrite various passages.
2002-07-11 20:09:50 +00:00
7845e7c726
[Bug #567607 ] Suggest METH_NOARGS to replace PyArg_NoArgs
2002-07-11 19:27:46 +00:00
e4523c46b9
Document gc.get_objects().
...
Closes SF bug #578308 .
2002-07-10 19:21:07 +00:00
4254cbd29c
Note that unicode() can raise LookupError for unknown codecs.
...
Closes SF bug #513666 .
2002-07-09 05:25:46 +00:00
eab5f8a43d
Remove unused variable.
2002-07-09 03:24:32 +00:00
7c321a80f9
The Py_REF_DEBUG/COUNT_ALLOCS/Py_TRACE_REFS macro minefield: added
...
more trivial lexical helper macros so that uses of these guys expand
to nothing at all when they're not enabled. This should help sub-
standard compilers that can't do a good job of optimizing away the
previous "(void)0" expressions.
Py_DECREF: There's only one definition of this now. Yay! That
was that last one in the family defined multiple times in an #ifdef
maze.
Py_FatalError(): Changed the char* signature to const char*.
_Py_NegativeRefcount(): New helper function for the Py_REF_DEBUG
expansion of Py_DECREF. Calling an external function cuts down on
the volume of generated code. The previous inline expansion of abort()
didn't work as intended on Windows (the program often kept going, and
the error msg scrolled off the screen unseen). _Py_NegativeRefcount
calls Py_FatalError instead, which captures our best knowledge of
how to abort effectively across platforms.
2002-07-09 02:57:01 +00:00
c6a525e993
Fix typo reported by Kent Engström, and a bunch of broken markup.
2002-07-08 14:42:22 +00:00
50e1286c00
Fix typo: "an Unicode string" --> "a Unicode string"
...
Clarify the return value when the parameter is a Unicode object.
2002-07-08 14:29:05 +00:00
82bac5952f
Fixed a typo and updated information about using the Times fonts when
...
formatting PostScript documents. Reported by Dave Kuhlman.
2002-07-08 14:10:41 +00:00
388fba8504
Added font-setting line (and associated comments) to the A4 version of
...
this file; the lack of this was causing the A4 version of tutorial to
use really bad Type 3 fonts instead of Type 1 fonts, which also
bloated the file size substantially.
I thought there was a SourceForge bug for this, but couldn't find it.
2002-07-08 14:08:48 +00:00
291e9ee341
Fix a typo.
2002-07-04 08:36:53 +00:00
b1af86a1d7
Revise asyncore documentation and document asynchat for the first time.
2002-07-03 18:36:39 +00:00
df872a2052
No need to be ambiguous about *how* extended slices and built-in types
...
have changed.
Uncomment a heading so that PendingDeprecationWarning doesn't seem so
out of place.
2002-07-03 12:02:01 +00:00
228f6e4e7a
Fix up a few more consistency nits and incorrectly applied markup.
...
Further clarify the English-centricity of fix_sentence_endings.
2002-07-03 05:08:48 +00:00
c412617779
Add annotations that describe the change in the "errors" and "failures"
...
attributes of the TestResult.
2002-07-02 22:46:42 +00:00
387c8b5f37
Update the documentation of the errors and failures attributes of the
...
TestResult object. Add an example of how to get even more information for
apps that can use it.
Closes SF bug #558278 .
2002-07-02 22:34:44 +00:00
285f4a7db7
Don't list all the keyword args to the TextWrapper constructor in the
...
classdesc -- just use "..." with prose explaining the correspondence
between keyword args and instance attributes.
Document 'width' along with the other instance attributes.
Describe default values consistently.
Typo fixes.
2002-07-02 21:48:12 +00:00
2c22e85ae7
Attempt to clarify removedirs().
...
Based on SF bug #574773 .
2002-07-02 21:03:49 +00:00
ca23ee273e
Deal with & remove the XXX comments.
...
Change the markup to be more like the rest of the documentation.
2002-07-02 20:37:12 +00:00
ad74b7d4b3
Abstract the creation of signature lines for callable things; the new
...
\py@sigline macro will wrap the argument list so it will not extend into
the right margin.
Substantially based on a contribution from Dave Cole.
This addresses one of the comments in SF bug #574742 .
2002-07-02 20:32:50 +00:00
abe7c1a4af
Minor markup adjustments, consistency changes, and shorten a long
...
line.
2002-07-02 16:17:58 +00:00
7c1bb9c528
Add refcount info for PyErr_SetFromWindowsErr() and
...
PyErr_SetFromWindowsErrWithFilename().
2002-07-02 16:16:18 +00:00
4f2722ac9b
Docs for PyErr_SetFromWindowsErrWithFilename() and
...
PyErr_SetFromWindowsErr().
Fixes SF# 576016, with additional markup.
2002-07-02 15:47:03 +00:00
7d650ca83b
Implement the encoding argument for toxml and toprettyxml.
...
Document toprettyxml.
2002-06-30 15:05:00 +00:00
550fd5d799
Fixed bug 574978 shutil example out of sync with source code
2002-06-30 04:43:20 +00:00
8a9e8b6d0e
Fix bug 575221 referred to dictionary type instead of dict.
2002-06-30 04:32:38 +00:00
78e057a32a
Clarify the version information for the unicode() built-in.
...
Closes SF bug #575272 .
2002-06-29 16:06:47 +00:00
ae64f3adcd
Add documentation for new textwrap module.
2002-06-29 02:38:50 +00:00
8b46c71d5b
Typo fix.
2002-06-29 01:23:45 +00:00
d805fefff4
Added support for some of the more recently defined macros and
...
environments.
2002-06-27 18:38:06 +00:00
2c813818c8
Clean up some markup.
2002-06-27 18:30:34 +00:00
dcd0500664
dis.dis() also supports modules
2002-06-26 22:32:47 +00:00
292724d989
Fix various typos reported to python-docs.
2002-06-26 21:52:26 +00:00
33fd5f7e02
Fix typo reported to python-docs.
2002-06-26 21:25:15 +00:00
dcdf48a5c7
Add some acks
2002-06-26 13:28:19 +00:00
d003a2a54f
Describe textwrap module
2002-06-26 13:23:55 +00:00
ca0383d3a3
Fix bug #573916 . Sender and recipients reversed in email example.
2002-06-26 07:51:32 +00:00
763805dab2
add seealso link to the bisect module
2002-06-26 05:22:08 +00:00
09d9f86c77
add /F's PriorityQueue example
2002-06-26 05:07:28 +00:00
fdc34315f7
Add a reminder
2002-06-26 00:03:05 +00:00
Raymond Hettinger
Skip Montanaro
Walter Dörwald
Martin v. Löwis
Andrew M. Kuchling
Michael W. Hudson
Fred Drake
Tim Peters
Greg Ward
Neal Norwitz
Guido van Rossum
Barry Warsaw
Steve Holden
Jack Jansen
Mark Hammond
Thomas Heller
Jeremy Hylton