57ce1430b2
Document that get_content_charset() coerces its return value to lower
...
case.
2002-10-10 15:22:16 +00:00
dbe3f76270
Patch #569139 : Implementation of major, minor and makedev.
2002-10-10 14:27:30 +00:00
3e3e1296f0
[Bug #621039 ] Fix broken link
2002-10-10 11:32:30 +00:00
83992480ed
[Bug #621038 ] Remove duplicated item
2002-10-10 11:31:48 +00:00
aa02c8441b
Accept Armin's documentation patch for SF bug #558179 .
...
Adjusted some markup to make the descriptions more consistent.
2002-10-09 22:33:23 +00:00
0a6fa9619e
Minor edits and markup fixes
2002-10-09 12:11:10 +00:00
8696ebcd28
Add os.path.supports_unicode_filenames for all platforms,
...
sys.getwindowsversion() on Windows (new enahanced Tim-proof <wink>
version), and fix test_pep277.py in a few minor ways.
Including doc and NEWS entries.
2002-10-08 02:44:31 +00:00
20eae69a9f
Document PEP 293.
2002-10-07 19:01:07 +00:00
bd5e38d4cc
Document PEP 277 changes.
2002-10-07 18:52:29 +00:00
74653820e3
Modified presentation of the grammar for calls to be easier to read
...
for both HTML and typeset renderings. Corresponds to revision
1.53.4.8 on the r22-maint branch.
2002-10-07 16:28:38 +00:00
e9ce0b0fea
Patch #448038 : Add move(). Report errors from copytree as in shutil.Error.
2002-10-07 13:23:24 +00:00
a844f2d165
Document patch #594001 .
2002-10-05 09:46:48 +00:00
0f345567fe
Add a section to be written; remove reference to deleted code
2002-10-04 22:34:11 +00:00
57b38ed424
Remove some unnecessary dependencies (minor).
2002-10-04 19:23:06 +00:00
b915a38b6f
Added refcount information for PyObject_GetIter().
2002-10-04 18:58:58 +00:00
0ba5541a0e
Add a comment to the top of the file explaining why the file is here.
2002-10-01 18:20:16 +00:00
cfb30e23d1
build(): Use self.builddir, not self.doc when copying the icons, so
...
they'll end up in the right directory when --dir is used.
2002-10-01 15:38:01 +00:00
c0e066a7b8
When the HTML output dir is specified using --dir=~/foo, the tilde
...
needs to be expanded by mkhowto, since the shell won't touch it except
at the start of the complete argument.
2002-10-01 15:30:56 +00:00
dd868d32e0
nits
2002-10-01 15:29:09 +00:00
73ec98357e
Include the --dir argument in the help text.
2002-10-01 15:24:03 +00:00
15a159c231
Change the default path to icons so that "mkhowto" does the "right thing" by
...
default when used for 3rd-party docs. This requires the standard Python docs
to specify a location, but they are a bit of a special case in sharing one set
of icons among several documents.
2002-10-01 15:20:20 +00:00
de6977f441
Added an introduction.
2002-10-01 15:13:29 +00:00
c61617320f
Stub document for the stand-alone email package distribution.
...
Barry, please add a reasonable abstract!
2002-10-01 14:38:47 +00:00
6516e14968
Minor style nit for referring to other attributes of the same class
...
from an attributes description.
2002-10-01 14:29:58 +00:00
fcc31b44d2
Split the long email package examples into separate files and use
...
\verbatiminput instead of the verbatim environment -- this does the "right
thing" regarding page breaks in long examples for the typeset formats, and
has nice benefits for the HTML version as well.
2002-10-01 14:17:10 +00:00
ea66abc6e2
Cleaned up the examples.
2002-10-01 04:48:06 +00:00
5db478fa29
Proofread and spell checked, all except the Examples section (which
...
I'll do next).
2002-10-01 04:33:16 +00:00
5b9da893d3
Vast update to email version 2. This could surely use proofreading.
2002-10-01 01:05:52 +00:00
2ca041fde0
items(): New method, provided by Gustavo Niemeyer in SF bug #545096 .
2002-09-27 15:49:56 +00:00
4613876ee3
Add deprecation notices to the documentation to reflect recent additions to
...
PEP 4.
2002-09-25 22:13:27 +00:00
d80032b009
Update some comments about what version of the documentation tools
...
code to use.
2002-09-25 21:41:22 +00:00
e134158f23
Finish & commit some docs for markup that's been in use for a while.
2002-09-25 18:44:21 +00:00
111ee3208f
Ok, read the source this time: PyErr_SetObject() does not steal a reference.
2002-09-25 02:34:27 +00:00
5ec22f2d7b
Another try at clarifying what goes into and comes out of Unicode objects.
...
Document the indices() method of slice objects.
2002-09-24 21:09:13 +00:00
3e930ba55f
Another try at clarifying what goes into and comes out of Unicode objects.
2002-09-24 21:08:37 +00:00
2f93644c1d
Clarify documentation for PyErr_SetObject() to describe the reference
...
count behavior.
2002-09-24 16:45:16 +00:00
36c2bd8e34
Remove spurious period.
2002-09-24 15:32:04 +00:00
7b788e0582
Clarify that len() of a Unicode string returns the number of storage units,
...
not abstract characters.
2002-09-24 13:57:21 +00:00
02669a35bc
Tweak description of PortableUnixMailbox: "From " lines are actually
...
quoted (or mangled) *at* delivery-time, not "well before" it. (At least
that's how Exim and qmail work.)
2002-09-23 19:32:42 +00:00
c687401337
Fix typos: despatcher -> dispatcher.
2002-09-17 15:19:12 +00:00
583db0d92b
Fix a couple of minor markup glitches.
2002-09-14 02:03:25 +00:00
dcfd825c11
Add two items
2002-09-13 22:21:42 +00:00
c1ddc505d9
Minor revision to the "\\" patch, including updating the docs a little to
...
accomodate the fact that they are more general now that they are for the
os.path module and not just posixpath.
This and the previous patch should be combined and applied to the 2.2-maint
branch.
2002-09-12 18:01:26 +00:00
c12909bcc6
add note about os.path.join and drive letters on Windows.
2002-09-12 17:39:56 +00:00
b7c1895ec5
Fix typo reported by Paul Clifford.
...
Note that there is no str.joinfields(), use str.join() instead.
2002-09-12 14:16:07 +00:00
73e8ebfc5a
Revise text about the level of DOM support, and provide pointers to
...
the work of the XML-SIG in the main body of the text.
Modify the markup in a few places to avoid wrapping lines in bad
places, and just general cleanliness.
2002-09-11 22:03:47 +00:00
504bc4f3b7
Remove mentioning of Python 2.0 limitations. Fixes #607783 .
2002-09-11 16:26:03 +00:00
691fb55dd2
Clarify who maintains Tkinter and who maintains Tk.
2002-09-10 21:59:17 +00:00
d3e0265373
Document type and semantics of the tp_print return value. Closes SF 606464.
2002-09-10 13:48:01 +00:00
a32c994129
Always generate floats for stat_result; fix configure test.
2002-09-09 16:17:47 +00:00
94717ed1d4
Patch #606592 : Subsecond timestamps in stat_result.
2002-09-09 14:24:16 +00:00
8a64d40949
Fix typo. Close SF Bug 606354.
2002-09-08 22:26:13 +00:00
a0e4d6ceaf
Clarified that the footnote applies to versions 1.5 and after instead of
...
just version 1.5. Closes SF bug 577793.
2002-09-08 21:10:54 +00:00
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
09d6b928e7
Add a reminder
2002-06-25 23:57:17 +00:00
c5e2792ab4
Talk about interfaces rather than implementation classes where appropriate.
...
Add hyperlinks to make the documentation on the Attributes and AttributesNS
interfaces more discoverable.
Closes SF bug #484603 .
2002-06-25 17:10:50 +00:00
b6aa9cbb96
Added some more links to the "See also" section.
2002-06-25 16:58:58 +00:00
7bc121a4fb
When talking about interfaces, use the interface names, not the names
...
of the implementation classes. (Remove the "Impl" from two names.)
2002-06-25 16:25:01 +00:00
f0236d7374
Fix typo
2002-06-25 15:26:59 +00:00
07dc91800f
Close bug 480337: Dict used before dicts explained. Added explanation
...
and examples of the dict() constructor.
2002-06-25 15:13:18 +00:00
04e7e0c60f
Close bug 417930 by clarifying augmented assignment docs
2002-06-25 13:36:41 +00:00
5ed3fa6578
Fix SF bug 568269 by enclosing 'computername' in a raw string
2002-06-25 04:53:05 +00:00
7fd9ced4ca
Minor English grammar correction
2002-06-25 04:04:14 +00:00
7951f60f45
Fix spacing in loop example
2002-06-25 03:17:03 +00:00
563d12d145
SF # 572928 One word change for lib/libgettext.tex
...
Fix typo.
2002-06-24 02:22:39 +00:00
723f94bd66
Convert the example C code to ANSI rather than K&R.
...
This matches the Python C style guide (PEP 7).
Closes SF patch #571489 .
2002-06-22 01:42:00 +00:00
53540ab071
Correct the RE equivalent of scanf()'s %x and %X patterns.
...
Closes SF bug #572169 .
2002-06-22 01:07:37 +00:00
6f45eeb0f3
Typo fix.
2002-06-21 12:33:08 +00:00
1d1e1dba12
Corrected return type and value information for PyUnicode_Count() and
...
PyUnicode_Find().
This closes SF bug #566631 .
2002-06-20 22:07:04 +00:00
473f46a853
Make the docs for string.capitalize() match those of str.capitalize()
...
(which makes it more clear).
Closes SF bug #571767 .
2002-06-20 21:18:46 +00:00
807354f3b6
Add a note that divmod() with complex numbers is deprecated.
2002-06-20 21:10:25 +00:00
dce695aa4e
Added reference to the Expat home page.
2002-06-20 21:06:03 +00:00
81932e234b
Try to improve the explanation of the "raise" statement and how its arguments
...
are interpreted.
This closes SF bug #532467 .
2002-06-20 20:55:29 +00:00
e08c9dbffc
Simplify the production for argument list, making sure that it
...
actually allows all the legal syntax, and nothing else. Previously,
it did not allow a call like func(arg, **dictionary).
This closes (again!) SF bug #493243 .
2002-06-20 14:23:15 +00:00
10cbe8dcbc
SF 563530 added missing methods for emulating numeric types
2002-06-20 06:12:37 +00:00
f4bf7aa292
Typo: bites --> bytes
...
(Hanging around small kids too much...;)
2002-06-18 20:38:05 +00:00
9ea01d415f
Add description of the deadlock problem with child processes and pipes, and
...
hints about how to work around it.
Closes SF bug #530637 .
2002-06-18 20:30:37 +00:00
a23b5739bb
Add a note about "as" not being a keyword, though it has special meaning
...
when used as part of the import statement.
Note that both "as" and "None" becoming keywords in the future.
Closes SF bug #553262 .
2002-06-18 19:17:14 +00:00
69d1fd2fdb
Note the limitation that mime_decode_header() only works for Latin-1.
...
Closes SF bug #551912 .
2002-06-18 18:51:30 +00:00
074712112b
Played contortionist games with the argument_list production so it
...
might be easier to understand.
This relates to SF bug #493243 , which will be closed.
2002-06-18 18:42:01 +00:00
4837fa3a54
\productioncont: Replace leading spaces with so that it's
...
possible to control the indentation of continuation lines.
cfuncline_helper(): Only mark the argument names are <var>, not the
whole argument list. This leaves the argument types in the same
font as the return type. Based on a casual suggestion from
Guido.
2002-06-18 18:30:28 +00:00
f6e902717e
Refactor the generation of signature lines for funcdesc, methoddesc,
...
and friends. This was part of the changes to the presentation of
signature lines, but does not include any of the aspects that people
questioned.
2002-06-18 18:24:16 +00:00
7f59124693
Clarified documentation for os.access().
...
Patch contributed by Sean Reifschneider.
Closes SF patch #570618 .
2002-06-18 16:15:51 +00:00
28bdc624a8
Clarified description of error handling for shutil.rmtree().
...
This closes SF patch #569832 .
2002-06-18 14:31:04 +00:00
b084017c7a
Fix documentation for PyMarshal_WriteObjectToFile() and
...
PyMarshal_WriteObjectToFile().
This closes SF bug #533735 .
2002-06-17 15:44:18 +00:00
6fc22f6c3d
Ensure \verbatiminput always uses a unique filename for each input file in
...
the "Download as text" link. Previously, it could map multiple source files
to a single name since all files end up with the same extension.
This closes SF bug #558279 .
2002-06-17 15:01:05 +00:00
9f6e104c80
Add reminder, and a new POSIX function
...
Tweak traceback display for consistency
2002-06-17 13:40:04 +00:00
495afea36e
Typo.
2002-06-17 12:51:57 +00:00
3fca291a52
Add IMAP4 QUOTA extension methods
2002-06-17 07:07:20 +00:00
a0c5e9fb74
Clean up descriptions of PyObject_RichCompare() and PyObject_RichCompareBool()
...
based on comments from David Abrahams.
Added refcount information for these functions.
2002-06-14 14:35:56 +00:00
a8ef0d1df2
Anchors ("a" elements) used only for the name attribute should not
...
change color on hover, only those that are link sources (href
attributes).
2002-06-14 13:47:58 +00:00
1e4519faaa
Make a start at describing the results of class/type unification
...
in the type documentation.
2002-06-14 09:16:40 +00:00
6c123efe3d
Refer the reader to the correct module for constant definitions.
...
This closes SF bug #550777 .
2002-06-14 01:58:19 +00:00
1f68fc7fa5
SF bug # 493951 string.{starts,ends}with vs slices
...
Handle negative indices similar to slices.
2002-06-14 00:50:42 +00:00
585775bf11
Document the Binary.data attribute.
...
This closes SF bug #562878 .
2002-06-14 00:33:02 +00:00
9c92b69a54
Use \code{True} (or False) instead of true/false.
...
Not sure if code is correct, but that is what's in this file.
I've seen \constant{True} in other places.
2002-06-14 00:27:13 +00:00
cc5c6947a6
Add "version added" for getpgid
2002-06-13 21:19:25 +00:00
606edc1d97
Patch #568235 : Add posix.setpgid.
2002-06-13 21:09:11 +00:00
fea59e7f76
The opcode FOR_LOOP no longer exists.
2002-06-13 17:59:51 +00:00
efb9097add
Do not claim that getlocale() returns a tulpe; that is not always true.
...
Closes SF bug #568577 .
2002-06-13 17:54:06 +00:00
11ba094957
Major overhaul of timeout sockets:
...
- setblocking(0) and settimeout(0) are now equivalent, and ditto for
setblocking(1) and settimeout(None).
- Don't raise an exception from internal_select(); let the final call
report the error (this means you will get an EAGAIN error instead of
an ETIMEDOUT error -- I don't care).
- Move the select to inside the Py_{BEGIN,END}_ALLOW_THREADS brackets,
so other theads can run (this was a bug in the original code).
- Redid the retry logic in connect() and connect_ex() to avoid masking
errors. This probably doesn't work for Windows yet; I'll fix that
next. It may also fail on other platforms, depending on what
retrying a connect does; I need help with this.
- Get rid of the retry logic in accept(). I don't think it was needed
at all. But I may be wrong.
2002-06-13 15:07:44 +00:00
178153f8d6
Add documentation for PyObject_RichCompare() and PyObject_RichCompareBool(),
...
constributed by David Abrahams.
This closes SF patch #568081 .
2002-06-13 11:51:48 +00:00
e9996c6093
Add version annotations for some older changes to the calendar module.
...
Closes SF patch #567867 .
2002-06-13 01:34:50 +00:00
e3fdc975c0
SF bug 567826. Document new opcodes:
...
['BINARY_FLOOR_DIVIDE', 'BINARY_TRUE_DIVIDE',
'INPLACE_FLOOR_DIVIDE', 'INPLACE_TRUE_DIVIDE', 'GET_ITER',
'YIELD_VALUE', 'FOR_ITER', 'CONTINUE_LOOP']
2002-06-12 15:33:08 +00:00
5efaf7eac8
This is my nearly two year old patch
...
[ 400998 ] experimental support for extended slicing on lists
somewhat spruced up and better tested than it was when I wrote it.
Includes docs & tests. The whatsnew section needs expanding, and arrays
should support extended slices -- later.
2002-06-11 10:55:12 +00:00
55ad7f84a4
Completely revise markup for the list of list methods; the new markup matches
...
the semantics and presentation used in the library reference.
Added an explanation of the use of [...] to denote optional arguments, since
this is the only use of this in a signature line.
Closes SF bug #567127 .
2002-06-11 02:56:17 +00:00
a861d552c3
Document that the key should not contain null bytes.
2002-06-10 19:42:43 +00:00
db9198a8b5
SF bug 563750 (Alex Martelli): posix_tmpfile():
...
The file returned by tmpfile() has mode w+b, so use that in the call
to PyFile_FromFile().
Bugfix candidate.
2002-06-10 19:23:22 +00:00
7f147a772d
Tweak traceback message to avoid LaTeX2HTML bug
...
Add a reminder
2002-06-10 18:58:19 +00:00
eb914881af
Fix typo
2002-06-10 15:53:05 +00:00
f70a0a8471
Fix typo, and add some reminders
2002-06-10 13:22:46 +00:00
497bdd69f2
Tweak the description of pymalloc. Mention pymemcompat.h.
2002-06-10 13:19:42 +00:00
715b861d94
Clarify the interaction between timeout/non-blocking mode, makefile
...
and fromfd.
2002-06-07 12:38:23 +00:00
62a7f63a24
Fix typo
2002-06-07 12:36:44 +00:00
fc9823b1a9
Clarify the interaction between blocking and timeouts. Explain that
...
fromfd() assumes a blocking non-timeout socket.
2002-06-07 03:39:21 +00:00
bdbd84fdac
Add version info, and fix another typo and wording spotted by /F. I think this is what he meant. :-)
2002-06-06 22:24:10 +00:00
1a06fb0605
Fix typo spotted by Fredrik Lundh.
2002-06-06 22:19:20 +00:00
6c6d662760
Fix some markup errors and adjust wording slightly.
2002-06-06 21:57:48 +00:00
be946bfea7
SF patch 555085 (timeout socket implementation) by Michael Gilfix.
...
I've made considerable changes to Michael's code, specifically to use
the select() system call directly and to store the timeout as a C
double instead of a Python object; internally, -1.0 (or anything
negative) represents the None from the API.
I'm not 100% sure that all corner cases are covered correctly, so
please keep an eye on this. Next I'm going to try it Windows before
Tim complains.
No way is this a bugfix candidate. :-)
2002-06-06 21:51:01 +00:00
446a25fa3c
Patch 473512: add GNU style scanning as gnu_getopt.
2002-06-06 10:58:36 +00:00
293dd4b77b
Fix up Guido's markup.
2002-06-04 16:25:57 +00:00
474458da48
Add constants BOM_UTF8, BOM_UTF16, BOM_UTF16_LE, BOM_UTF16_BE,
...
BOM_UTF32, BOM_UTF32_LE and BOM_UTF32_BE that represent the Byte
Order Mark in UTF-8, UTF-16 and UTF-32 encodings for little and
big endian systems.
The old names BOM32_* and BOM64_* were off by a factor of 2.
This closes SF bug http://www.python.org/sf/555360
2002-06-04 15:16:29 +00:00
92cf95f45b
Addressed SF bug 421973 (finally).
...
Rewrote the subsection on coercion rules (and made it a proper
subsection, with a label). The new section is much less precise,
because precise rules would be too hard to give (== I don't know what
they are any more :-). OTOH, the new section gives much more
up-to-date information.
Also noted that __coerce__ may return NotImplemented, with the same
meaning as None.
I beg Fred forgiveness: my use of \code{} is probably naive. Please
fix this and other markup nits. An index entry would be nice.
This could be a 2.2 bugfix candidate, if we bother about old docs
(Fred?)
2002-06-03 19:06:41 +00:00
59b2a74c75
SF bug 533625 (Armin Rigo). rexec: potential security hole
...
If a rexec instance allows writing in the current directory (a common
thing to do), there's a way to execute bogus bytecode. Fix this by
not allowing imports from .pyc files (in a way that allows a site to
configure things so that .pyc files *are* allowed, if writing is not
allowed).
I'll apply this to 2.2 and 2.1 too.
2002-05-31 21:12:53 +00:00
9788384d02
Explain that tp_basicsize must provide alignment for the items.
2002-05-31 21:00:18 +00:00
9b414ac93e
Update links and information on PyQt/PyKDE.
2002-05-31 18:21:56 +00:00
187b1d8260
Add OS/2 text
2002-05-29 19:20:57 +00:00
d7abe2a0fb
Various minor rewrites
2002-05-29 17:33:48 +00:00
72b58e0c5f
More additions
2002-05-29 17:30:34 +00:00
d68f5171eb
As discussed on python-dev, add a mechanism to indicate features
...
that are in the process of deprecation (PendingDeprecationWarning).
Docs could be improved.
2002-05-29 15:54:55 +00:00
2b6edce773
Rearrange paragraph
2002-05-27 17:19:46 +00:00
34f20eac98
This is patch
...
[ 559250 ] more POSIX signal stuff
Adds support (and docs and tests and autoconfery) for posix signal
mask handling -- sigpending, sigprocmask and sigsuspend.
2002-05-27 15:08:24 +00:00
38d53451b7
Define the "all" target more reasonably, but retain "html" as the default
...
target.
2002-05-25 20:28:46 +00:00
a2a206b917
Mention math.degrees() and math.radians()
...
Other minor rewrites
2002-05-24 21:08:58 +00:00
0cc8c37357
Move really open-ended XXX items into comments
...
Remove 1.5.2 reference: who cares?
2002-05-24 17:06:17 +00:00
92bf9dacc9
Markup adjustments; fix the names of modules referenced in an expression.
2002-05-23 21:07:19 +00:00
c32f0336e0
Deprecated Random.cunifvariate clearing bug 506647. Also, added docstrings.
2002-05-23 19:44:49 +00:00
db2e3e3c9c
Added missing dependency on the refcount data file.
2002-05-23 19:41:25 +00:00
f547863c63
Use Perl function prototypes to help avoid definition/usage mismatches
...
while modifying these files.
Minor style changes to make the use of "my" with arrays more consistent.
2002-05-23 17:59:16 +00:00
ffb294bd34
Add refcount information for PySequence_ITEM().
2002-05-23 16:03:16 +00:00
86228e4ca2
Add version annotation for PySequence_ITEM().
2002-05-23 16:02:28 +00:00
7779b208ae
Remove spurious "()" from the __str__() description.
2002-05-22 20:44:03 +00:00
177b4a065f
Jack's documentation for the U mode character on the file()
...
constructor, vetted by Barry.
2002-05-22 20:39:43 +00:00
c58507582b
Added a version annotation for StringTypes.
...
Added documentation for BooleanType.
2002-05-22 02:44:24 +00:00
c421ad4a35
Minor typo: Message.getall() -> Message.get_all()
2002-05-22 01:22:46 +00:00
6cf09f0792
Patch 543387. Document deprecation of complex %, //,and divmod().
2002-05-21 18:19:49 +00:00
97394bc795
Patch 533291. Deprecate None return form of __reduce__.
2002-05-21 17:22:02 +00:00
f79f2f94d5
Add additional comments on the use of \deprecated.
2002-05-21 16:27:20 +00:00
5ecb7aaa6a
Add availability information for a couple of the types, and notes on writing
...
string-type tests for versions of Python built without Unicode support.
2002-05-21 14:28:22 +00:00
18ca791028
Typo.
2002-05-16 14:45:37 +00:00
4e7655558c
Fix broken reference, minor clarification.
2002-05-16 13:48:14 +00:00
Barry Warsaw
Martin v. Löwis
Andrew M. Kuchling
Fred Drake
Mark Hammond
Greg Ward
Thomas Heller
Skip Montanaro
Raymond Hettinger
Walter Dörwald
Michael W. Hudson
Tim Peters
Neal Norwitz
Guido van Rossum
Steve Holden
Jack Jansen
Jeremy Hylton
Piers Lauder