30dbd1429a
Document the two changes to the mailbox.py module:
...
- All constructors grow an optional argument `factory' which is a
callable used when new message instances are created by the next()
methods. Defaults to the rfc822.Message class.
- A new subclass of UnixMailbox is added, called PortableUnixMailbox.
It's identical to UnixMailbox, but uses a more portable test for
From_ delimiter lines. With PortableUnixMailbox, any line that
starts with "From " is considered a delimiter (this should really
check for two newlines before the F, but it doesn't.
2001-01-31 22:14:01 +00:00
b416290d5d
Some rewriting of the "Internationalizing your programs and modules"
...
subsection to include a discussion of the msgfmt.py program.
2001-01-31 21:21:45 +00:00
5599441bbf
Make HTML the default output format, since that is what people actually
...
want most of the time.
2001-01-30 22:30:01 +00:00
10f8ba4fc6
Remove note about the compiler not checking for two kinds of illegal
...
imports. It checks for them now.
2001-01-30 01:25:15 +00:00
4308d3c4b5
Add note about non-recursive Makefiles
...
Get Fred's name right
Add some XXX items that need to be written
2001-01-29 17:36:53 +00:00
3229b859fb
More on noutrefresh() and scroll().
2001-01-29 06:39:33 +00:00
4fda21ba6b
updated to document use of sequences of two-element tuples as inputs
2001-01-28 21:18:16 +00:00
c37f5b3296
Adjust documentation for new.instance() to reflect that the second
...
parameter may be omitted or None.
2001-01-28 17:23:05 +00:00
5838d0fc84
Document the PyInstance_*() functions and data.
2001-01-28 06:39:35 +00:00
9ca35ec97a
Instructive example for strftime(); how to generate RFC822 dates.
2001-01-28 00:56:54 +00:00
e7213c7a80
Emphasis that instantiating this class doesn't consume the message body.
...
Fix some unclear language in the description of the addrlist member.
2001-01-27 10:56:14 +00:00
66f98b45cd
Fix a number of typos found by Guido.
2001-01-26 20:51:32 +00:00
8c071d4388
Massively improved documentation for string formatting operations,
...
primarily from Evelyn Mitchell (thanks!).
This closes SF patch #103412 .
2001-01-26 20:48:35 +00:00
2f4453af6a
Typo: coplete --> complete
...
This closes SF bug #129759 .
2001-01-26 15:27:35 +00:00
e360d9507a
The combo of getstate/setstate/jumpahead is very powerful, but needs
...
examples to flesh it out for the uninitiated. Here they are.
2001-01-26 10:00:39 +00:00
8863460490
Add bzip2 archives back to the set of generated archives; we had way too
...
many reasonable requests to keep them around.
Bump version number.
2001-01-25 17:32:51 +00:00
29052482d1
Removed references to Python 1.5.3; that was a "tentative" number I used
...
in the docs to indicate the next version before we decided on 1.6.
Adjusted winsound.Beep() description slightly as well.
2001-01-25 17:29:18 +00:00
cf069da57d
Update link to LaTeX2HTML web site.
2001-01-25 17:25:28 +00:00
517ce23183
Clarify winsound.beep docs, in response to c.l.py beep brouhahalet.
2001-01-25 09:33:48 +00:00
d52269bfd0
Fix bugs introduced by rewrite (in particular, time-based initialization
...
got broken). Also added new method .jumpahead(N). This finally gives us
a semi-decent answer to how Python's RNGs can be used safely and efficiently
in multithreaded programs (although it requires the user to use the new
machinery!).
2001-01-25 06:23:18 +00:00
d7b5e88e8e
Reworked random.py so that it no longer depends on, and offers all the
...
functionality of, whrandom.py. Also closes all the "XXX" todos in
random.py. New frequently-requested functions/methods getstate() and
setstate(). All exported functions are now bound methods of a hidden
instance. Killed all unintended exports. Updated the docs.
FRED: The more I fiddle the docs, the less I understand the exact
intended use of the \var, \code, \method tags. Please review critically.
GUIDO: See email. I updated NEWS as if whrandom were deprecated; I
think it should be.
2001-01-25 03:36:26 +00:00
83125775e0
A \begin{funcdesc} was closed with an \end{methoddesc}.
2001-01-25 00:39:16 +00:00
21f37e1b88
Fixed a bug where \& was needed.
2001-01-25 00:38:15 +00:00
8ee1a4bdeb
Provide a much better (and complete!) description of the lockf()
...
function, based on an eyeballing of the code.
2001-01-25 00:36:54 +00:00
902446a28d
Supply long-missing docs for random.seed(). Extensive rewrite of module
...
intro docs.
*************** Fred: check my LaTeX! Also, the docs for whrandom should
*************** be moved into Obsolete Modules.
2001-01-24 23:06:53 +00:00
9368a12011
Fix an obvious usage nit I should have caught myself on the previous
...
change to this file. Thanks, /F!
2001-01-24 18:19:40 +00:00
fa004ad36c
Show '\011', '\012', and '\015' as '\t', '\n', '\r' in strings.
...
Switch from octal escapes to hex escapes for other nonprintable characters.
2001-01-24 17:19:08 +00:00
0bbaa515a1
Remove evil "sec:" prefix from some \label markups; this is bad for
...
filenames on Windows (& Mac?) platforms.
2001-01-24 16:39:35 +00:00
b1b6a11b28
AttributeList --> NamedNodeMap
...
Since there is no such thing as an AttributeList, don't say "attributes"
is one.
2001-01-24 16:17:15 +00:00
0110d3b2ad
new unicodedata functions (name, lookup)
2001-01-24 08:10:07 +00:00
eda28445c0
documented (new) optional doseq parameter to urlencode.
2001-01-24 06:36:06 +00:00
1ae43c4341
Add names of people who've pointed out broken links and images
...
Bump version number
2001-01-24 01:11:26 +00:00
d975196d57
Fredrik pointed out that the database shrank more than 55K
2001-01-24 00:52:56 +00:00
26e94a8822
Jeremy didn't write PEP 205, Fred did!
2001-01-23 15:21:05 +00:00
f79cb2db3e
Expose the autoraise capability. Improve the documentation.
2001-01-23 13:49:44 +00:00
aeb5532ca0
Oops...finish a mangled sentence.
2001-01-23 13:22:28 +00:00
f7f185116a
Rewrite webbrowser.py to fix various bugs following Ka-Ping Yee's
...
complaints. The new version moves most of its initialization to
package load time; it's simpler, faster, smaller, and adds support for
Mozilla and Links. Interpretation of the BROWSER variable now works
and is documented. The open_new entry point and methods are marked
"deprecated; may be removed in 2.1".
2001-01-23 13:16:32 +00:00
f33c118869
Add introductory note about this article's draft status
...
Grammatical and typographic fixes from David Goodger
Expanded notes about PEP 229
Removed user-visible XXXes; they're in comments now
2001-01-23 02:48:26 +00:00
da6daee439
A variety of updates of out-of-date information.
2001-01-22 21:38:09 +00:00
bc3974c03b
When generating the source package, copy in the LICENSE file from the main
...
source directory.
2001-01-22 21:34:20 +00:00
9c3b9b76c1
Never mind ignoring a copied LICENSE file; let's do this another way.
2001-01-22 21:31:38 +00:00
e94b9f9d3c
Ignore the generated LICENSE file needed for the documentation source
...
package.
2001-01-22 21:07:36 +00:00
3a045e8993
Change the main targets to generate HTML instead of PostScript.
...
Update the comments at the beginning of the file.
2001-01-22 20:47:26 +00:00
dc40ac0fe0
Added link to the "Python Codecs" project at SourceForge.
...
Changed markup of the list of values for the list of meaningful "errors"
values.
2001-01-22 20:17:54 +00:00
91834c6c7e
Added dictionary.popitem() and the improved XML modules.
...
Reorder the smaller items, roughly in decreasing order of visibility to
the Python coder
Finished an incomplete sentence.
Moved the unwritten sections down to the bottom.
Bumped version number and added acknowledgements
2001-01-22 19:51:13 +00:00
0f564eaceb
Change some wording to make this work with PDF generation -- using a PDF
...
hyperlink at the start of the paragraph confused pdflatex; it saw the
link start while still in vertical mode, which is not allowed. Including
text before the link forces horizontal mode.
2001-01-22 19:06:20 +00:00
bcb09fa33f
Worked around bug SF #125880 : changed the text of three sections that
...
really nasty TeX source to "bleed" into the PDF "bookmarks".
2001-01-22 18:38:00 +00:00
5f0decf0d3
Clean up the docs for the "random" module according to comments from Tim
...
Peters.
This closes SF bug #125919 .
2001-01-22 18:18:30 +00:00
f228fd10d9
Add reference to PEP 232.
...
Use correct flag name Py_TPFLAGS_CHECKTYPES
Mention that numeric methods can return Py_NotImplemented (NAS)
Mention optional arguments in time modules (TW)
Various minor rewrites and additional attributions
2001-01-22 17:52:19 +00:00
31ab298df6
Remove the dollar sign from the formatting of environment variables --
...
too Unix-specific, and not really needed. (Already fixed the HTML
formatting, but forgot to mention it in the checkin for python.perl 1.94.)
2001-01-22 17:50:42 +00:00
0a8690a0ad
Make "PythonLabs" bold.
2001-01-22 17:48:23 +00:00
c8e8281fb6
Updated note about collection of cyclic garbage, based on comments from
...
Chris Ryland.
2001-01-22 17:46:18 +00:00
ef8cd7ca99
Minor markup adjustment.
2001-01-22 17:42:32 +00:00
afc7ce118e
Fix \seepep handling -- correct URL to the online PEP repository on SF is
...
now generated. (SF bug #129692.)
Patch from Anthon van der Neut <anthon@mnt.org>:
Work around the removal of content-less paired tags used for name
anchors in some places. (SF bug #116008.)
Move some class attributes from an artificial SPAN element to otherwise
"useful" elements that are being generated anyway. Added the class
"versionnote", used for \deprecated, \versionadded, \versionchanged.
2001-01-22 17:33:24 +00:00
b216ab632f
Fill out various transcripts and XXX bits, thanks to the WMATA.
...
The only missing section is the Nested Scopes section, which has to wait
to see if a patch is actually committed. (Plus any other notable changes
that get made or backed out between now and 2.1final, of course...)
2001-01-22 16:15:44 +00:00
90cecee894
Beginning of a "What's New in Python 2.1" article
2001-01-22 04:02:09 +00:00
fe385251f4
Make the 'time' argument to the timemodule functions strftime, asctime,
...
ctime, gmtime and localtime optional, defaulting to 'the current time' in
all cases. Adjust docs, add news item. Also convert all argument-handling to
METH_VARARGS. Closes SF patch #103265 .
2001-01-19 23:16:56 +00:00
5566c1ce36
Fixed a bunch of typos caught by Gilles Civario.
2001-01-19 22:48:33 +00:00
0fe5af9b4d
Clarify comments about returning None using a return without an expression;
...
this is not hard to explain!
Closes SF bug #129345 .
2001-01-19 22:34:59 +00:00
6f77667a64
Backed out the unistr() builtin.
2001-01-19 21:36:19 +00:00
bc0b260a77
Minor markup cleaning, and one required fix in the unistr() description.
2001-01-18 18:09:07 +00:00
ab782dd6cc
Document rich comparisons.
2001-01-18 15:17:06 +00:00
9483bed6d9
correct typo - closes bug #129205
2001-01-18 10:44:08 +00:00
3a9582fbe5
Fix the example (it didn't seem to reflect reality).
2001-01-18 07:50:17 +00:00
a544ea2354
Undoing the whitespace patches which sneaked into the earlier patch.
2001-01-17 18:04:31 +00:00
ad7c98e264
This patch adds a new builtin unistr() which behaves like str()
...
except that it always returns Unicode objects.
A new C API PyObject_Unicode() is also provided.
This closes patch #101664 .
Written by Marc-Andre Lemburg. Copyright assigned to Guido van Rossum.
2001-01-17 17:09:53 +00:00
90badd1286
Add a missing newline in an example; caught by Chris Ryland
...
<cpr@emsoftware.com>.
2001-01-17 05:12:13 +00:00
20ab9e9c0a
Document xreadlines() method. (Forgot to check this in before!)
2001-01-17 01:18:00 +00:00
25be1931a0
Fix a few small markup/consistency nits.
2001-01-16 20:52:41 +00:00
bd1a489759
push_source() and pop_source() entry points for shlex instances.
...
These basically just make available to the user what userhook()
does to the source stack. Documentation included.
2001-01-16 14:18:55 +00:00
83ad5015cb
effbot caught a typo!
2001-01-15 20:51:40 +00:00
773d9f09be
Document function attributes for both the function type and the method
...
type. The method documentation also includes a new brief discussion
of `bound' vs. `unbound' and why setting an attr on a bound method is
a TypeError. Includes Skip's suggested text.
2001-01-15 20:28:50 +00:00
a770e866d6
Fixing author's email address.
2001-01-15 17:08:45 +00:00
97d3b93c2f
Document changed default to passive mode.
2001-01-15 16:37:05 +00:00
77b20f099e
Document filterwarnings(..., append=<bool>).
2001-01-14 14:10:18 +00:00
34bafcc079
Fix a variety of minor nits and typos caught by Chris Ryland
...
<cpr@emsoftware.com>.
2001-01-14 02:57:14 +00:00
1beb3d204f
Added note that this module was added in Python 2.1.
2001-01-12 22:57:32 +00:00
ca7e1ee01a
Updated descriptions to incorporate additional information from Tim Peters.
...
This mostly closes SF bug #128251 .
2001-01-11 22:49:49 +00:00
a177c40daf
Document \code{import} in pth files.
2001-01-11 22:07:25 +00:00
49c9ac30a4
Fixed minor markup nits for consistency with the rest of the library
...
reference.
2001-01-11 16:02:08 +00:00
ab78beca2f
Added pointer on POP3 variations.
2001-01-11 10:22:34 +00:00
f68f2fec7d
Implementation of PEP-0217.
...
This closes the PEP, and patch 103170
2001-01-11 05:41:27 +00:00
5ac97957f7
Corrections and additions to the documentation for POP3 and IMAP library
...
support, based on my fetchmail experience.
2001-01-11 04:19:52 +00:00
8321026ff4
SourceForge patch #103140 , checked in at fdrake's invitation. Minor fixes and
...
additions to library docs.#
2001-01-10 19:34:52 +00:00
fe338ca540
Fix a typo, remove one copy of a duplicated name.
2001-01-10 05:33:38 +00:00
675e1d0a0d
Remove bogus "echo" command.
2001-01-09 22:50:13 +00:00
3c48ef7de8
Added documentation for the xreadlines module & related changes. The
...
documentation was written by Jeff Epler (thanks!).
2001-01-09 22:47:46 +00:00
42181dba8e
Added a --global-module-index option to specify a (possibly relative) URL
...
to the Global Module Index for a set of documents. This is used to include
a reference to the global index from the per-document module indexes, so
that it is just a little easier to find.
(Someone suggested this, but I do not remember who. Please let me know if
it was you -- thanks!)
2001-01-09 22:02:10 +00:00
c49480ed51
Miscellaneous updates.
2001-01-09 21:40:52 +00:00
347a62505c
Steve Holden <sholden@holdenweb.com>:
...
Clarify the handling of characters following backslashes in raw strings.
2001-01-09 21:38:16 +00:00
d5f0198dec
Added names.
2001-01-09 20:55:09 +00:00
986eafdc2b
Added missing word; fixed minor nits.
2001-01-09 20:54:15 +00:00
37f1b34b62
Added entry for fpectl module documentation.
...
Moved the mutex docs to be adjacent to the sched docs, since these are
meant to be used together (if they are used at all!).
2001-01-09 20:52:49 +00:00
fa214cca61
Added entry for fpectl module documentation.
2001-01-09 20:50:02 +00:00
a5e7ad99d5
Documentation for the fpectl module, from Lee Busby. (Thanks!)
2001-01-09 20:38:54 +00:00
45b1d6a831
Explain that long options are matched based on a unique prefix rather than
...
requiring the whole option to be typed out.
This closes SF bug #126863 .
2001-01-08 16:05:51 +00:00
81473b12b7
The Python/C API deals in PyObject*, not PyDictObject*.
2001-01-08 05:53:53 +00:00
e1d4715a6f
Update explanation of the set_location() method to indicate that in
...
BTree databases, the key need not be in the database. Also, tell about
the exception if the key is not in the DB for other DB types.
This closes SF bug #127377 .
2001-01-05 06:44:19 +00:00
b31d36cf01
Fix the bugfix for SF bug #127151 -- make sure we map "previous_page" to
...
"previous" and "next_page" to "next". This way the proper icons are found.
2001-01-04 15:16:01 +00:00
445f832060
__rcmp__() description: Changed to indicate that this is no longer
...
supported as of Python 2.1. We still need to
have an entry for this since it is reasonable
for users to want to understand existing code.
This closes SF bug #122715 .
2001-01-04 15:11:48 +00:00
4e18f07613
Based on comments from Guido, do not describe bisect() and insert() as
...
being "for backward compatibility." Also revert to using bisect() in the
example, since Guido thinks that is the best recommendation for typical
usage.
2001-01-04 14:18:55 +00:00
288927f426
Markup nit: Command line options should be marked with \programopt.
...
Other minor markup nits fixed.
Make reference to PyErr_Warn() a hyperlink.
2001-01-04 05:59:37 +00:00
316ef7c574
Markup nit: Command line options should be marked with \programopt.
2001-01-04 05:56:34 +00:00
b162d188f6
Fix typo spotted by Detlef Lannert <lannert@users.sourceforge.net>.
2001-01-04 05:48:08 +00:00
19ae78302e
Added information about the interaction of opening a file in append mode
...
and seek() in the description of seek().
This closes SF bug #126850 .
2001-01-04 05:16:39 +00:00
22e9a5eaec
Markup nit: OK and ERR should be marked \constant in running text.
2001-01-04 05:14:45 +00:00
2a72712efe
Update documentation to include the new functions, and use the more
...
explicitly-named bisect_right() in the example code.
This closes SF bug #127055 .
2001-01-04 05:12:52 +00:00
9c15fa7a0f
Description of long(): A string parameter is no longer required to be
...
*decimal*.
This closes SF bug #127273 .
2001-01-04 05:09:16 +00:00
48c2eb9165
Document the NotImplemented object.
2001-01-04 01:25:50 +00:00
d18722b99d
Do not cache <img> tags for navigation icons as agressively; this fixes
...
bug #127151 .
2001-01-02 22:08:48 +00:00
2cba0f641f
Improve description of else clause of the try/except/else statement.
...
This closes (again!) bug #127098 .
2001-01-02 19:22:48 +00:00
cc97f8c609
Fix up an awkward sentence, pointed out by Chris Ryland <cpr@emsoftware.com>.
2001-01-01 20:33:06 +00:00
8e2b6b5cc7
Change documentation of 'else' clause of 'try/except' to make clear that it
...
doesn't get triggered by 'return', 'break' or 'continue'. If the
'try-inside-continue' patch does not get accepted before next release, the
'or continue' should be removed ;P
Closes SF patch #103045 and SF bug #127098 .
2000-12-31 22:52:59 +00:00
be0630282e
Fix doubled word
2000-12-26 16:14:32 +00:00
8694cc42ab
Remove redundant reference to tab (since it = 'horizontal tab')
2000-12-26 16:09:37 +00:00
e6bf85845f
Document ERR and OK
2000-12-26 15:58:27 +00:00
1dea760ca1
Make sure subsections are formatted into HTML pages with reasonable names.
2000-12-25 06:19:08 +00:00
f08cbb1771
Added information on the ExternalEntityParserCreate() method.
2000-12-23 22:19:05 +00:00
5caee408b8
Add 'see also' link to curses.panel
2000-12-22 22:06:43 +00:00
676634beda
Added documentation for the panel wrapper module
2000-12-22 21:57:42 +00:00
e412e7a3a0
Fix lots of small markup nits.
...
Wrapped some long lines.
2000-12-21 17:04:31 +00:00
68a6f5a0a2
Document the window.overlay() and .overwrite() methods
2000-12-21 16:25:44 +00:00
68abe832b9
Fix typo
2000-12-19 14:09:21 +00:00
5db5ba1ee3
Document the warnings module.
2000-12-19 06:01:23 +00:00
dea764d7f1
Updated string literals description to encompass Unicode literals and the
...
additional escape sequences defined for Unicode.
This closes bug #117158 .
2000-12-19 04:52:03 +00:00
1367b83797
Document warning categories.
2000-12-19 04:27:54 +00:00
035f7e88c8
Clarify __repr__ and __str__.
2000-12-19 04:18:13 +00:00
5b56765fe7
Added documentation on the ErrorHandler interface.
...
This closes bug #126034 .
2000-12-19 04:07:54 +00:00
e22e4b2b59
Oops. The value "0 or +1" for the category argument of PyErr_Warn()
...
doesn't work. Make it 0. (Although it really *should* be 0 or +1 --
the refcount is incremented when it is raised as an exception, but not
otherwise.)
2000-12-19 03:58:11 +00:00
9a18a7ed03
Document Pyerr_Warn().
...
Add an XXX comment at the beginning expressing disappointment over the
confusing way refcount behavior of arguments is documented.
2000-12-19 03:53:57 +00:00
3dbb406335
Document Pyerr_Warn().
2000-12-19 03:53:01 +00:00
2b6d7bc151
Do not talk about "real" numbers; talk about "floats" or "floating point
...
numbers" instead; we have not described "reals" anywhere else in the
documentation, and this is not the place to change the story!
Reported by Keith Briggs <keith.briggs@bt.com>.
2000-12-18 13:50:24 +00:00
e9e860faf3
Add support for gdbm2 open flags ('s' and 'u'). Add module constant
...
open_flags which contains the flags supported by gdbm. Closes patch
#102802 .
2000-12-17 07:14:13 +00:00
5100133685
urlretrieve() description included explanation of "data" parameter, but
...
did not include it in the signature.
Fixed some markup nits.
2000-12-15 23:57:51 +00:00
065cba1281
Added documentation for random.shuffle().
2000-12-15 19:07:17 +00:00
29c45a5e91
Grant Griffin <grant.griffin@honeywell.com>:
...
Clarify that invert() is a *bitwise* operation.
2000-12-15 05:41:49 +00:00
4fb588240f
Document napms()
...
Add reference to demo directory
2000-12-15 01:03:23 +00:00
de77bc5468
For the title page, insert the package version number before the date.
...
This makes the title area more like the title are of the top-level
index, and puts the information more people are interested in first.
2000-12-14 18:36:12 +00:00
f0b315478b
Update information on the locking() function, added the needed constants.
...
(Thanks for the info, Tim!)
2000-12-14 03:11:24 +00:00
48971198c5
Finish a sentence that was left half-written!
2000-12-13 22:36:02 +00:00
dd802208a7
Changing allow_reuse_address's default value, and documenting it.
2000-12-13 20:39:22 +00:00
24d6da3eae
Added "stub" documentation for xml.dom.pulldom for Paul to fill out with
...
useful explanations.
2000-12-13 19:34:38 +00:00
bc9c1b15cc
Added descriptions of the defined exceptions and their mapping to the
...
DOM recommendation.
2000-12-13 17:38:02 +00:00
ff63f2023d
"Documentation" for {}.popitem().
2000-12-12 22:03:47 +00:00
dc90cc2b15
Additional docs for __iadd__ and family, closing SF bug #117178 and SF patch
...
#102169 .
2000-12-11 23:11:51 +00:00
2a22200ab4
Adjust explanation of operator precedence summary -- exponentiation groups
...
from right to left!
Closes bug #125391 .
2000-12-11 22:39:24 +00:00
ed911b8cfb
Added link to HTML version of the NumPy documentation.
...
This closes bug #124943 .
2000-12-11 20:57:13 +00:00
5255c791cc
select.select(): Add note that though this function accepts empty lists,
...
using *only* empty lists may not be acceptable on all
platforms, with the specific caveat that it does not
work on Windows. Also clarified list of acceptable
objects that may be in the lists, to let the user know
that file objects are not usable here on Windows.
2000-12-11 15:50:07 +00:00
9a29dd6580
Lots of small improvements and bits of added information on the DOM API.
2000-12-08 06:54:51 +00:00
c3b18d7ca8
Fix error noted by Gerrit Holl (old; had been buried in my INBOX):
...
sequence repitition works just fine with long integers now, so we
should not say that only plain integers are allowed.
2000-12-07 04:54:02 +00:00
Barry Warsaw
Fred Drake
Jeremy Hylton
Andrew M. Kuchling
Eric S. Raymond
Skip Montanaro
Tim Peters
Ka-Ping Yee
Fredrik Lundh
Thomas Wouters
Marc-André Lemburg
Guido van Rossum
Martin v. Löwis
Moshe Zadka
Neil Schemenauer