Commit Graph

3869 Commits

Author SHA1 Message Date
Jeremy Hylton
2c84fc8a7d Note that assignments to __debug__ are illegal 2001-03-23 14:34:06 +00:00
Jeremy Hylton
e702481d38 Revert to ver 1.22, which was the version before the nested scopes
docs were introduced.  This loses a few small changes, but Fred says
that's okay.
2001-03-23 14:05:16 +00:00
Fred Drake
16a0b17460 Bump version number. 2001-03-23 12:12:05 +00:00
Ka-Ping Yee
ce7298ab42 Explain the difference between NL and NEWLINE. 2001-03-23 05:22:12 +00:00
Ka-Ping Yee
c608fb6389 Give a slightly better explanation of excepthook. 2001-03-23 05:17:41 +00:00
Fred Drake
5e0dfaccd1 Update to the most recent weakref changes. 2001-03-23 04:36:02 +00:00
Andrew M. Kuchling
ac1abe0bfe Add a paragraph about obmalloc turning up bugs in extension modules
Mention the new ports
2001-03-23 03:52:46 +00:00
Andrew M. Kuchling
ef85cc84a0 Add section for PEP 241
Add PyUnit and sys.excepthook
2001-03-23 03:29:08 +00:00
Ka-Ping Yee
b5c5132d1a Add sys.excepthook.
Update docstring and library reference section on 'sys' module.
New API PyErr_Display, just for displaying errors, called by excepthook.
Uncaught exceptions now call sys.excepthook; if that fails, we fall back
    to calling PyErr_Display directly.
Also comes with sys.__excepthook__ and sys.__displayhook__.
2001-03-23 02:46:52 +00:00
Fred Drake
6909642d38 Bump the version number. 2001-03-22 17:01:43 +00:00
Fred Drake
15e07f4442 Update to the current state of the universe. 2001-03-22 17:00:05 +00:00
Fred Drake
e28d8aef2d Be more clear about the specific rules for supporting the cyclic GC in an
extension object.  Also included an example showing exactly what needs to
be done and nothing else.

This closes SF bug #228591.
2001-03-22 16:30:17 +00:00
Fred Drake
c392b570db Integrated an expanded version of some text from Neil Schemenauer about
supporting cyclic garbage collection.  (This is not all of it, but I'm
taking a break!)

Also fixed some markup nits.
2001-03-21 22:15:01 +00:00
Fred Drake
4e6d09e369 Moved the description of the tzparse module to the "Obsolete" section
and note that it fails when the TZ environment variable is not set.

This closes SF bug #409683.
2001-03-20 23:13:53 +00:00
Fred Drake
f531ad698c Markup nit: For the Python documents, we use \empt instead of \textit. 2001-03-19 04:19:56 +00:00
Fred Drake
b15bbc8d3d Add documentation for SGMLParser.handle_decl(). 2001-03-16 20:39:41 +00:00
Fred Drake
83e01bf6c8 Finally fill in the documentation for the PyDict_Next() function. It is
different enough to actually require an explanation.  ;-)

Fix a couple of PyDictObject* types that should be PyObject* types.
2001-03-16 15:41:29 +00:00
Fred Drake
1b0b2a4df2 Add some LaTeX magic so that Latin-1 characters do not get so badly
trashed.
2001-03-13 17:56:08 +00:00
Fred Drake
93fe96a3c8 Py_BuildValue(): Add "D" conversion to create a Python complex value from
a Py_complex C value.

Patch by Walter Dörwald.
This closes SF patch #407148.
2001-03-12 21:06:31 +00:00
Andrew M. Kuchling
45bbda2593 Fix a further markup problem noted by FLD 2001-03-10 16:49:07 +00:00
Fred Drake
f0ebbe0bd0 Re-order some method descriptions for a more logical grouping.
(Based on reader comment!)
2001-03-08 22:46:41 +00:00
Fred Drake
9eb41557ef Add more font flavors for <var> elements; the previous incarnation caused
some NT/IE5.5 users to see only boxes for these characters.  This might be
specific to NT Service Pack 6.
2001-03-08 22:17:54 +00:00
Fred Drake
859eb62108 Do not refer to "sub-modules" since that is not a defined term. 2001-03-06 07:34:00 +00:00
Fred Drake
ac79e95167 Re-word the explanation of the in/not in operators for increased content
and clarity.

Add a footnote to the information on the possibility of shadowing builtins
with locals & module globals.
2001-03-06 07:32:11 +00:00
Fred Drake
ce7129ea4e Turn "Python Documentation Central" into just "Documentation Central"; some
Web browsers tried to wrap lines in bad ways, so we avoid the problem by
putting fewer words on the page.
2001-03-06 07:28:20 +00:00
Fred Drake
2636572d76 Make sure the README files that contain page count information land in
the right directory (which actually exists).
2001-03-06 07:22:16 +00:00
Fred Drake
67fdaa4883 Correct typos in Ping's email address.
Remove premature use of negative indexes in string operation examples;
negative indexes have not been explained at that point, and the use of
negative indexes are not necessary for the examples.
2001-03-06 07:19:34 +00:00
Fred Drake
990b0fec1a Update documentation to reflect the shift to NetrcParseError instead of
SyntaxError.
2001-03-06 06:55:18 +00:00
Fred Drake
0c8f6643c6 Remove debugging "set -x". 2001-03-03 19:57:26 +00:00
Fred Drake
42119e49a9 Fix a few minor markup nits. 2001-03-03 19:47:24 +00:00
Fred Drake
6be838a0c0 Rene Liebscher <R.Liebscher@gmx.de>:
Added information on using non-Microsoft compilers on Windows.

[Minor edits for markup consistency. --FLD]
2001-03-03 19:18:01 +00:00
Andrew M. Kuchling
61af5605fa Discuss PEP 236.
Update nested scope section.
2001-03-03 03:25:04 +00:00
Andrew M. Kuchling
81df7be2a2 Update estimate bug and patch counts 2001-03-02 21:19:38 +00:00
Fred Drake
3f4e717c31 Revise the scripts I use to update the documentation on the SourceForge
site.  These now seem (slightly) more reliable, and easier to work with
since update-docs.sh no longer needs to be installed ahead of time on
my account at SF.
2001-03-02 21:05:58 +00:00
Fred Drake
93c867139f Lots of organizational changes for consistency with the rest of the
documentation.

Fix a few small markup nits.
2001-03-02 20:39:34 +00:00
Fred Drake
80d4c07775 There was a real leak in the "export a C API" example; fix that one.
(There are too many initspam() functions; they need to be renamed
post-beta.)
2001-03-02 19:48:06 +00:00
Fred Drake
ab357ecf7f Label classes and exceptions explicitly in the documentation (for their
*desc environments).
2001-03-02 18:57:05 +00:00
Fred Drake
0539bfaaa4 There is no longer a -X option to the interpreter, so remove the comments
on how PyErr_NewException() behaves in that case.

Clarify why an owned reference is kept in an extension module's
variable that refers to the result of PyErr_NewException(); one reader
thought that was a leak.

Clean up some tabs and simplify some markup.
2001-03-02 18:15:11 +00:00
Fred Drake
043d5e5514 For copyfile(), be explicit that src and dst are file names; that was only
implied.
2001-03-02 16:46:42 +00:00
Fred Drake
cfef0096f9 Job.build_html(): When formatting HTML into more than one HTML page, and
not doing the \label{foo} --> foo.html transformation (--numeric was
    specified on the command line), still look to see if there is an
    "About this document..." node and copy that to "about.html", since the
    page footers use that as the target.
2001-03-02 16:26:45 +00:00
Fred Drake
7606e4d00e Added entry for urllib2 documentation. 2001-03-01 19:54:29 +00:00
Fred Drake
8c011580ff Use larger chunks for the HTML version of the Distutils documentation. 2001-03-01 18:38:56 +00:00
Fred Drake
a9a83e9ee3 Comment out section titles for sections that have not been written yet;
there is no need to clutter a reader's life with those useless things.

Suppress the "Contents" page for HTML; it is not needed for small documents
in the online environment since LaTeX2HTML generates lots of tables of links
anyway.

Various markup consistency nits.
2001-03-01 18:37:52 +00:00
Fred Drake
a09262e860 Comment out section titles for sections that have not been written yet;
there is no need to clutter a reader's life with those useless things.

Make the snippets of Python code conform to the standard style.

Suppress the "Contents" page for HTML; it is not needed for small documents
in the online environment since LaTeX2HTML generates lots of tables of links
anyway.

Various markup consistency nits.
2001-03-01 18:35:43 +00:00
Guido van Rossum
f89ad5ed6b Document configuration flags to compile for large file support on
certain Linux systems.
2001-03-01 18:29:57 +00:00
Moshe Zadka
8a18e99008 Checking in patch 404826 -- urllib2 enhancements and documentations.
(please not that the library reference does *not* include the
urllib2 documnetation -- that will wiat for Fred)
2001-03-01 08:40:42 +00:00
Fred Drake
baee0d42c9 Bump the release number to 2.1b1. 2001-03-01 06:01:20 +00:00
Andrew M. Kuchling
694e1816c2 Fix markup nit pointed out by FLD 2001-03-01 01:02:52 +00:00
Guido van Rossum
1874c8f23b Document PyErr_WarnExplicit(). 2001-02-28 23:46:44 +00:00
Guido van Rossum
56ba72a563 Document warn_explicit(). 2001-02-28 23:34:21 +00:00
Fred Drake
7840a9cb99 Add entry for the inspect module. 2001-02-28 23:02:20 +00:00
Fred Drake
6dbd382ec8 Clean up some of the markup for consistency, wrap some long lines. 2001-02-28 23:01:38 +00:00
Fred Drake
bca60c07b3 Fix some rules broken by typos, others by the flattening of the makefile. 2001-02-28 22:59:37 +00:00
Andrew M. Kuchling
8bad993dd3 Add description of PEP235
Remove references to 2.1alpha
Update description of PEP229
2001-02-28 22:39:15 +00:00
Andrew M. Kuchling
74d18ed076 Cover pydoc
Update reference Python version to beta1
Rip out PEP 232 section
Add placeholders for PEP 236 and 235
Fix erroneous \filename references
2001-02-28 22:22:40 +00:00
Andrew M. Kuchling
bf140147d8 Document the object allocator
Minor sentence change
2001-02-28 22:10:07 +00:00
Skip Montanaro
58177b9975 added description of NL token 2001-02-28 22:05:41 +00:00
Fred Drake
969ab2710a Update documentation for termios module; do not refer to the TERMIOS module
for constant definitions.

Add a deprecation to the TERMIOS module.
2001-02-27 22:01:15 +00:00
Martin v. Löwis
5e1633365d Patch #403985: Add support for weak-keyed dictionaries 2001-02-27 18:36:56 +00:00
Ka-Ping Yee
6397c7c9a9 inspect: a module for getting information out of live Python objects 2001-02-27 14:43:21 +00:00
Barry Warsaw
7a5e80e801 Updates to describe function attributes. 2001-02-27 03:36:30 +00:00
Barry Warsaw
d4614e8371 Updates to the semantics of function and method attributes. 2001-02-27 03:32:35 +00:00
Fred Drake
07e6c505ad Minor adjustments, including markup corrections. 2001-02-23 19:15:56 +00:00
Fred Drake
447f545322 Fix extra backslash in example. 2001-02-23 19:13:07 +00:00
Fred Drake
3538c93f1a Another name. 2001-02-23 19:11:45 +00:00
Fred Drake
afdc8fc0ad Fix up the markup in some recently-added portions of the text. 2001-02-23 19:10:41 +00:00
Fred Drake
19f3c52347 Work around the broken formatting of sys.ps1 prompts in running text.
Move sample sessions to the left margin of the file for consistency;
formatting can adjust the margin if needed.

This closes SF bug #133213.
2001-02-22 23:15:05 +00:00
Fred Drake
2f55b11bf7 cd to the html/ directory to generate the global module index so the links
to the module sections are right.

This was also broken when converting to a flat Makefile.
2001-02-22 23:12:37 +00:00
Fred Drake
d27ed858c3 The ACKS file is in the current directory when converted to HTML; this was
broken when converting to a flat Makefile.  ;-(
2001-02-22 23:06:21 +00:00
Fred Drake
cb45bfd956 Remove entry for soundex module! 2001-02-22 23:00:20 +00:00
Fred Drake
230d17d0d1 Sequence indexes are non-negative, not natural (0 is not a natural number).
Reported by Daniel May <mayds@ecn.purdue.edu>.

De-tabified everywhere.
2001-02-22 21:28:04 +00:00
Fred Drake
7c30de65f4 Remove documentation for the soundex module; the module is no longer
included with Python.
2001-02-22 21:25:20 +00:00
Martin v. Löwis
7edbd4ffb4 Patch #103885: Add dynamic registration and lookup of DOM implementations. 2001-02-22 14:05:50 +00:00
Tim Peters
754ba589b7 Improve accuracy. In the .tex file, note the new "% BUG:" comments: an
extra backslash is getting displayed in the generated HTML.
2001-02-20 11:24:35 +00:00
Tim Peters
f0768c822b Added missing \item. See also bug 133213, about damaged HTML generated
for \code(">>>"); don't know how to fix that one.
2001-02-20 10:57:30 +00:00
Tim Peters
e79af273e8 Flesh out PlaySound() docs enough so that SND_ALIAS isn't hopelessly confusing.
If someone knows how to turn the new table of guaranteed-registered system
sounds into a LaTeX table, be my guest.
2001-02-20 10:02:21 +00:00
Fred Drake
5b0705d266 ConfigParser.optionxform(): Document this since it is available for
sub-classes and application code to override.
2001-02-19 22:37:24 +00:00
Fred Drake
f6a9617ba0 Michael Hudson <mwh21@cam.ac.uk>:
New material on defining extension types.  Thanks!

(Small markup adjustments made, but this is mostly as received.)
2001-02-19 19:22:00 +00:00
Fred Drake
842ab38d3d No longer needed since the main Makefile is "flat". 2001-02-19 19:20:17 +00:00
Fred Drake
f6bfe8e342 Convert to a "flat" Makefile. 2001-02-19 19:19:26 +00:00
Fred Drake
50d1fcf61c Add an option allowing the user to determine where the output HTML is built.
Provide a way to set the paper size by name instead of only supporting
separate options for each size.
2001-02-19 19:18:09 +00:00
Fred Drake
f2502adfc1 Fix markup so this document will format. 2001-02-19 19:14:50 +00:00
Fred Drake
c07012360e This never saw much use, so remove it. 2001-02-19 19:11:12 +00:00
Fred Drake
653809c122 Make the top-level index.html depend on the individual document index.html
files so that the date is properly updated on the front page.
2001-02-19 17:52:07 +00:00
Thomas Heller
5f52f7230c Checked in with Andrew's blessing, I leave the comments with which
this was posted to distutils-sig in.

Here is what I've hacked together over some spare time
at the weekend. I would appreciate feedback, as I've told
before I'm neither a great author, nor native english speaker,
nor anything else.

Mostly I've completed (and written) docs for bdist_wininst
(where I'm an experert for), also I've started some stuff
for the data_files and scripts option.

Should I continue in this way? Would others like to jump in?
2001-02-19 17:48:03 +00:00
Fred Drake
15bc404ca8 Added entries for difflib documentation. 2001-02-19 16:32:40 +00:00
Fred Drake
baf71422b8 Documentation for the difflib module, converted from the module docstrings. 2001-02-19 16:31:02 +00:00
Tim Peters
373d151666 More typos. libwinsound.tex typo noted by Peter Funk (thanks!). 2001-02-19 08:36:41 +00:00
Tim Peters
25a9ce371c Take a tour of hell's seedier neighborhoods to try to make winsound.Beep()
do something non-useless on Win9X boxes.  WinME unknown to me.  Someone with
NT/2000 make sure it still works there!
2001-02-19 07:06:36 +00:00
Tim Peters
c4089d84d8 In the example showing the irrelevance of start columns, restore that the
start columns differ (editing had pushed them all into column 0).
2001-02-17 18:03:25 +00:00
Fred Drake
f3262b72ca Add entries for the doctest documentation. 2001-02-17 17:33:25 +00:00
Fred Drake
7eb1463bb3 Make a variety of minor markup adjustments.
Close some environments so that this will actually format.
2001-02-17 17:32:41 +00:00
Tim Peters
7688229f7c SF patch #103808: doctest.py docs
Checking in Moshe's patch after rewrapping some paragraphs (to consume
fewer columns) and repairing that I/2.**J lost the I.
2001-02-17 05:58:44 +00:00
Andrew M. Kuchling
30537da0ec Fix typo
Makefile.pre.in was added in 1.4
2001-02-17 00:42:56 +00:00
Andrew M. Kuchling
da23c4fef9 Fix two typos, and add some omitted \option{} markup 2001-02-17 00:38:48 +00:00
Skip Montanaro
04f1d37471 mention the use of the maxtries attribute of FancyURLopener in bounding
redirection recursion.
2001-02-15 17:00:40 +00:00
Guido van Rossum
bf416fa0dd Document default blocksize for storbinary(). 2001-02-15 13:53:40 +00:00
Fred Drake
523ec5709b Make some clarifications and corrections based on comments from Guido.
Fix a few markup nits.
Work around a LaTeX2HTML nuisance.
2001-02-15 05:37:51 +00:00
Fred Drake
e4f1c3276a Be more careful to avoid spurious output from the shell script that
unpacks the development version of the docs on SF.
2001-02-14 21:26:31 +00:00
Fred Drake
8bcc4e8446 Commit this so CVS doesn't keep noticing the next version number. 2001-02-14 20:53:07 +00:00
Fred Drake
15862f50e5 Add a note to Node.isSameNode() that it is based on the DOM Level 3 working
draft.  I'm not sure that's important, but Uche thinks it is.
2001-02-14 20:39:15 +00:00
Fred Drake
1d8ad2b1de Updated to reflect the additional information and interfaces exported in
pyexpat.c revision 2.40.
2001-02-14 18:54:32 +00:00
Tim Peters
7530208d8b Feeble attempt to repair obsolete info about hex escapes. 2001-02-14 04:03:51 +00:00
Fred Drake
162c6a637a Reflect change in traceback format:
"innermost last" --> "most recent call last"
2001-02-14 03:20:18 +00:00
Andrew M. Kuchling
15ad28cf89 Finished the section on weak references
Mentioned doctest, difflib, sys._getframe(), and the change to use
   PyImport_ImportModule() everywhere in C code
No more XXX!
2001-02-14 02:44:18 +00:00
Andrew M. Kuchling
e7d7e6c879 Fix two typos 2001-02-14 02:39:11 +00:00
Ka-Ping Yee
5401996638 Update to properly explain that the default Unicode encoding is ASCII, &c. 2001-02-13 22:20:22 +00:00
Fred Drake
498cb15306 Jon Nelson <jnelson@users.sourceforge.net>:
Make the documentation tools work with Python 1.5.2.
[Slightly modified from submitted patch. --FLD]

This closes SF bug #132005.
2001-02-12 19:12:55 +00:00
Fred Drake
a05460c148 PyTuple_*() functions take PyObject* parameters, not PyTupleObject* values.
This closes SF bug #131304.
2001-02-12 17:38:18 +00:00
Fred Drake
e38d481e77 Add a "description" meta tag that includes a version number. 2001-02-12 16:04:24 +00:00
Fred Drake
b258bedb13 Jon Nelson <jnelson@users.sourceforge.net>:
Make the documentation tools compatibile with Python 2.0.
2001-02-12 15:30:22 +00:00
Andrew M. Kuchling
81b6ae7ef7 Create separate section for changes to the standard library
Make note about difflib and doctest
Bump version number
2001-02-11 16:55:39 +00:00
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
Andrew M. Kuchling
6a360bd3a7 Wrote section on nested scopes, and moved it to the front
Began a section on weak references
Various rewrites and paragraph refills
Added: non-recursive makefiles, repr() of strings now uses \n, raw socket I/O
Bumped version number
2001-02-05 02:47:52 +00:00
Fred Drake
4e3f2752c5 Improve diagnostic output when an external command returns a non-zero exit
code, showing the transcript for that command.

This closes SF bug #129740.
2001-02-04 15:20:26 +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
f0e08ef9cb Remove an now-false statement about there being only one type flag
defined.
2001-02-03 01:11:26 +00:00
Fred Drake
24da47708d Do not pass names of individual files to shutil.rmtree(); use os.unlink()
for that.
2001-02-02 15:48:00 +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
667c9e46ca Minor markup adjustments.
Move some index entries next to what they are referring to for better
"targetting".
2001-02-02 02:43:18 +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
Jeremy Hylton
3faa52ecc4 Allow 'continue' inside 'try' clause
SF patch 102989 by Thomas Wouters
2001-02-01 22:48:12 +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
c2e35e6f37 Remove spurious "\end{description}" that caused formatting to fail. 2001-02-01 15:37:56 +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
0d0e64861b Add entry for weakref documentation. 2001-02-01 05:20:52 +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
Jeremy Hylton
0eb107068a update section 4.1 to describe nested scopes 2001-02-01 03:50:59 +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
Fred Drake
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
Jeremy Hylton
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
Andrew M. Kuchling
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
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
Fred Drake
5838d0fc84 Document the PyInstance_*() functions and data. 2001-01-28 06:39:35 +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
Fred Drake
2f4453af6a Typo: coplete --> complete
This closes SF bug #129759.
2001-01-26 15:27: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
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
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
Fred Drake
cf069da57d Update link to LaTeX2HTML web site. 2001-01-25 17:25:28 +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
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
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
Andrew M. Kuchling
1ae43c4341 Add names of people who've pointed out broken links and images
Bump version number
2001-01-24 01:11:26 +00:00
Andrew M. Kuchling
d975196d57 Fredrik pointed out that the database shrank more than 55K 2001-01-24 00:52:56 +00:00
Andrew M. Kuchling
26e94a8822 Jeremy didn't write PEP 205, Fred did! 2001-01-23 15:21:05 +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
Andrew M. Kuchling
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
Fred Drake
da6daee439 A variety of updates of out-of-date information. 2001-01-22 21:38:09 +00:00
Fred Drake
bc3974c03b When generating the source package, copy in the LICENSE file from the main
source directory.
2001-01-22 21:34:20 +00:00
Fred Drake
9c3b9b76c1 Never mind ignoring a copied LICENSE file; let's do this another way. 2001-01-22 21:31:38 +00:00
Fred Drake
e94b9f9d3c Ignore the generated LICENSE file needed for the documentation source
package.
2001-01-22 21:07:36 +00:00
Fred Drake
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
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
Andrew M. Kuchling
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
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
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
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
Andrew M. Kuchling
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
Fred Drake
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
Fred Drake
0a8690a0ad Make "PythonLabs" bold. 2001-01-22 17:48:23 +00:00
Fred Drake
c8e8281fb6 Updated note about collection of cyclic garbage, based on comments from
Chris Ryland.
2001-01-22 17:46:18 +00:00
Fred Drake
ef8cd7ca99 Minor markup adjustment. 2001-01-22 17:42:32 +00:00
Fred Drake
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
Andrew M. Kuchling
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
Andrew M. Kuchling
90cecee894 Beginning of a "What's New in Python 2.1" article 2001-01-22 04:02:09 +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
Fred Drake
5566c1ce36 Fixed a bunch of typos caught by Gilles Civario. 2001-01-19 22:48:33 +00:00
Fred Drake
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
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
Guido van Rossum
ab782dd6cc Document rich comparisons. 2001-01-18 15:17:06 +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
a544ea2354 Undoing the whitespace patches which sneaked into the earlier patch. 2001-01-17 18:04:31 +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