59a27f1d6e
Various minor edits
2004-08-07 19:10:36 +00:00
4cbe95cdd1
[Bug #866222 ] Update docs to match the module
2004-08-07 19:06:48 +00:00
fe80b63663
[Bug #991883 ] Document calling condition
2004-08-07 17:53:05 +00:00
1baa248021
Fix
...
[ 1000841 ] "make pdf" failure w/ 2.4 docs
in the suggested way, by uglifying a URL.
2004-08-07 17:39:35 +00:00
0188cdb115
[Bug #998066 ] Mention result mismatch
2004-08-07 17:28:17 +00:00
b6d9fc38e8
Patch:
...
[ 1003863 ] adds an index entry for __all__ to the tutorial
2004-08-07 17:05:42 +00:00
8def876d36
[Bug #873146 ] Document pickletools module (haven't tested the LaTeX yet)
2004-08-07 16:53:59 +00:00
049e7aaa0f
Point out that the setdefault defaults the value to None. Inspired by
...
Michael Chermside's thinking about patch #748126 (the chief upshot of
which thinking was "reject it!").
2004-08-07 16:41:34 +00:00
cbbee6fed5
[Bug #984952 ] Include more material from PEP 307.
...
I haven't tried to include all the material on old-style classes using protocols 0,1. The details are lengthy; someone who knows
more about the pickle module should decide if they're important enough
to be in the docs or not.
2004-08-07 16:24:18 +00:00
14d535c3d4
[Bug #984952 ] Include some material from PEP 307
2004-08-07 15:49:24 +00:00
6f937b1c30
[Bug #998307 ] Use open() instead of file() in docs
2004-08-07 15:11:24 +00:00
9bae19e8b1
fix two typos in markup
2004-08-07 14:28:37 +00:00
e30c4d4ddc
Add recent items
2004-08-07 13:58:02 +00:00
38dc2a6bf7
Simplify language
2004-08-07 13:24:12 +00:00
ac6428756a
Add string concat item
2004-08-07 13:13:31 +00:00
ba59be04fa
Bump version
2004-08-06 18:55:48 +00:00
34ed2b020a
Typo fix; use 'in-place' instead of 'inplace'
2004-08-06 18:55:09 +00:00
52a21b8e65
SF patch #980695 : efficient string concatenation
...
(Original patch by Armin Rigo).
2004-08-06 18:43:09 +00:00
3f5c654deb
fix markup nit, typo
2004-08-06 03:34:20 +00:00
6bd8e842e4
update to reflect the new significance of the "@" character
2004-08-05 21:11:27 +00:00
1884dda233
Warn that settrace() is implementation rather than language
...
definition, per Guido's request in off-list email.
2004-08-05 12:13:46 +00:00
4c8fa42aca
Doc/lib/libfuncs.tex: correct items in itemize
...
Doc/dist/dist.tex: avoid uncommenting the verbose environment (by the py2texi tool)
2004-08-04 23:18:49 +00:00
1cf56d0b8a
Updated Logger.log() documentation to clarify that lvl parameter should be an integer.
2004-08-04 08:36:44 +00:00
e9ddfbb412
SF #989185 : Drop unicode.iswide() and unicode.width() and add
...
unicodedata.east_asian_width(). You can still implement your own
simple width() function using it like this:
def width(u):
w = 0
for c in unicodedata.normalize('NFC', u):
cwidth = unicodedata.east_asian_width(c)
if cwidth in ('W', 'F'): w += 2
else: w += 1
return w
2004-08-04 07:38:35 +00:00
f901abdd62
allow ctime(), gmtime(), and localtime() to take None as equivalent to an omitted arg
...
(closes SF bug #658254 , patch #663482 )
2004-08-03 17:58:55 +00:00
d04573fef0
This allows additional commands to be provided for existing setup.py
...
scripts without modifying either the distutils installation or the
setup.py scripts of packages with which the new commands will be used.
Specifically, an option is added to distutils that allows additional
packages to be searched for command implementations in addition to
distutils.command. The additional packages can be specified on the
command line or via the installation or personal configuration files
already loaded by distutils.
For discussion, see the thread starting with:
http://mail.python.org/pipermail/distutils-sig/2004-August/004112.html
This closes SF patch #102241 .
2004-08-03 16:37:40 +00:00
2be406bd9f
let's avoid the extra nesting where reasonable
2004-08-03 16:02:35 +00:00
9513e34ac4
Patch #823072 : add option to NOT use ~/.netrc in nntplib.NNTP().
2004-08-03 14:36:32 +00:00
70fcdb8be0
Document general mappings for the locals argument for exec and execfile().
2004-08-03 05:17:58 +00:00
bec69f6a2e
fix a little lie ;-(
2004-08-02 23:05:25 +00:00
7fdd92f31f
Fix typo though
2004-08-02 21:56:33 +00:00
e72bd4d621
fix markup error
2004-08-02 21:50:26 +00:00
0c84c7f915
start filling in documentation on extending distutils
2004-08-02 21:39:11 +00:00
77a602fbf2
Add PEP318
2004-08-02 13:48:18 +00:00
d91fcbe265
Add import change; add empty section for function decorators
2004-08-02 12:44:28 +00:00
1455f795e2
Update item
2004-08-02 12:09:58 +00:00
829d6c4138
Fix doubled word.
2004-08-02 08:36:07 +00:00
c2a5a63654
PEP-0318, @decorator-style. In Guido's words:
...
"@ seems the syntax that everybody can hate equally"
Implementation by Mark Russell, from SF #979728 .
2004-08-02 06:10:11 +00:00
fd7dc5169c
Typo repair.
2004-08-02 04:30:37 +00:00
0c6199e8ed
Completed a sentence I left dangling.
2004-08-02 04:14:10 +00:00
cfd575d398
PyImport_ImportModule, PyImport_ImportModuleEx, PyImport_ExecCodeModule:
...
in failure cases, incompletely initalized module objects are no longer
left behind in sys.modules.
2004-08-02 03:46:45 +00:00
750f060ad7
SF bug #1001088 , incorrect reference to macro named foo
...
Backport candidate.
2004-08-01 22:36:40 +00:00
63a5d0b1cf
re-wrap paragraphs containing long lines
2004-07-30 19:12:38 +00:00
69013d070e
- document the termination condition for cmd.Cmd.cmdloop()
...
- document the use of the return value for cmd.Cmd.do_*() methods
2004-07-30 18:58:54 +00:00
479b7a7cdb
Fix typo.
2004-07-30 16:09:19 +00:00
8ddb638e43
Add closing methoddesc. Add versionadded. Rewrap.
2004-07-30 16:08:49 +00:00
f9fd0d7988
SF bug #997533 : "disjunct" should be "disjoint"
...
* Use plain wording in docs for id().
* Use normal quotation marks instead of single quotes in the description.
2004-07-29 06:06:34 +00:00
f9f0b21653
SF #998170 , fix typo. Backport candidate
2004-07-29 03:48:59 +00:00
6d3db7000e
Add missing doc for Py_True/Py_False. Use the correct macro to define
...
Py_RETURN_FALSE and Py_RETURN_TRUE.
2004-07-29 02:16:04 +00:00
671c506737
Add new encodings
2004-07-28 15:29:39 +00:00
33ee76ae9e
A little boolean music if you please, maestro... (Not sure I have the
...
versionadded{} args quite right).
2004-07-28 14:17:04 +00:00
bee417439e
Add versionadded info
2004-07-28 02:34:12 +00:00
ce4bae6170
Add an item
2004-07-27 12:13:25 +00:00
7b9190b8fc
Patch #998149 : imaplib deleteacl and myrights.
2004-07-27 05:07:19 +00:00
5785a1391e
Add some items
2004-07-26 19:28:46 +00:00
e03664ff22
Two typo fixes
2004-07-26 19:25:54 +00:00
e3e1ecacd5
[Bug #997166 ] Fix example
2004-07-26 18:52:48 +00:00
fdccf1ad6e
fix information about what flag database files are opened with by default
2004-07-26 16:33:29 +00:00
cc0f93233a
Patch #605370 : Add description[s] for RFC 2980 compliance.
2004-07-26 12:40:50 +00:00
37ead8f1c3
Patch #997668 : Correct explanation of salts.
...
Will backport to 2.3.
2004-07-26 12:05:16 +00:00
abba5c067d
Explain that most floats are actually integers. This is a common confusion
...
for people using floor(), ceil() and modf().
2004-07-26 05:12:01 +00:00
9a729a1cc5
Typo in new docs.
2004-07-26 04:58:50 +00:00
d6ef19309d
SF bugs 996748: os.environ documentation should indicate unreliability
...
Clarifed that os.environ is captured once; emphasized that it's better
to assign to os.environ than to call putenv() directly (the putenv()
docs said so, but the environ docs didn't).
2004-07-26 00:42:41 +00:00
66bb6e661c
SF bug 996392: math and cmath docs don't specify radians
...
Major rewrite of the math module docs. Slapped in "radians" where
appropriate; grouped the functions into reasonable categories; supplied
many more words to address common confusions about some of the subtler
issues.
2004-07-24 23:00:24 +00:00
fe0808382b
Fix an uncorrect function prototype.
...
Will backport to release23-maint.
BTW: Shouldn't it read PY_LONG_LONG instead of 'long long' ?
2004-07-23 14:49:52 +00:00
336689b9cc
A few trivial edits.
2004-07-23 02:48:24 +00:00
cab5b94592
SF bug #995983 and #995987 : Documentation nits.
2004-07-22 19:33:53 +00:00
7bd33c5e22
This change implements the following gettext features, as
...
discussed recently in python-dev:
In _locale module:
- bind_textdomain_codeset() binding
In gettext module:
- bind_textdomain_codeset() function
- lgettext(), lngettext(), ldgettext(), ldngettext(),
which return translated strings encoded in
preferred system encoding, if
bind_textdomain_codeset() was not used.
- Added equivalent functionality in translate()
function and catalog classes.
Every change was also documented.
2004-07-22 18:44:01 +00:00
c12527e2c7
[Bug #990524 ] Fix typo
2004-07-21 21:34:45 +00:00
4ab0e9e541
revise wording to avoid confusion for non-native English speakers
...
(second occurance of the same wording)
2004-07-21 17:36:47 +00:00
20938f57ba
revise wording to avoid confusion for non-native English speakers
2004-07-21 17:18:19 +00:00
b4bf62f807
Added an extra example to the basic example section
2004-07-21 14:40:11 +00:00
0ad20f18fe
Update Decimal section to match the current module
2004-07-21 13:00:06 +00:00
65a333219f
Add PEP 331; add constancy of None; minor edits
2004-07-21 12:41:38 +00:00
bf76075a4b
fix typo, highlight True/False correctly
2004-07-21 02:47:10 +00:00
7728b4719e
SF #994605 , fcntl example is broken
...
The last call to fcntl (which wasn't changed) doesn't work for me, but
the first part works now.
Backport candidate.
2004-07-21 01:41:14 +00:00
d96d1015ef
SF #918101 , allow files >= 8 GB using GNU extension
2004-07-20 22:23:02 +00:00
b0c319a905
Patch #993187 : Make rstrip doc similar to lstrip.
...
Backported to 2.3.
2004-07-19 16:34:01 +00:00
76aa2eff4e
Get doc to build (add missing backslash)
2004-07-19 01:39:54 +00:00
3d7d372ce3
Whitespace normalization, via reindent.py.
2004-07-18 06:25:50 +00:00
2bb146f2f4
Bring CJKCodecs 1.1 into trunk. This completely reorganizes source
...
and installed layouts to make maintenance simple and easy. And it
also adds four new codecs; big5hkscs, euc-jis-2004, shift-jis-2004
and iso2022-jp-2004.
2004-07-18 03:06:29 +00:00
910d8f1e89
Change CJK encoding aliases to their most popular variation of
...
hyphen and underscores in consistency of non-CJK aliases.
(Spotted by Mike Brown at SF #969415 )
2004-07-17 14:44:43 +00:00
e970d2a310
Add a definition (found in the Debian patches for 2.3.4)
2004-07-17 14:43:32 +00:00
2b05248e8b
SF #990497 : Fix a trivial typo in sorted() example.
...
(Submitted by Daniel Pezely)
2004-07-17 13:53:48 +00:00
872dc5c457
Minor edits
2004-07-17 13:35:43 +00:00
8ff9f9f4aa
Supply missing word in new datetime docs, aggravated by copy-paste-edit.
2004-07-17 01:42:26 +00:00
6c09a21f66
Fix for #795649 : explain how to use TextEdit for editing Python code.
2004-07-15 22:38:06 +00:00
0045717090
Add thread-local feature
2004-07-15 11:52:40 +00:00
23406894ea
Correct a paragraph: basicConfig() isn't actually new
2004-07-15 11:44:42 +00:00
de8332171a
SF bug 990749: os constants missing
...
A LaTeX comment identified the 6 os.O_XXX constants the docs claimed
are available on Windows but aren't. The bug report listed the same 6.
Split these non-Windows constants into a different table with a possibly
correct "Availability:" claim.
2004-07-15 05:46:37 +00:00
5960d80e11
s/it's/its/, s/NULL/NULL{}/, where appropriate.
2004-07-15 04:23:13 +00:00
eda29306b3
Formalize that the Py_VISIT macro requires that the tp_traverse
...
implementation it's used in must give its arguments specific names.
2004-07-15 04:05:59 +00:00
89ba1fff17
Bump version; update date
2004-07-14 21:56:19 +00:00
9296023938
Improve examples for working with the context API.
2004-07-14 21:06:55 +00:00
d15dc06df0
Implemented thread-local data as proposed on python-dev:
...
http://mail.python.org/pipermail/python-dev/2004-June/045785.html
2004-07-14 19:11:50 +00:00
aa6389e13b
Documented the new Py_VISIT macro to simplify implementation of
...
tp_traverse handlers. (Tim made me do it. ;)
2004-07-14 19:08:17 +00:00
8c5aeaa277
Implemented a new Py_CLEAR macro. This macro should be used when
...
decrementing the refcount of variables that might be accessed as a
result of calling Python
2004-07-14 19:07:35 +00:00
7a0e8bc283
Updated documentation to:
...
- point out the importance of reassigning data members before
assigning thier values
- correct my missconception about return values from visitprocs. Sigh.
- mention the labor saving Py_VISIT and Py_CLEAR macros.
2004-07-14 19:07:24 +00:00
8cec3ab0e4
- Bug #981530 : Fix UnboundLocalError in shutil.rmtree(). This affects
...
the documented behavior: the function passed to the onerror()
handler can now also be os.listdir.
[I could've sworn I checked this in, but apparently I didn't, or it
got lost???]
2004-07-14 00:48:58 +00:00
c0ed9c4956
clarify where \versionadded and \versionchanged should be placed when
...
they are used
2004-07-13 21:04:26 +00:00
e45d5a3b00
Claifications: visit procs are supplied by the core, users aren't
...
expected to write their own. A NULL "object" must not be passed to
the visit callback. A non-zero return from a visit proc isn't
necessarily an error return (and it doesn't matter to the tp_traverse
code *what* it might signify, their only job is to return it).
2004-07-13 17:18:10 +00:00
0751d554c0
generalize a bit; no need to mention my user id directly
2004-07-13 17:08:10 +00:00
2a510ce119
Wordsmithing
2004-07-13 14:03:31 +00:00
71868e74d6
Add another point in the "Restrictions" section about how the handling of FTP
...
URLs will seemingly succeed to read a URL that points to a file whose
permissions you do not have to read.
Backport candidate once everyone agrees with the wording.
2004-07-13 00:48:42 +00:00
20f42c433b
Fixed minor bugs in the example configuration file
2004-07-12 15:48:04 +00:00
d7c7115926
Small elaboration and typo fixes.
2004-07-12 13:22:14 +00:00
ca1a775ab9
Fix markup.
2004-07-12 13:00:45 +00:00
1869df1154
another note for amk
2004-07-12 08:15:37 +00:00
5af0e41482
Bug #788520 : Queue class has logic error when non-blocking
...
I don't agree it had a bug (see the report), so this is *not* a candidate
for backporting, but the docs were confusing and the Queue implementation
was old enough to vote.
Rewrote put/put_nowait/get/get_nowait from scratch, to use a pair of
Conditions (not_full and not_empty), sharing a common mutex. The code
is 1/4 the size now, and 6.25x easier to understand. For blocking
with timeout, we also get to reuse (indirectly) the tedious timeout
code from threading.Condition. The Full and Empty exceptions raised
by non-blocking calls are now easy (instead of nearly impossible) to
explain truthfully: Full is raised if and only if the Queue truly
is full when the non-blocking put call checks the queue size, and
similarly for Empty versus non-blocking get.
What I don't know is whether the new implementation is slower (or
faster) than the old one. I don't really care. Anyone who cares
a lot is encouraged to check that.
2004-07-12 00:45:14 +00:00
183dabcd73
SF patch 986010: add missing doc for datetime C API, from
...
Anthony Tuininga.
This is a derived patch, taking the opportunity to add some organization
to the now-large pile of datetime-related macros, and to factor out
tedious repeated text.
Also improved some clumsy wording in NEWS.
2004-07-11 19:26:19 +00:00
e246508779
Add FAQ on non-GNU make error. Update copyright date to 2004.
2004-07-11 16:40:31 +00:00
2363e8fece
Added documentation for the "smtpd" module.
...
Closes SF bug #450803 .
2004-07-11 16:25:25 +00:00
88e8e34ab0
Style nit.
2004-07-11 13:20:11 +00:00
44dc13bf3e
Fix decimal write-up nits.
2004-07-11 12:49:47 +00:00
65df07bf23
Minor improvements, fixups and wording changes everywhere.
2004-07-11 12:40:19 +00:00
ad5206fc02
Clarify requirement for GNU make
2004-07-11 04:10:14 +00:00
8932b41669
Patch 851752 (fixes bug 820583)
...
Patch by John J Lee
Reviewed by Jeff Epler / KBK
Doc built OK.
urlopen() may return None if no handler handles the request.
Also clarify what install_opener does.
M liburllib2.tex
2004-07-11 02:13:17 +00:00
cd77dd6321
Fix minor error in example.
2004-07-10 23:06:07 +00:00
711e7d97e4
Add PyArg_VaParseTupleAndKeywords(). Document this function and
...
PyArg_VaParse().
Closes patch #550732 . Thanks Greg Chapman.
2004-07-10 22:20:32 +00:00
91cc5cd188
Clarify docs for inspect.getargspec() that the fourth value is None when there
...
are no default arguments for the function.
2004-07-10 21:13:06 +00:00
3a2418a1d6
[Patch #969900 ] Various corrections and updates to cookielib docs
2004-07-10 18:41:28 +00:00
300ce19592
[Patch #972310 ] Apply correction to docs
2004-07-10 18:28:33 +00:00
21f9fce968
Fix typo.
2004-07-10 16:11:03 +00:00
099bd524a4
[Bug 949832] Fix example; edit sentence
2004-07-10 16:01:10 +00:00
bf4406971c
Improve Context construction and representation:
...
* Rename "trap_enablers" to just "traps".
* Simplify names of "settraps" and "setflags" to just "traps" and "flags".
* Show "capitals" in the context representation
* Simplify the Context constructor to match its repr form so that only
the set flags and traps need to be listed.
* Representation can now be run through eval().
Improve the error message when the Decimal constructor is given a float.
The test suite no longer needs a duplicate reset_flags method.
2004-07-10 14:14:37 +00:00
d9dfe0213f
Remove a few elderly sentences
2004-07-10 13:48:54 +00:00
ff8113f8d0
Replace example with simpler alternative using PyGILState_{Ensure,Require). Can someone please confirm this change is OK?
2004-07-10 13:42:52 +00:00
371d98ab15
[Bug #987835 ] Add documentation from PEP 311. (Untested TeX code.)
2004-07-10 13:31:18 +00:00
0d278b861e
SF bug #987486 : fix typo.
2004-07-10 11:15:56 +00:00
682be2249d
SF bug 988387: markup nits.
2004-07-10 11:11:15 +00:00
5da4c83a6b
reminder for amk
2004-07-09 16:16:46 +00:00
5aa478badf
Module and tests:
...
* Map conditions to related signals.
* Make contexts unhashable.
* Eliminate used "default" attribute in exception definitions.
* Eliminate the _filterfunc in favor of a straight list.
Docs:
* Eliminate documented references to conditions that are not signals.
* Eliminate parenthetical notes such as "1/0 --> Inf" which are no
longer true with the new defaults.
2004-07-09 10:02:53 +00:00
97c9208c6c
Incorporate Facundo's suggestions.
2004-07-09 06:13:12 +00:00
9499658b61
Add a link to the decimal module docs.
2004-07-09 06:00:32 +00:00
2b2795ac6d
show how easy it is to manipulate individual columns - from a request on
...
c.l.py
2004-07-08 19:49:10 +00:00
081483cd42
Fix markup and nits.
2004-07-08 09:33:00 +00:00
536f76b25a
Fix markup, typos, and nits.
2004-07-08 09:22:33 +00:00
63a0191c8a
Deal with macros that have to be replaced with simple text; only a
...
couple of these are currently found in index data, but these should
all be handled in the same way.
Closes SF bug #952737 .
2004-07-08 03:56:12 +00:00
e3c330b42a
Replaced some tabs with spaces in verbatim section.
2004-07-07 15:59:49 +00:00
ee5e4cd899
[Bug #984017 ] Incorrect prototype, fixed by Timothy Stranex
2004-07-07 13:07:47 +00:00
bcefe698b0
Add logging changes
2004-07-07 13:01:53 +00:00
74979664d0
Typo repair.
2004-07-07 02:32:36 +00:00
2f55eb4cca
Demonstrate how to round final result.
2004-07-06 01:55:14 +00:00
10959b1c2a
Expand examples to show polymorphism
2004-07-05 21:13:28 +00:00
77e13b4ead
Simplify examples.
2004-07-05 20:27:53 +00:00
c4f93d4410
Doc tested the recipes.
2004-07-05 20:17:13 +00:00
9c719bafbf
Fix typo
2004-07-05 18:56:03 +00:00
d84efb3d93
* Added missing info on construction from a tuple.
...
* Added a recipe section.
2004-07-05 18:41:42 +00:00
8de63a206e
Add decimal docs to the core.
2004-07-05 05:52:03 +00:00
71432f1db6
Various edits
2004-07-05 01:40:07 +00:00
Andrew M. Kuchling
Michael W. Hudson
Fred Drake
Raymond Hettinger
Phillip J. Eby
Matthias Klose
Vinay Sajip
Hye-Shik Chang
Martin v. Löwis
Neal Norwitz
Anthony Baxter
Tim Peters
Skip Montanaro
Thomas Heller
Gustavo Niemeyer
Jack Jansen
Jim Fulton
Guido van Rossum
Brett Cannon
Kurt B. Kaiser