Mark Hammond
8235ea1c3a
Land Patch [ 566100 ] Rationalize DL_IMPORT and DL_EXPORT.
2002-07-19 06:55:41 +00:00
Fred Drake
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
Fred Drake
50ceb68b4f
Change staticforward and statichere to just use static.
...
Removed ^M from some line-ends.
2002-07-17 16:42:48 +00:00
Fred Drake
a3cd9bbaa3
Remove now-obsolete staticforward/statichere discussion.
2002-07-17 16:40:39 +00:00
Fred Drake
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
Guido van Rossum
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
Guido van Rossum
54ed2d32f9
Clarify that the description of sys.path[0] is only valid upon program
...
start-up.
2002-07-15 16:08:10 +00:00
Andrew M. Kuchling
346386fedc
Add more items
...
Use \cfunction instead of \function in various places
Add contributor names
2002-07-12 20:24:42 +00:00
Fred Drake
3e59f72075
Clarify the return value of __nonzero__(): It *must* be an integer.
...
Closes SF bug #579991 .
2002-07-12 17:15:10 +00:00
Andrew M. Kuchling
20e5abc86e
Make another pass through Misc/NEWS and add stuff.
...
Bump version number.
2002-07-11 20:50:34 +00:00
Andrew M. Kuchling
e995d16f71
Add some items
...
Expand the "Other Language Changes" section
Rewrite various passages.
2002-07-11 20:09:50 +00:00
Andrew M. Kuchling
7845e7c726
[Bug #567607 ] Suggest METH_NOARGS to replace PyArg_NoArgs
2002-07-11 19:27:46 +00:00
Fred Drake
e4523c46b9
Document gc.get_objects().
...
Closes SF bug #578308 .
2002-07-10 19:21:07 +00:00
Fred Drake
4254cbd29c
Note that unicode() can raise LookupError for unknown codecs.
...
Closes SF bug #513666 .
2002-07-09 05:25:46 +00:00
Fred Drake
eab5f8a43d
Remove unused variable.
2002-07-09 03:24:32 +00:00
Tim Peters
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
Fred Drake
c6a525e993
Fix typo reported by Kent Engström, and a bunch of broken markup.
2002-07-08 14:42:22 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Thomas Heller
291e9ee341
Fix a typo.
2002-07-04 08:36:53 +00:00
Steve Holden
b1af86a1d7
Revise asyncore documentation and document asynchat for the first time.
2002-07-03 18:36:39 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
c412617779
Add annotations that describe the change in the "errors" and "failures"
...
attributes of the TestResult.
2002-07-02 22:46:42 +00:00
Fred Drake
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
Greg Ward
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
Fred Drake
2c22e85ae7
Attempt to clarify removedirs().
...
Based on SF bug #574773 .
2002-07-02 21:03:49 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
abe7c1a4af
Minor markup adjustments, consistency changes, and shorten a long
...
line.
2002-07-02 16:17:58 +00:00
Fred Drake
7c1bb9c528
Add refcount info for PyErr_SetFromWindowsErr() and
...
PyErr_SetFromWindowsErrWithFilename().
2002-07-02 16:16:18 +00:00
Thomas Heller
4f2722ac9b
Docs for PyErr_SetFromWindowsErrWithFilename() and
...
PyErr_SetFromWindowsErr().
Fixes SF# 576016, with additional markup.
2002-07-02 15:47:03 +00:00
Martin v. Löwis
7d650ca83b
Implement the encoding argument for toxml and toprettyxml.
...
Document toprettyxml.
2002-06-30 15:05:00 +00:00
Raymond Hettinger
550fd5d799
Fixed bug 574978 shutil example out of sync with source code
2002-06-30 04:43:20 +00:00
Raymond Hettinger
8a9e8b6d0e
Fix bug 575221 referred to dictionary type instead of dict.
2002-06-30 04:32:38 +00:00
Fred Drake
78e057a32a
Clarify the version information for the unicode() built-in.
...
Closes SF bug #575272 .
2002-06-29 16:06:47 +00:00
Greg Ward
ae64f3adcd
Add documentation for new textwrap module.
2002-06-29 02:38:50 +00:00
Greg Ward
8b46c71d5b
Typo fix.
2002-06-29 01:23:45 +00:00
Fred Drake
d805fefff4
Added support for some of the more recently defined macros and
...
environments.
2002-06-27 18:38:06 +00:00
Fred Drake
2c813818c8
Clean up some markup.
2002-06-27 18:30:34 +00:00
Neal Norwitz
dcd0500664
dis.dis() also supports modules
2002-06-26 22:32:47 +00:00
Fred Drake
292724d989
Fix various typos reported to python-docs.
2002-06-26 21:52:26 +00:00
Fred Drake
33fd5f7e02
Fix typo reported to python-docs.
2002-06-26 21:25:15 +00:00
Andrew M. Kuchling
dcdf48a5c7
Add some acks
2002-06-26 13:28:19 +00:00
Andrew M. Kuchling
d003a2a54f
Describe textwrap module
2002-06-26 13:23:55 +00:00
Raymond Hettinger
ca0383d3a3
Fix bug #573916 . Sender and recipients reversed in email example.
2002-06-26 07:51:32 +00:00
Skip Montanaro
763805dab2
add seealso link to the bisect module
2002-06-26 05:22:08 +00:00
Skip Montanaro
09d9f86c77
add /F's PriorityQueue example
2002-06-26 05:07:28 +00:00
Andrew M. Kuchling
fdc34315f7
Add a reminder
2002-06-26 00:03:05 +00:00
Andrew M. Kuchling
09d6b928e7
Add a reminder
2002-06-25 23:57:17 +00:00
Fred Drake
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
Fred Drake
b6aa9cbb96
Added some more links to the "See also" section.
2002-06-25 16:58:58 +00:00
Fred Drake
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
Raymond Hettinger
f0236d7374
Fix typo
2002-06-25 15:26:59 +00:00
Raymond Hettinger
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
Raymond Hettinger
04e7e0c60f
Close bug 417930 by clarifying augmented assignment docs
2002-06-25 13:36:41 +00:00
Raymond Hettinger
5ed3fa6578
Fix SF bug 568269 by enclosing 'computername' in a raw string
2002-06-25 04:53:05 +00:00
Raymond Hettinger
7fd9ced4ca
Minor English grammar correction
2002-06-25 04:04:14 +00:00
Raymond Hettinger
7951f60f45
Fix spacing in loop example
2002-06-25 03:17:03 +00:00
Neal Norwitz
563d12d145
SF # 572928 One word change for lib/libgettext.tex
...
Fix typo.
2002-06-24 02:22:39 +00:00
Fred Drake
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
Fred Drake
53540ab071
Correct the RE equivalent of scanf()'s %x and %X patterns.
...
Closes SF bug #572169 .
2002-06-22 01:07:37 +00:00
Greg Ward
6f45eeb0f3
Typo fix.
2002-06-21 12:33:08 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
807354f3b6
Add a note that divmod() with complex numbers is deprecated.
2002-06-20 21:10:25 +00:00
Fred Drake
dce695aa4e
Added reference to the Expat home page.
2002-06-20 21:06:03 +00:00
Fred Drake
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
Fred Drake
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
Raymond Hettinger
10cbe8dcbc
SF 563530 added missing methods for emulating numeric types
2002-06-20 06:12:37 +00:00
Fred Drake
f4bf7aa292
Typo: bites --> bytes
...
(Hanging around small kids too much...;)
2002-06-18 20:38:05 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
7f59124693
Clarified documentation for os.access().
...
Patch contributed by Sean Reifschneider.
Closes SF patch #570618 .
2002-06-18 16:15:51 +00:00
Fred Drake
28bdc624a8
Clarified description of error handling for shutil.rmtree().
...
This closes SF patch #569832 .
2002-06-18 14:31:04 +00:00
Fred Drake
b084017c7a
Fix documentation for PyMarshal_WriteObjectToFile() and
...
PyMarshal_WriteObjectToFile().
This closes SF bug #533735 .
2002-06-17 15:44:18 +00:00
Fred Drake
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
Andrew M. Kuchling
9f6e104c80
Add reminder, and a new POSIX function
...
Tweak traceback display for consistency
2002-06-17 13:40:04 +00:00
Michael W. Hudson
495afea36e
Typo.
2002-06-17 12:51:57 +00:00
Piers Lauder
3fca291a52
Add IMAP4 QUOTA extension methods
2002-06-17 07:07:20 +00:00
Fred Drake
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
Fred Drake
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
Steve Holden
1e4519faaa
Make a start at describing the results of class/type unification
...
in the type documentation.
2002-06-14 09:16:40 +00:00
Fred Drake
6c123efe3d
Refer the reader to the correct module for constant definitions.
...
This closes SF bug #550777 .
2002-06-14 01:58:19 +00:00
Neal Norwitz
1f68fc7fa5
SF bug # 493951 string.{starts,ends}with vs slices
...
Handle negative indices similar to slices.
2002-06-14 00:50:42 +00:00
Fred Drake
585775bf11
Document the Binary.data attribute.
...
This closes SF bug #562878 .
2002-06-14 00:33:02 +00:00
Neal Norwitz
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
Neal Norwitz
cc5c6947a6
Add "version added" for getpgid
2002-06-13 21:19:25 +00:00
Martin v. Löwis
606edc1d97
Patch #568235 : Add posix.setpgid.
2002-06-13 21:09:11 +00:00
Guido van Rossum
fea59e7f76
The opcode FOR_LOOP no longer exists.
2002-06-13 17:59:51 +00:00
Fred Drake
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
Guido van Rossum
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
Fred Drake
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
Fred Drake
e9996c6093
Add version annotations for some older changes to the calendar module.
...
Closes SF patch #567867 .
2002-06-13 01:34:50 +00:00
Guido van Rossum
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
Michael W. Hudson
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
Fred Drake
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
Guido van Rossum
a861d552c3
Document that the key should not contain null bytes.
2002-06-10 19:42:43 +00:00
Guido van Rossum
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
Andrew M. Kuchling
7f147a772d
Tweak traceback message to avoid LaTeX2HTML bug
...
Add a reminder
2002-06-10 18:58:19 +00:00
Andrew M. Kuchling
eb914881af
Fix typo
2002-06-10 15:53:05 +00:00
Andrew M. Kuchling
f70a0a8471
Fix typo, and add some reminders
2002-06-10 13:22:46 +00:00
Michael W. Hudson
497bdd69f2
Tweak the description of pymalloc. Mention pymemcompat.h.
2002-06-10 13:19:42 +00:00
Guido van Rossum
715b861d94
Clarify the interaction between timeout/non-blocking mode, makefile
...
and fromfd.
2002-06-07 12:38:23 +00:00
Neal Norwitz
62a7f63a24
Fix typo
2002-06-07 12:36:44 +00:00
Guido van Rossum
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
Neal Norwitz
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
Fred Drake
1a06fb0605
Fix typo spotted by Fredrik Lundh.
2002-06-06 22:19:20 +00:00
Fred Drake
6c6d662760
Fix some markup errors and adjust wording slightly.
2002-06-06 21:57:48 +00:00
Guido van Rossum
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
Martin v. Löwis
446a25fa3c
Patch 473512: add GNU style scanning as gnu_getopt.
2002-06-06 10:58:36 +00:00
Fred Drake
293dd4b77b
Fix up Guido's markup.
2002-06-04 16:25:57 +00:00
Walter Dörwald
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
Guido van Rossum
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
Guido van Rossum
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
Guido van Rossum
9788384d02
Explain that tp_basicsize must provide alignment for the items.
2002-05-31 21:00:18 +00:00
Fred Drake
9b414ac93e
Update links and information on PyQt/PyKDE.
2002-05-31 18:21:56 +00:00
Andrew M. Kuchling
187b1d8260
Add OS/2 text
2002-05-29 19:20:57 +00:00
Andrew M. Kuchling
d7abe2a0fb
Various minor rewrites
2002-05-29 17:33:48 +00:00
Andrew M. Kuchling
72b58e0c5f
More additions
2002-05-29 17:30:34 +00:00
Neal Norwitz
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
Andrew M. Kuchling
2b6edce773
Rearrange paragraph
2002-05-27 17:19:46 +00:00
Michael W. Hudson
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
Fred Drake
38d53451b7
Define the "all" target more reasonably, but retain "html" as the default
...
target.
2002-05-25 20:28:46 +00:00
Andrew M. Kuchling
a2a206b917
Mention math.degrees() and math.radians()
...
Other minor rewrites
2002-05-24 21:08:58 +00:00
Andrew M. Kuchling
0cc8c37357
Move really open-ended XXX items into comments
...
Remove 1.5.2 reference: who cares?
2002-05-24 17:06:17 +00:00
Fred Drake
92bf9dacc9
Markup adjustments; fix the names of modules referenced in an expression.
2002-05-23 21:07:19 +00:00
Raymond Hettinger
c32f0336e0
Deprecated Random.cunifvariate clearing bug 506647. Also, added docstrings.
2002-05-23 19:44:49 +00:00
Fred Drake
db2e3e3c9c
Added missing dependency on the refcount data file.
2002-05-23 19:41:25 +00:00
Fred Drake
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
Fred Drake
ffb294bd34
Add refcount information for PySequence_ITEM().
2002-05-23 16:03:16 +00:00
Fred Drake
86228e4ca2
Add version annotation for PySequence_ITEM().
2002-05-23 16:02:28 +00:00
Fred Drake
7779b208ae
Remove spurious "()" from the __str__() description.
2002-05-22 20:44:03 +00:00
Barry Warsaw
177b4a065f
Jack's documentation for the U mode character on the file()
...
constructor, vetted by Barry.
2002-05-22 20:39:43 +00:00
Fred Drake
c58507582b
Added a version annotation for StringTypes.
...
Added documentation for BooleanType.
2002-05-22 02:44:24 +00:00
Barry Warsaw
c421ad4a35
Minor typo: Message.getall() -> Message.get_all()
2002-05-22 01:22:46 +00:00
Raymond Hettinger
6cf09f0792
Patch 543387. Document deprecation of complex %, //,and divmod().
2002-05-21 18:19:49 +00:00
Raymond Hettinger
97394bc795
Patch 533291. Deprecate None return form of __reduce__.
2002-05-21 17:22:02 +00:00
Fred Drake
f79f2f94d5
Add additional comments on the use of \deprecated.
2002-05-21 16:27:20 +00:00
Fred Drake
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
Guido van Rossum
18ca791028
Typo.
2002-05-16 14:45:37 +00:00
Fred Drake
4e7655558c
Fix broken reference, minor clarification.
2002-05-16 13:48:14 +00:00
Fred Drake
742dc774af
Typo: build -> built
2002-05-16 13:48:01 +00:00
Raymond Hettinger
cadc9fbd37
Patch 547037. Corrected documentation to match
...
actual module behavior for adding newlines.
2002-05-16 04:28:44 +00:00
Raymond Hettinger
b07fa39edf
Added missing index entries for mapping methods. Closes patch #548693 .
2002-05-15 15:45:25 +00:00
Fred Drake
9aa97e835d
Minor wording changes, plus correct a typo.
2002-05-14 22:02:07 +00:00
Raymond Hettinger
576474c5ae
Closes SF bug 527139. Brings docs inline with random.py 1.29
...
which fixes the unnecessarily restricted method domain.
2002-05-13 23:49:13 +00:00
Raymond Hettinger
5359ad63ce
Correct gammavariate's method name and domain.
...
Partial solution to SF bug 527139.
2002-05-13 22:40:38 +00:00
Raymond Hettinger
c045b49633
Added degrees() and radians() to mathmodule. Closing patch 552452 and
...
feature request 426539.
2002-05-13 03:52:47 +00:00
Raymond Hettinger
94153096f5
Closes SF patch: 552468.
...
Type class unification invalidated the statement: x.__getitem__[i] is not equivalent to x[i].
2002-05-12 03:09:25 +00:00
Andrew M. Kuchling
fad2f59313
Give the enumerate() PEP a section of its own
...
Add some credits
Fill in a link
2002-05-10 21:00:05 +00:00
Greg Ward
007c04a9d3
[from Oct 2000]
...
Start fleshing out the "Examples" section.
2002-05-10 14:45:59 +00:00
Greg Ward
954ce8b4a1
[from Oct 2000]
...
The zipfile module has been in the standard library for some time now.
2002-05-10 14:42:10 +00:00
Greg Ward
58437f20f0
[from Oct 2000]
...
Clarify explanations of header file search directories.
2002-05-10 14:40:22 +00:00
Fred Drake
1f89e2abcc
Fix markup error that suppressed space.
...
Closes SF bug #554257 . Not relevant to older releases.
2002-05-10 12:37:56 +00:00
Andrew M. Kuchling
40df710876
Updates and rewriting
2002-05-08 13:39:03 +00:00
Martin v. Löwis
01f94bda38
Patch #552433 : Special-case tuples. Avoid sub-type checking for lists.
...
Avoid checks for negative indices and duplicate checks for support of
the sequence protocol.
2002-05-08 08:44:21 +00:00
Andrew M. Kuchling
1624bc051f
Move 'Tips and Tricks' to be the last section
2002-05-07 21:03:45 +00:00
Andrew M. Kuchling
3b98dc16e9
Add section on Setup file
...
Updates for 2.2
Remove references to Makefile.pre.in build method
2002-05-07 21:02:35 +00:00
Andrew M. Kuchling
517109b11e
More filling out
2002-05-07 21:01:16 +00:00
Andrew M. Kuchling
821013ef2c
Write two sections, and write some partial text for some other sections
2002-05-06 17:46:39 +00:00
Fred Drake
d05c74f42d
Add a note explaining the interaction between unbuffered input and
...
xreadlines.xreadlines().
This closes SF patch #552804 .
2002-05-06 16:02:42 +00:00
Fred Drake
bfc18bdf03
Integrated SF patch #539487 by Matthias Klose:
...
This patch adds Milan Zamazal's conversion script and
modifies the mkinfo script to build the info doc files
from the LaTeX sources. Currently, the mac, doc and
inst TeX files are not handled.
Explicitly checks for GNU Emacs 21.
2002-05-03 04:50:51 +00:00
Tim Peters
a3b0b298e6
Boost the list of stop words, by merging in the little list Jeremy
...
just checked into Zope's ZCTextIndex branch. This reduces the size
of the .chm file by about 100KB.
2002-05-02 21:59:08 +00:00
Fred Drake
b9032018ff
Update the xrange object description to reflect the removal of deprecated
...
features.
2002-05-02 21:37:23 +00:00
Fred Drake
7d28b73ec1
Added note about using the documentation build tools under Cygwin.
2002-05-02 21:17:00 +00:00
Fred Drake
77c18951fb
Remove the warning about the Cygwin directions not working -- the latest
...
change to Doc/tools/node2label.pl (revision 1.13) makes this work.
2002-05-02 21:10:48 +00:00
Fred Drake
fe3db7d6f0
Work around limitation of Cygwin Perl: To avoid a permission denial, we need
...
to do the inplace-edit with a backup file. A quick test leads me to
believe this is sufficient to allow building the documentation on Cygwin;
a full test is in progress.
2002-05-02 20:42:30 +00:00
Fred Drake
a030c768af
Many minor markup adjustments for consistency.
2002-05-02 17:55:26 +00:00
Fred Drake
4d707a5d08
Remove extra period produced by previous change.
2002-05-02 17:54:18 +00:00
Andrew M. Kuchling
9546772ccd
Correct Moshe's e-mail address
...
Point to PEP 100 for MAL's Unicode proposal
Fix URL for XML HOWTO
Bump version number
2002-05-02 14:48:26 +00:00
Andrew M. Kuchling
2a1598035d
Note that NameError's message also changed in 2.0
2002-05-02 14:37:14 +00:00
Andrew M. Kuchling
e7bd876f9d
Message for NameError has changed
2002-05-02 14:31:55 +00:00
Fred Drake
4b270518b7
Correct information on support for repietition & concatenation for buffer
...
and xrange objects.
This closes SF bug #550555 .
2002-05-02 05:56:04 +00:00
Fred Drake
eb2b8334d5
Added some notes on setting up the documentation tools on Cygwin.
2002-05-01 22:05:30 +00:00
Fred Drake
5a55c49c8c
Added more style for major warnings.
2002-05-01 22:03:40 +00:00
Fred Drake
7f781c9aab
Add Pickler.clear_memo() so the pickle and cPickle modules are more similar.
2002-05-01 20:33:53 +00:00
Fred Drake
56aa6280f6
list_documented_items(): Basic implementation.
...
This still does not work well since ctags does not do a good job with the
Python headers, appearantly due to the DL_IMPORT macro. ;-(
2002-05-01 17:25:04 +00:00
Fred Drake
a65375c3e3
Explain what os.read() returns at end of file.
...
This closes SF bug #550409 . Applying to release21-maint & release22-maint.
2002-05-01 03:31:42 +00:00
Fred Drake
7938fab285
Add missing right-parenthesis.
2002-05-01 03:23:03 +00:00
Skip Montanaro
d268183044
moved from Tools/scripts (was only at rev 1.1 - no changes yet - so I simply
...
removed it from there and added it here)
2002-04-30 16:25:37 +00:00
Fred Drake
52cc670711
Add a note about when the "%r" formatting code was added.
2002-04-30 14:54:47 +00:00
Fred Drake
af93c4c8d9
Added a missing "|" in the grammar productions used in the reference manual
...
(reported by François Pinard).
Added some missing "_" characters in the same cluster of productions.
Added missing floor division operator in m_expr production, and mention
floor division in the relevant portion of the text.
2002-04-30 02:18:51 +00:00
Thomas Heller
541703b18f
Typo: whcar_t should be wchar_t.
...
Bugfix candidate? Don't know how this is handled in the docs.
2002-04-29 17:28:43 +00:00
Andrew M. Kuchling
b803f7013c
Add some items, and remove a note to myself
2002-04-29 15:42:16 +00:00
Fred Drake
432425e834
Small markup adjustments for consistency.
2002-04-29 15:17:16 +00:00
Tim Peters
81b9251d59
Mostly in SequenceMatcher.{__chain_b, find_longest_match}:
...
This now does a dynamic analysis of which elements are so frequently
repeated as to constitute noise. The primary benefit is an enormous
speedup in find_longest_match, as the innermost loop can have factors
of 100s less potential matches to worry about, in cases where the
sequences have many duplicate elements. In effect, this zooms in on
sequences of non-ubiquitous elements now.
While I like what I've seen of the effects so far, I still consider
this experimental. Please give it a try!
2002-04-29 01:37:32 +00:00
Tim Peters
5de9842b34
Repair widespread misuse of _PyString_Resize. Since it's clear people
...
don't understand how this function works, also beefed up the docs. The
most common usage error is of this form (often spread out across gotos):
if (_PyString_Resize(&s, n) < 0) {
Py_DECREF(s);
s = NULL;
goto outtahere;
}
The error is that if _PyString_Resize runs out of memory, it automatically
decrefs the input string object s (which also deallocates it, since its
refcount must be 1 upon entry), and sets s to NULL. So if the "if"
branch ever triggers, it's an error to call Py_DECREF(s): s is already
NULL! A correct way to write the above is the simpler (and intended)
if (_PyString_Resize(&s, n) < 0)
goto outtahere;
Bugfix candidate.
2002-04-27 18:44:32 +00:00
Fred Drake
d3e6678713
Slightly expand and clarify the differences between getegid(), getgid(),
...
getpgrp(), and setpgid().
This closes SF bug #547939 .
2002-04-26 20:59:40 +00:00
Fred Drake
a7bb2b9b30
Be more consistent, both internally and with recommended practice.
...
This closes SF bug #547953 .
2002-04-26 20:44:14 +00:00
Fred Drake
38f71973e5
Documentation for the enumerate() function/type.
...
This closes SF patch #547162 .
2002-04-26 20:29:44 +00:00
Thomas Heller
8da4b59221
Fix a small mistake and complete some function prototypes.
...
SF Patch #547813 .
2002-04-24 06:35:11 +00:00
Fred Drake
99d17006c1
Add text about circular references caused by storing frames in local
...
variables. This closes SF bug #543148 .
2002-04-23 21:21:20 +00:00
Fred Drake
ed9e453eb7
Minor change to an index entry.
2002-04-23 20:04:46 +00:00
Fred Drake
b957bc3dcc
Clarify the return value of PyObject_IsInstance().
2002-04-23 18:15:44 +00:00
Fred Drake
106c1a0e7a
WCOREDUMP(), WIFCONTINUED(), WCONTINUED, WUNTRACED: New.
...
isatty(), WIFEXITED(), WIFSIGNALED(), WIFSTOPPED(): Changed to return
bools instead of ints.
2002-04-23 15:58:02 +00:00
Anthony Baxter
8388895fe4
SF patch [ 545523 ] patch for 514433 bsddb.dbopen (NULL)
...
closes SF #514433
can now pass 'None' as the filename for the bsddb.*open functions,
and you'll get an in-memory temporary store.
docs are ripped out of the bsddb dbopen man page. Fred may want to
clean them up.
Considering this for 2.2, but not 2.1.
2002-04-23 02:11:05 +00:00
Walter Dörwald
de02bcb265
Apply patch diff.txt from SF feature request
...
http://www.python.org/sf/444708
This adds the optional argument for str.strip
to unicode.strip too and makes it possible
to call str.strip with a unicode argument
and unicode.strip with a str argument.
2002-04-22 17:42:37 +00:00
Tim Peters
4a0db06edf
Hack around the "2.1.6 Blank lines" bug in a way that the TOC still
...
displays a recognizable section title (there are extra blanks at the
end of it now, due to the nested anchor, but that's fine).
2002-04-21 04:44:11 +00:00
Tim Peters
dc374e034a
Give the Help viewer a font-size button. This isn't documented by MS,
...
but is documented by others on the web, and the defn of the magic flag
needed appears in MS's htmlhelp.h header file.
2002-04-21 02:01:01 +00:00
Tim Peters
c8490c70cd
Move "everything left one": the TOC now shows each doc directory as a
...
distinct top-level node. Before they were all nested under an artificial
top-level node, uselessly chewing up horizontal space, and ensuring that
the only thing the user saw in the TOC upon opening the file was a single
collapsed top-level folder.
2002-04-20 21:34:34 +00:00
Tim Peters
4545407746
Stopped all warnings from the HTML Help Compiler, by generating proper
...
HTML (or, at least, proper in its view). The TOC file is now identical
to what the HTML compiler itself generates, except for whitespace and
a glitch identified below. The pretty-printing done by prechm.py is
pretty much destroyed for now; if you need it pretty-printed, just make
the Help Compiler save the files (it's got its own idea of pretty-
printing anyway).
Glitch: The title of Ref Man "2.1.6 Blank lines" shows up as a blank
for now. This is because the relevant entry in ref/index.html contains
nested anchors, and pychm really has no idea what to do with that. I
hacked it for now to avoid any error messages or worse insanity, and
filed a bug report against the docs.
2002-04-20 20:26:26 +00:00
Tim Peters
e21095e3c5
Widespread: Used classes in a more natural way. Added convenience
...
methods to squash code duplication. Simplified several overly complex
chunks of logic. Built output strings more with string interpolation
instead of infix '+'. Added comments. Exploited recent Python features
(chiefly bool and augmented assignment).
2002-04-20 08:36:42 +00:00
Tim Peters
d9a10509ac
Replaced the fiddly 5-tuples with a new Book convenience class, allowing
...
to reference fields via names instead of meaningless little integers.
This turned up one case where the wrong little integer was being used,
in informative progress output. Fixed that too.
2002-04-20 03:25:02 +00:00
Tim Peters
8d62ad7ffd
Fixed a comment.
2002-04-20 02:56:20 +00:00
Tim Peters
661e49231a
All over: get rid of blanks before colons that open code blocks.
2002-04-20 02:39:44 +00:00
Tim Peters
460643b8c5
do_project(): Modernized the code.
2002-04-20 02:37:07 +00:00
Tim Peters
5d5e1930dd
Added "What's New" to the 2.2 doc set.
2002-04-20 02:07:58 +00:00
Tim Peters
4f109c1cf9
Added a stop-list to reduce the size of the full text search index. Fred,
...
populate the "stop_list" triple-quoted string with your favorite handful
of stop words.
2002-04-19 18:41:46 +00:00
Tim Peters
e6b63e685b
project_template: use dict interpolation instead of giant tuples.
2002-04-19 18:07:52 +00:00
Tim Peters
a905363ce5
+ Changed TOC to folder-tree style.
...
+ Increased size of the window the user sees the first time.
+ Arranged for the display to remember its last size and position.
+ Added a Favorites (bookmarks) tab.
+ Added the "Advanced Search" decorations.
2002-04-19 16:46:43 +00:00
Tim Peters
52cfa33e6e
Generates inputs to the Microsoft Help Compiler, which creates compiled
...
HTML help files (.chm). Obtained from Robin Dunn's packaging of the
2.2 docs at <http://alldunn.com/python/ >, obtained in turn from
Hernán Martínez Foffani's original work at
<http://www.orgmf.com.ar/condor/pytstuff.html >.
2002-04-19 16:09:26 +00:00
Tim Peters
7d4ed0db95
Get the right funny characters in Hernan's name.
2002-04-19 15:59:01 +00:00
Skip Montanaro
75700db7f0
\idxcode -> \py@idxcode (mimics index stuff in python.sty - problem only
...
revealed itself when i added index generating lines to doc/doc.tex)
2002-04-19 04:52:44 +00:00
Skip Montanaro
176bda4cde
fix duplicate label
...
add index turds
2002-04-19 04:50:44 +00:00
Fred Drake
c55ae4b98c
Clean up the use of version numbers in filenames; always use an "abstract"
...
version number, and explain what it is at the top of the chapter.
This closes SF bug #225003 .
2002-04-19 04:04:57 +00:00
Andrew M. Kuchling
91bae441f6
Long-forgotten change: Update first paragraph with actual release date
2002-04-18 02:18:27 +00:00
Skip Montanaro
b02ea65f92
typo
2002-04-17 19:33:06 +00:00
Fred Drake
8d95ca4469
Add text on tp_as_buffer that refers tothe section that covers the topic.
...
Additional material is still needed in that section.
2002-04-17 13:44:58 +00:00
Fred Drake
933f159a2f
Add a version annotation for the help() function.
2002-04-17 12:54:04 +00:00
Fred Drake
70b3831697
Adjust markup to worm around tool limitations; the "m" in "model" was being
...
dropped in the HTML formatted version.
Reported by Mike Coleman.
2002-04-17 03:41:50 +00:00
Fred Drake
3d0b697d70
Pass the -r option to getpagecounts to generate an entry for the "What's
...
New" document.
2002-04-17 03:31:08 +00:00
Fred Drake
bab5aa0039
Remove Emacs turd; not needed with modern Emacs versions.
...
Add a -r option; if given with a release number, the "What's New" document
is included with the relevant version number.
Update the text of the README distributed with the PostScript files to
reflect the changes in the user organizations in the Python community.
2002-04-17 03:29:40 +00:00
Fred Drake
1f6794622b
Changed last remaining use of "./" to "index.html" when referring to the
...
index file for the top-level directory. This makes it easier to use an
unpacked version of the documentation via file: URLs.
This closes SF bug #541257 .
2002-04-17 01:40:56 +00:00
Fred Drake
34a05f7a1f
Start of script to locate C symbols and segregate them into lists of
...
the documented and undocumented symbols.
2002-04-16 21:27:17 +00:00
Fred Drake
0fdc826f54
Update the dependencies.
2002-04-16 18:48:25 +00:00
Fred Drake
121460d8cb
Minor wording change.
2002-04-16 18:32:37 +00:00
Fred Drake
9ad70f9cb0
Add more text from Guido on the type structure fields.
...
Small additional changes.
2002-04-16 16:22:24 +00:00
Skip Montanaro
6c7bc31089
added small clarification to the descriptions of encode() and decode()
2002-04-16 15:12:10 +00:00
Thomas Heller
0e661dcdbf
Replace the simpleminded string.find with a re.search looking only for
...
full words. Before that, something like 'PyObject_Call' was missed
because 'PyObject_CallFunction' was found.
Passes PyChecker now.
2002-04-16 15:04:56 +00:00
Fred Drake
c0a02c084b
Remove repeated index entry; adds nothing different.
...
Closes SF bug #518985 .
2002-04-16 02:03:05 +00:00
Fred Drake
0e0b6180ba
Add documentation for PyObject_Call().
...
Note that PyObject_Size() is a synonym for PyObject_Length().
This closes SF patch #544330 (contributed by Thomas Heller).
2002-04-15 20:51:19 +00:00
Fred Drake
34adb8a8ec
Separate out a \cfuncline macro from the cfuncdesc environment.
...
This matches many other of the *desc environments, and is useful when
multiple functions share a description.
2002-04-15 20:48:40 +00:00
Fred Drake
1251b0eb24
Document the cmemberdesc environment.
2002-04-15 20:10:23 +00:00
Fred Drake
8a5a270000
Better documentation for GetArgv() and the ProgressBar type.
...
Back-porting to release22-maint.
This closes SF patch #496705 .
2002-04-15 19:53:35 +00:00
Fred Drake
e19a5bcc7b
Be consistent in presenting the signatures.
2002-04-15 19:46:40 +00:00
Fred Drake
154985587b
Add docs for os.fchdir().
2002-04-15 19:41:27 +00:00
Fred Drake
0157276cf8
Generate the right annotations in the index entries.
...
Thanks to Thomas Heller for the sharp eye.
2002-04-15 19:35:29 +00:00
Fred Drake
188ecd141a
Integrated more text from Guido.
2002-04-15 18:44:46 +00:00
Fred Drake
c63042bcc4
Move the listing of the type structure, since both the C API reference and
...
the Extending & Embedding manual use it.
2002-04-15 18:43:20 +00:00
Fred Drake
8a5e6790d9
Clean up the application of style to verbatim text.
...
This moves styling to the stylesheet; the use of <dl> structures to control
style sometimes produced improper indentation of subsequent text in many
browsers when the text was already part of the <dl> structure (as in a
function or class description).
2002-04-15 18:41:31 +00:00
Fred Drake
eeb5ec42e0
Add support for \cmemberline and the cmemberdesc environment.
2002-04-15 17:46:00 +00:00
Andrew M. Kuchling
8e8af6e722
Add item
2002-04-15 14:05:59 +00:00
Walter Dörwald
068325ef92
Apply the second version of SF patch http://www.python.org/sf/536241
...
Add a method zfill to str, unicode and UserString and change
Lib/string.py accordingly.
This activates the zfill version in unicodeobject.c that was
commented out and implements the same in stringobject.c. It also
adds the test for unicode support in Lib/string.py back in and
uses repr() instead() of str() (as it was before Lib/string.py 1.62)
2002-04-15 13:36:47 +00:00
Neal Norwitz
b384c72639
posix.mknod() and {}.pop() were added
2002-04-15 12:46:11 +00:00