6356fff2cb
give the document indexes
2004-03-23 19:02:38 +00:00
630e5bd2f7
- use recommended Python style in examples (no spaces around "=" for
...
keyword args)
- format multi-line calls to distutils.core.setup() consistently, and
in line with general practice (one keyword arg per line,
comma/newline after the last
- fix a few typos
2004-03-23 18:54:12 +00:00
824b1b2da8
Added command line options for profile.py - one for stats output file
...
and one for sort order when using stdout. Uses optparse.
2004-03-23 18:44:39 +00:00
6fca7cc783
merge Anthony Baxter's distutils API reference into the package
...
author's documentation
2004-03-23 18:43:03 +00:00
211a2eb784
convert from a howto to a manual
2004-03-22 21:44:43 +00:00
1eb4bfc657
Added global runctx function to profile to fix SF Bug #716587
2004-03-22 20:12:56 +00:00
cbddabfd85
Remove 'now'
2004-03-21 22:12:45 +00:00
07973dab97
Modified string.split documentation to reflect behaviour of splitting emtpy string. Closes SF bug #811604
2004-03-21 16:59:59 +00:00
20a8336ff7
concrete example of why retaining old objects is good
2004-03-21 16:05:30 +00:00
8b6cc2e7f2
Removed extra period from \versionchanged entry; macro adds period
...
automatically.
2004-03-21 14:10:18 +00:00
508c57d544
Clarify docs on where .pth files can exist.
2004-03-20 21:41:28 +00:00
fe703e0650
SF bug #918371 : hasattr()'s return type
...
Replace 1 and 0 with True and False.
2004-03-20 18:25:31 +00:00
d4079e1fc2
Update copyright years, and change copyright.tex to use the same spelling
...
as license.tex (SF patch 795531 complained about the spelling discrepancy,
although this "repairs" that flaw in a different way than the patch).
2004-03-20 17:24:51 +00:00
9de0a2ba9d
fix two typos that turned text into markup
2004-03-20 08:13:32 +00:00
8e6ad6fbe9
Expand on the semantics of reload(). Closes #919099 .
2004-03-19 15:20:16 +00:00
5c5316f111
Add a new unicode codec: ptcp154 (Kazakh)
2004-03-19 08:06:07 +00:00
ade08ea8a8
Add news entries for the dictionary optimizations.
2004-03-18 09:48:12 +00:00
d1de45f549
Fix capitalization of title for subsection 2.
2004-03-18 07:37:15 +00:00
65d63424b4
Minor grammatical fixes.
2004-03-18 01:38:11 +00:00
9b976e6636
Extremely minor typo fixed.
2004-03-18 00:49:01 +00:00
bdda9f389a
The example files need to be opened with the "b" flag.
2004-03-17 01:24:17 +00:00
49f9bd15ff
SF feature request #686323 : Minor array module enhancements
...
array.extend() now accepts iterable arguments implements as a series
of appends. Besides being a user convenience and matching the behavior
for lists, this the saves memory and cycles that would be used to
create a temporary array object.
2004-03-14 05:43:59 +00:00
c1e4f9dd92
Use a new macro, PySequence_Fast_ITEMS to factor out code common to
...
three recent optimizations. Aside from reducing code volume, it
increases readability.
2004-03-12 08:04:00 +00:00
9168c70438
SF Patch #912462 : Relocate \end tag to the right place.
...
(Submitted by George Yoshida)
2004-03-09 05:53:15 +00:00
b7d05db0be
Optimize tuple_slice() and make further improvements to list_slice()
...
and list.extend(). Factoring the inner loops to remove the constant
structure references and fixed offsets gives speedups ranging from
20% to 30%.
2004-03-08 07:25:05 +00:00
dd80f76265
SF patch #910929 : Optimize list comprehensions
...
Add a new opcode, LIST_APPEND, and apply it to the code generation for
list comprehensions. Reduces the per-loop overhead by about a third.
2004-03-07 07:31:06 +00:00
31017aed36
SF #904720 : dict.update should take a 2-tuple sequence like dict.__init_
...
(Championed by Bob Ippolito.)
The update() method for mappings now accepts all the same argument forms
as the dict() constructor. This includes item lists and/or keyword
arguments.
2004-03-04 08:25:44 +00:00
35c62e58c5
Added license notices that are required to be included in the
...
documentation as well as the source code.
2004-03-03 08:27:25 +00:00
d1080a3418
Have strftime() check its time tuple argument to make sure the tuple's values
...
are within proper boundaries as specified in the docs.
This can break possible code (datetime module needed changing, for instance)
that uses 0 for values that need to be greater 1 or greater (month, day, and
day of year).
Fixes bug #897625 .
2004-03-02 04:38:10 +00:00
0a4977c2f3
Replace left(), right(), and __reversed__() with the more general purpose
...
__getitem__() and __setitem__().
Simplifies the API, reduces the code size, adds flexibility, and makes
deques work with bisect.bisect(), random.shuffle(), and random.sample().
2004-03-01 23:16:22 +00:00
738ec90ca1
Improvements to collections.deque():
...
* Add doctests for the examples in the library reference.
* Add two methods, left() and right(), modeled after deques in C++ STL.
* Apply the new method to asynchat.py.
* Add comparison operators to make deques more substitutable for lists.
* Replace the LookupErrors with IndexErrors to more closely match lists.
2004-02-29 02:15:56 +00:00
fb0521f153
Use versionadded for new features
2004-02-28 16:00:23 +00:00
3e0877ef88
Add version changed/added to doc
2004-02-28 15:19:33 +00:00
59e02c110d
fix typo in reference to RFC 3464 DSN MIME type
2004-02-24 20:58:10 +00:00
f0ae4272b4
fix English usage error reported by Ken Fuchs
2004-02-24 16:13:36 +00:00
781380c1f8
- "Mac OS" should always include the space
...
- comment out documentation for a non-existant feature (--spec-file)
that the comments indicate isn't clearly needed
- lots of minor markup adjustments to get a more consistent
presentation
2004-02-19 23:17:46 +00:00
2a1bc50663
- according to Apple's publication style guide, yes, "Mac people" use
...
the term Installer (always capitalized, however)
- generalize the text about the term "installer" in a fairly
reasonable way
2004-02-19 23:03:29 +00:00
a9ee0da8f3
use API documentation style for the descriptions of the additional
...
functions made available in the post-installation script run by the
Windows installer
2004-02-19 22:28:15 +00:00
c54d9256fb
minor markup improvements
2004-02-19 22:16:05 +00:00
e2b4b32025
Implementation of patch 869468
...
Allow the user to create Tkinter.Tcl objects which are
just like Tkinter.Tk objects except that they do not
initialize Tk. This is useful in circumstances where the
script is being run on machines that do not have an X
server running -- in those cases, Tk initialization fails,
even if no window is ever created.
Includes documentation change and tests.
Tested on Linux, Solaris and Windows.
Reviewed by Martin von Loewis.
2004-02-18 05:59:53 +00:00
79b5cf1129
Mention the optimization of list.extend().
2004-02-17 10:46:32 +00:00
70a30e8c94
markup correction
2004-02-17 04:17:36 +00:00
d3f4a1a00a
Patch #893566 : Document that tp_dealloc may be called from any thread.
2004-02-15 21:01:17 +00:00
ab517d2eac
Fine tune the speed/space trade-off for overallocating small lists.
...
The Py2.3 approach overallocated small lists by up to 8 elements.
The last checkin would limited this to one but slowed down (by 20 to 30%)
the creation of small lists between 3 to 8 elements.
This tune-up balances the two, limiting overallocation to 3 elements
(significantly reducing space consumption from Py2.3) and running faster
than the previous checkin.
The first part of the growth pattern (0, 4, 8, 16) neatly meshes with
allocators that trigger data movement only when crossing a power of two
boundary. Also, then even numbers mesh well with common data alignments.
2004-02-14 18:34:46 +00:00
238b267bf6
Lists are measured in elements not bytes.
2004-02-13 21:50:27 +00:00
7a6d297bda
* Note list optimizations
...
* Move an example out of a comment.
2004-02-13 19:00:07 +00:00
ce3caf2e7a
minor markup improvements
2004-02-12 18:13:12 +00:00
70a6b49821
Replace backticks with repr() or "%r"
...
From SF patch #852334 .
2004-02-12 17:35:32 +00:00
e6ed33a6b3
fix minor markup error: \code{for} --> \keyword{for}
2004-02-12 14:35:18 +00:00
b1e5b50531
SF 895560: minor typo
2004-02-12 09:50:42 +00:00
29f5933fcb
add support for \e to the {alltt} environment
2004-02-10 18:30:22 +00:00
d311f1fb9b
SF #894428 , fix typo
2004-02-10 18:07:16 +00:00
27da291b2c
the \file macro is no longer a good example of where \e can't be used
2004-02-09 21:00:29 +00:00
52feb81932
support \e in \file and \filenq; this is useful for Windows paths
2004-02-09 20:58:08 +00:00
fd0e494c98
Minor edits
2004-02-09 13:23:34 +00:00
8178a22e20
Documentation for PyDescr_NewClassMethod was missing - here's at least
...
the function prototype.
Already backported to release23-maint.
2004-02-09 10:47:11 +00:00
5de33786a9
SF patch #892821 : example for urllib2 has SyntaxError
...
(Contributed by George Yoshida.)
2004-02-08 20:25:01 +00:00
3fd977964a
Fix misspelled name.
2004-02-08 20:18:26 +00:00
7820554c2c
Fix typo
2004-02-08 20:05:40 +00:00
ce9b4714ef
SF patch #880552 : Fix typo in usage message(prechm.py)
...
(Contributed by George Yoshida.)
* Also convert tabs to spaces.
2004-02-08 19:24:18 +00:00
4c9800d663
SF bug #892854 : typo in textwrap doc page
...
(Reported by Drew Perttula.)
2004-02-08 18:09:32 +00:00
5c5eb86347
* Incorporate Skip's suggestions for documentation (explain the word deque
...
comes from and show the differences from lists).
* Add a rotate() method.
2004-02-07 21:13:00 +00:00
7209294112
a couple other sunos4 support items removed
2004-02-07 12:50:19 +00:00
c058fd14a9
* Fix ref counting in extend() and extendleft().
...
* Let deques support reversed().
2004-02-07 02:45:22 +00:00
3ba85c2e8a
Have deques support high volume loads.
2004-02-06 19:04:56 +00:00
21ae4f983e
minor markup adjustments
2004-02-03 20:55:15 +00:00
4458ece4d7
Clarify minor point about the ref() and proxy() constructors.
...
This matches what is already documented for corresponding feature of the C API.
2004-02-03 19:44:26 +00:00
4d205e366c
update dependency information
2004-01-29 15:13:08 +00:00
dd256d97cc
Add documentation for collections.deque().
2004-01-29 07:35:45 +00:00
e52f3b1e56
Add documentation for collections.deque().
2004-01-29 07:27:45 +00:00
756b3f3c15
* Move collections.deque() in from the sandbox
...
* Add unittests, newsitem, and whatsnew
* Apply to Queue.py mutex.py threading.py pydoc.py and shlex.py
* Docs are forthcoming
2004-01-29 06:37:52 +00:00
bd12b181c8
fix whitespace style (inconsistent with the rest of the docs)
2004-01-27 21:08:04 +00:00
fcc51767bd
update signature of the socket constructor
...
(could someone backport this to Python 2.3.x please?)
2004-01-27 18:21:26 +00:00
ee3c6074c3
add missing period
2004-01-26 19:40:18 +00:00
913829cb1d
fix markup
2004-01-26 19:39:13 +00:00
db8d1c26d3
add references between getopt and optparse docs
2004-01-26 19:30:21 +00:00
6d98f198f7
make this distutils doc match the other in using boilerplate.tex
2004-01-26 15:07:31 +00:00
20d4738a95
no reason not to use boilerplate.tex now that it names the PSF
2004-01-23 15:23:49 +00:00
0d8da3a622
fix some sloppy markup to use \guilabel
2004-01-23 09:01:56 +00:00
f0f6d12cd4
add \guilabel macro to mark labels that occur in user interfaces
2004-01-23 08:52:28 +00:00
226f697560
fix method name in example code
2004-01-23 04:05:27 +00:00
1fe9750200
add direct link to the article in DDJ
...
closes SF bug #871402
2004-01-21 18:30:28 +00:00
ba0485a92d
expand on notion of row object type
2004-01-21 13:47:04 +00:00
7895146c40
typo
2004-01-21 13:34:35 +00:00
734fb5724f
Add a Guido inspired example for groupby().
2004-01-20 20:04:40 +00:00
5303a96808
Add CJK codecs
2004-01-18 15:55:51 +00:00
3e2a306920
Add CJK codecs support as discussed on python-dev. (SF #873597 )
...
Several style fixes are suggested by Martin v. Loewis and
Marc-Andre Lemburg. Thanks!
2004-01-17 14:29:29 +00:00
621b443b8d
- add warning that hotshot doesn't work well with threads
...
- fix some markup
2004-01-16 17:30:16 +00:00
990a46b732
minor markup improvements
2004-01-16 16:07:04 +00:00
4977ff0cf5
add a note about memory consumption and LaTeX
...
closes SF bug #721157
2004-01-13 23:56:03 +00:00
3f26af765d
- add comment about $CUSTOM_BUTTONS
...
- use_icon(): fix the check for whether a supplemental link is being
used
2004-01-13 23:43:58 +00:00
3bbd115735
markup changes
2004-01-13 23:41:32 +00:00
44a98237d8
[Bug #873205 ] Update URL
2004-01-11 23:00:16 +00:00
7e6bbe1516
The format of the string data used in the imageop module is described
...
as "This is the same format as used by gl.lrectwrite() and the imgfile
module." This implies a certain byte order in multi-byte pixel
formats. However, the code was originally written on an SGI
(big-endian) and *uses* the fact that bytes are stored in a particular
order in ints. This means that the code uses and produces different
byte order on little-endian systems.
This fix adds a module-level flag "backward_compatible" (default not
set, and if not set, behaves as if set to 1--i.e. backward compatible)
that can be used on a little-endian system to use the same byte order
as the SGI. Using this flag it is then possible to prepare
SGI-compatible images on a little-endian system.
This patch is the result of a (small) discussion on python-dev and was
submitted to SourceForge as patch #874358 .
2004-01-10 20:43:43 +00:00
c62af02ced
Fix some digicool addresses I noticed
2004-01-08 15:01:08 +00:00
115147921c
add link to the red-dove.com page about the logging package
2004-01-08 14:59:02 +00:00
4f687b3051
add new reference macro: \seelink
2004-01-08 14:57:27 +00:00
91f5cbe264
SF bug #872461 : list.extend() described as experimental
2004-01-08 00:31:50 +00:00
0c4102760c
SF Patch #864863 : Bisect C implementation
...
(Contributed by Dmitry Vasiliev.)
2004-01-05 10:13:35 +00:00
23a0f4ed21
Small correction to example
2004-01-05 08:15:20 +00:00
97ef8de92d
* Add various updates reflecting the last two weeks of checkins:
...
timeit, base64, MSVC++ 7.1 build, METH_COEXISTS, and optimizations.
* Put in a comment suggesting an improvement to the rsplit() example.
2004-01-05 00:29:57 +00:00
c14149e6ef
Show how to re-enable GC during timings.
2004-01-04 21:19:18 +00:00
4cd5a08d8b
Fix small factual error.
2004-01-04 03:11:45 +00:00
ad9aaeea6d
Documentation for new RFC 3548 functions.
2004-01-04 01:14:01 +00:00
b914ef0a33
list the Python Software Foundation on all the documents
2004-01-02 06:57:50 +00:00
d3530be729
PythonLabs --> Python Software Foundation
2004-01-02 06:52:06 +00:00
44a31e1dab
Use 'input' as variable name, even though it shadows a built-in
...
Remove applications of rsplit() and random numbers
Typo fixes; minor tweaks
2004-01-01 18:33:34 +00:00
6237ef1ddc
in the section "The interpreter stack":
...
- rearranged a bit to avoid duplicated information
- provide more complete (and hopefully less confusing) descriptions of
the return values for most of these functions
(close SF bug #563298 )
2004-01-01 07:21:14 +00:00
621c53ee9f
Add sets to list of picklable objects.
2004-01-01 05:53:51 +00:00
7a700b873b
clean up indexing for None, NotImplemented
...
closes SF bug #820344
2004-01-01 05:43:53 +00:00
fcadf6bdaf
fix reference to File Object documentation
...
closes SF bug #825810
2004-01-01 03:41:27 +00:00
9b4dab4da1
SF patch #859286 : documentation bool change fix
...
(Contributed by George Yoshida.)
2003-12-31 18:37:28 +00:00
a180581511
use conventional whitespace in interactive example
2003-12-31 07:41:52 +00:00
50e7a11af1
Correct misrepresentation of print (it uses str(), not `...` for
...
conversion). Hopefully I've not messed up the formatting.
2003-12-31 06:32:38 +00:00
af78512712
- general markup cleanup
...
- rearrange so two small sections become one; this avoids an extra
page in the HTML format
2003-12-31 05:18:46 +00:00
7f8d17a50c
general markup improvements
2003-12-31 05:01:23 +00:00
188b2d6cfa
- add link to the datetime module
2003-12-31 04:52:36 +00:00
ceb1fd2177
- update description of isleap()
...
- add link to the datetime module
2003-12-31 04:51:56 +00:00
6f51a72a61
- use the same markup for the deprecation as for that of
...
file.xreadlines()
2003-12-31 04:41:47 +00:00
ae55d5f3cb
- add a "See also" reference to the doctest module
...
- slightly simplify a couple of examples
- clean up some markup
2003-12-31 04:34:50 +00:00
ed54d91ef5
Various fixups:
...
* Add comment on the future of the sets module.
* Change a variable from "input" to "data" to avoid shadowing a builtin.
* Added possible applications for str.rsplit() and itertools.tee().
* Repaired the example for sorted().
* Cleaned-up the example for operator.itemgetter().
2003-12-31 01:59:18 +00:00
32fef9f477
fix truly evil markup typo
2003-12-30 23:08:14 +00:00
ea49de34c9
minor cleanup of example
2003-12-30 23:01:19 +00:00
ff381e13e0
- we *really* don't care about Python 1.5 alphas any more!
...
- note the interpreter's -S option
2003-12-30 22:51:32 +00:00
401d1e3cbf
fix a variety of markup bugs
2003-12-30 22:21:18 +00:00
f161c915bd
work around whitespace bugs in the HTML version
2003-12-30 22:17:16 +00:00
dcf32a676e
fix markup errors
2003-12-30 20:48:59 +00:00
b0e8f5d0fe
lots of markup adjustments
2003-12-30 20:36:20 +00:00
7c67cb8fba
markup fix
2003-12-30 17:17:17 +00:00
89d147d21d
remove ancient cruft
2003-12-30 16:44:45 +00:00
345555dddc
- make "--" in code text not get converted to "-"
...
- fix minor typo in comment
2003-12-30 16:19:28 +00:00
4922cae1e1
- remove crufty markup that's no longer needed to make the
...
presentation work right (and didn't work anyway)
- fix minor typo
2003-12-30 16:18:23 +00:00
42713109d9
use consistent email address for Tim
2003-12-30 16:15:35 +00:00
34929f23f5
- update Tim's email address
...
- remove spurious blank lines
2003-12-30 16:12:27 +00:00
f72af655c5
At 2.2, the Py<type>_Check() family of API functions (macros) changed
...
semantics to include subtypes. Most concrete object APIs then had
a Py<type>_CheckExact() macro added to test for an object's type
not including subtypes.
The PyDict_CheckExact() macro wasn't created at that time, so I've added
it for API completeness/symmetry - even though nobody has complained
about its absence in the time since 2.2 was released.
Not a backport candidate.
2003-12-26 00:07:51 +00:00
13cd8898d2
The semantics of PyList_Check() and PyDict_Check() changed at 2.2, along
...
with most other concrete object checks, but the docs weren't brought into
line.
PyList_CheckExact() was added at 2.2 but never documented.
backport candidate.
2003-12-25 23:57:52 +00:00
7553426342
[Bug #850823 ] Fix broken link
2003-12-23 17:04:35 +00:00
91ca8de6f4
[Bug #850818 ] Accept Gregory H. Ball's suggested rewrite of a confusing description
2003-12-23 17:01:38 +00:00
7a3786cc55
[Bug #857821 ] Remove mention of deprecated string.{atol,atof} functions. (Patch from Gerrit Holl)
2003-12-23 16:53:34 +00:00
273069deec
Fix silly typo
2003-12-23 16:46:41 +00:00
70029c5450
Add the first of (hopefully) many third-party licenses and acknowledgements.
2003-12-20 20:53:31 +00:00
828f847d66
minor markup adjustment
2003-12-18 20:58:34 +00:00
3435820842
Fix typo
2003-12-18 13:28:35 +00:00
35f2b05dca
Add various items
2003-12-18 13:28:13 +00:00
852fe0689a
fix loss of a space after indexing markup
2003-12-18 06:26:56 +00:00
4d88322a2b
- use correct markup
...
- re-wrap resulting long lines
2003-12-18 06:23:33 +00:00
1639f1cef9
fix weird sh-bang line
2003-12-18 05:29:33 +00:00
2fe79783a7
avoid bash-isms
2003-12-18 05:28:30 +00:00
a95e87a488
Guido grants a Christmas wish:
...
sorted() becomes a regular function instead of a classmethod.
2003-12-17 21:38:26 +00:00
b606b3d08a
Guido grants a Christmas wish:
...
sorted() becomes a regular function instead of a classmethod.
2003-12-17 20:50:46 +00:00
Fred Drake
Nicholas Bastin
Andrew M. Kuchling
Skip Montanaro
Brett Cannon
Raymond Hettinger
Tim Peters
Hye-Shik Chang
Neal Norwitz
David Ascher
Martin v. Löwis
Walter Dörwald
Thomas Heller
Sjoerd Mullender
Barry Warsaw
Guido van Rossum
Andrew MacIntyre