Commit graph

1756 commits

Author SHA1 Message Date
Fred Drake
5ed1dac4c0 Update documentation for pyexpat (xml.parsers.expat), to reflect the new
support for Expat 1.95.*.
2001-02-08 15:40:33 +00:00
Fred Drake
cf2636696d Fix markup typo in a {verbatim} environment (there should not be any!);
caught by Eric Raymond.
2001-02-03 14:35:38 +00:00
Fred Drake
40e43bfaf7 Document Node.isSameNode(). 2001-02-03 01:20:01 +00:00
Fred Drake
f891404e1a Move the whrandom section back to the documented modules section; this
gives people a chance to see the depracation notice.
2001-02-03 01:17:41 +00:00
Fred Drake
269625f67a Revise the deprecation note for the whrandom module to be correct and a
little more formal.
2001-02-03 01:12:44 +00:00
Fred Drake
6270031f4e Adjustments to the text of the UnixMailbox description. Added
PortableUnixMailbox as a separate class as well (this also generates
the right index entry).
2001-02-02 03:51:05 +00:00
Fred Drake
57d943ad38 Move the whrandom entry to the "Obsolete Modules" appendix. 2001-02-02 02:45:08 +00:00
Fred Drake
844bd5b4a9 Minor markup adjustments. 2001-02-02 02:42:31 +00:00
Fred Drake
68b6417c5a Added a warning at the top saying that user code should not use the
whrandom module directly.
2001-02-02 02:41:17 +00:00
Fred Drake
d0946da701 Fix some markup breakage that prevented formatting; re-wrapped a couple of
wide paragraphs.
2001-02-01 15:53:24 +00:00
Fred Drake
36154b2dbf Added entry for weakref documentation.
Moved commented-out entries for obsolete module to an appendix, still
commented out.
2001-02-01 05:21:46 +00:00
Fred Drake
ebcf6a8573 Documentation for the weakref module. 2001-02-01 05:20:20 +00:00
Tim Peters
0de88fc4b1 Change random.seed() so that it can get at the full range of possible
internal states.  Put the old .seed() (which could only get at about
the square root of the # of possibilities) under the new name .whseed(),
for bit-level compatibility with older versions.  This occurred to me
while reviewing effbot's book (he found himself stumbling over .seed()
more than once there ...).
2001-02-01 04:59:18 +00:00
Barry Warsaw
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
Barry Warsaw
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
Eric S. Raymond
3229b859fb More on noutrefresh() and scroll(). 2001-01-29 06:39:33 +00:00
Skip Montanaro
4fda21ba6b updated to document use of sequences of two-element tuples as inputs 2001-01-28 21:18:16 +00:00
Fred Drake
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
Eric S. Raymond
9ca35ec97a Instructive example for strftime(); how to generate RFC822 dates. 2001-01-28 00:56:54 +00:00
Eric S. Raymond
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
Fred Drake
66f98b45cd Fix a number of typos found by Guido. 2001-01-26 20:51:32 +00:00
Fred Drake
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
Tim Peters
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
Fred Drake
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
Tim Peters
517ce23183 Clarify winsound.beep docs, in response to c.l.py beep brouhahalet. 2001-01-25 09:33:48 +00:00
Tim Peters
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
Tim Peters
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
Barry Warsaw
83125775e0 A \begin{funcdesc} was closed with an \end{methoddesc}. 2001-01-25 00:39:16 +00:00
Barry Warsaw
21f37e1b88 Fixed a bug where \& was needed. 2001-01-25 00:38:15 +00:00
Barry Warsaw
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
Tim Peters
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
Fred Drake
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
Ka-Ping Yee
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
Fred Drake
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
Fredrik Lundh
0110d3b2ad new unicodedata functions (name, lookup) 2001-01-24 08:10:07 +00:00
Skip Montanaro
eda28445c0 documented (new) optional doseq parameter to urlencode. 2001-01-24 06:36:06 +00:00
Eric S. Raymond
f79cb2db3e Expose the autoraise capability. Improve the documentation. 2001-01-23 13:49:44 +00:00
Eric S. Raymond
aeb5532ca0 Oops...finish a mangled sentence. 2001-01-23 13:22:28 +00:00
Eric S. Raymond
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
ef8cd7ca99 Minor markup adjustment. 2001-01-22 17:42:32 +00:00
Thomas Wouters
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
Marc-André Lemburg
6f77667a64 Backed out the unistr() builtin. 2001-01-19 21:36:19 +00:00
Fred Drake
bc0b260a77 Minor markup cleaning, and one required fix in the unistr() description. 2001-01-18 18:09:07 +00:00
Skip Montanaro
9483bed6d9 correct typo - closes bug #129205 2001-01-18 10:44:08 +00:00
Ka-Ping Yee
3a9582fbe5 Fix the example (it didn't seem to reflect reality). 2001-01-18 07:50:17 +00:00
Marc-André Lemburg
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
Fred Drake
90badd1286 Add a missing newline in an example; caught by Chris Ryland
<cpr@emsoftware.com>.
2001-01-17 05:12:13 +00:00