aa90adcfb9
Add nested scopes spec to appendix.
...
Add new opcodes LOAD_CLOSURE, LOAD_DEREF, STORE_DEREF, MAKE_CLOSURE to
docs for dis module.
Add docs for new function and code members in Sec. 3 of ref manual.
They're present regardless of whether nested scopes are used.
Remove description of default argument hack from Sec. 7 of the ref
manual and refer the reader to the appendix.
2001-03-23 17:23:50 +00:00
7190247e0b
Remove the annoying __version__ definitions.
2001-03-23 17:09:02 +00:00
3e8f921fb9
Lots of small changes to make this work with the Python DOM bindings
...
(minidom in particular); it was using PyDOM which is now obsolete.
Only write the output file on success -- this avoids updating the timestamp
on the file on failure, which confuses "make".
2001-03-23 17:01:47 +00:00
2262a80fb3
Pick up the "encode" function from esistools instead of defining our own
...
(broken) version.
Remove Conversion.err_write() -- use dbgmsg() consistently.
2001-03-23 16:53:34 +00:00
a9d0450f72
No quotes around the "future" in the first use of the term "future
...
statement".
2001-03-23 16:47:11 +00:00
f6c115ff2f
Re-write to no longer depend on an old version of PyXML. This now
...
implements a SAX XMLReader interface instead of the old Builder interface
used with PyDOM (now obsolete).
This only depends on the standard library, not PyXML.
2001-03-23 16:42:08 +00:00
a4699a71b8
Pick the "escape" function from the standard library instead of from PyXML.
2001-03-23 16:38:12 +00:00
ce19496ec1
Add conversions for more of the markup -- not all of this was around when
...
this file was written!
2001-03-23 16:29:06 +00:00
7621fa9147
Add entry for the futures appendix in the reference manual.
...
Correct the comment at the top of the file.
2001-03-23 16:23:21 +00:00
557c1ae150
Include the futures appendix.
2001-03-23 16:21:15 +00:00
39778b705d
Revise the markup so that this formats and uses markup consistently with
...
the rest of the documentation.
2001-03-23 16:20:46 +00:00
324cc6ee0e
Add some initial text for the appendix on future statements and nested scopes.
2001-03-23 15:29:54 +00:00
2c84fc8a7d
Note that assignments to __debug__ are illegal
2001-03-23 14:34:06 +00:00
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
16a0b17460
Bump version number.
2001-03-23 12:12:05 +00:00
ce7298ab42
Explain the difference between NL and NEWLINE.
2001-03-23 05:22:12 +00:00
c608fb6389
Give a slightly better explanation of excepthook.
2001-03-23 05:17:41 +00:00
5e0dfaccd1
Update to the most recent weakref changes.
2001-03-23 04:36:02 +00:00
ac1abe0bfe
Add a paragraph about obmalloc turning up bugs in extension modules
...
Mention the new ports
2001-03-23 03:52:46 +00:00
ef85cc84a0
Add section for PEP 241
...
Add PyUnit and sys.excepthook
2001-03-23 03:29:08 +00:00
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
6909642d38
Bump the version number.
2001-03-22 17:01:43 +00:00
15e07f4442
Update to the current state of the universe.
2001-03-22 17:00:05 +00:00
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
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
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
f531ad698c
Markup nit: For the Python documents, we use \empt instead of \textit.
2001-03-19 04:19:56 +00:00
b15bbc8d3d
Add documentation for SGMLParser.handle_decl().
2001-03-16 20:39:41 +00:00
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
1b0b2a4df2
Add some LaTeX magic so that Latin-1 characters do not get so badly
...
trashed.
2001-03-13 17:56:08 +00:00
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
45bbda2593
Fix a further markup problem noted by FLD
2001-03-10 16:49:07 +00:00
f0ebbe0bd0
Re-order some method descriptions for a more logical grouping.
...
(Based on reader comment!)
2001-03-08 22:46:41 +00:00
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
859eb62108
Do not refer to "sub-modules" since that is not a defined term.
2001-03-06 07:34:00 +00:00
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
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
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
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
990b0fec1a
Update documentation to reflect the shift to NetrcParseError instead of
...
SyntaxError.
2001-03-06 06:55:18 +00:00
0c8f6643c6
Remove debugging "set -x".
2001-03-03 19:57:26 +00:00
42119e49a9
Fix a few minor markup nits.
2001-03-03 19:47:24 +00:00
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
61af5605fa
Discuss PEP 236.
...
Update nested scope section.
2001-03-03 03:25:04 +00:00
81df7be2a2
Update estimate bug and patch counts
2001-03-02 21:19:38 +00:00
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
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
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
ab357ecf7f
Label classes and exceptions explicitly in the documentation (for their
...
*desc environments).
2001-03-02 18:57:05 +00:00
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
043d5e5514
For copyfile(), be explicit that src and dst are file names; that was only
...
implied.
2001-03-02 16:46:42 +00:00
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
7606e4d00e
Added entry for urllib2 documentation.
2001-03-01 19:54:29 +00:00
8c011580ff
Use larger chunks for the HTML version of the Distutils documentation.
2001-03-01 18:38:56 +00:00
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
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
f89ad5ed6b
Document configuration flags to compile for large file support on
...
certain Linux systems.
2001-03-01 18:29:57 +00:00
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
baee0d42c9
Bump the release number to 2.1b1.
2001-03-01 06:01:20 +00:00
694e1816c2
Fix markup nit pointed out by FLD
2001-03-01 01:02:52 +00:00
1874c8f23b
Document PyErr_WarnExplicit().
2001-02-28 23:46:44 +00:00
56ba72a563
Document warn_explicit().
2001-02-28 23:34:21 +00:00
7840a9cb99
Add entry for the inspect module.
2001-02-28 23:02:20 +00:00
6dbd382ec8
Clean up some of the markup for consistency, wrap some long lines.
2001-02-28 23:01:38 +00:00
bca60c07b3
Fix some rules broken by typos, others by the flattening of the makefile.
2001-02-28 22:59:37 +00:00
8bad993dd3
Add description of PEP235
...
Remove references to 2.1alpha
Update description of PEP229
2001-02-28 22:39:15 +00:00
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
bf140147d8
Document the object allocator
...
Minor sentence change
2001-02-28 22:10:07 +00:00
58177b9975
added description of NL token
2001-02-28 22:05:41 +00:00
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
5e1633365d
Patch #403985 : Add support for weak-keyed dictionaries
2001-02-27 18:36:56 +00:00
6397c7c9a9
inspect: a module for getting information out of live Python objects
2001-02-27 14:43:21 +00:00
7a5e80e801
Updates to describe function attributes.
2001-02-27 03:36:30 +00:00
d4614e8371
Updates to the semantics of function and method attributes.
2001-02-27 03:32:35 +00:00
07e6c505ad
Minor adjustments, including markup corrections.
2001-02-23 19:15:56 +00:00
447f545322
Fix extra backslash in example.
2001-02-23 19:13:07 +00:00
3538c93f1a
Another name.
2001-02-23 19:11:45 +00:00
afdc8fc0ad
Fix up the markup in some recently-added portions of the text.
2001-02-23 19:10:41 +00:00
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
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
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
cb45bfd956
Remove entry for soundex module!
2001-02-22 23:00:20 +00:00
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
7c30de65f4
Remove documentation for the soundex module; the module is no longer
...
included with Python.
2001-02-22 21:25:20 +00:00
7edbd4ffb4
Patch #103885 : Add dynamic registration and lookup of DOM implementations.
2001-02-22 14:05:50 +00:00
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
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
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
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
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
842ab38d3d
No longer needed since the main Makefile is "flat".
2001-02-19 19:20:17 +00:00
f6bfe8e342
Convert to a "flat" Makefile.
2001-02-19 19:19:26 +00:00
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
f2502adfc1
Fix markup so this document will format.
2001-02-19 19:14:50 +00:00
c07012360e
This never saw much use, so remove it.
2001-02-19 19:11:12 +00:00
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
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
15bc404ca8
Added entries for difflib documentation.
2001-02-19 16:32:40 +00:00
baf71422b8
Documentation for the difflib module, converted from the module docstrings.
2001-02-19 16:31:02 +00:00
373d151666
More typos. libwinsound.tex typo noted by Peter Funk (thanks!).
2001-02-19 08:36:41 +00:00
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
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
f3262b72ca
Add entries for the doctest documentation.
2001-02-17 17:33:25 +00:00
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
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
30537da0ec
Fix typo
...
Makefile.pre.in was added in 1.4
2001-02-17 00:42:56 +00:00
da23c4fef9
Fix two typos, and add some omitted \option{} markup
2001-02-17 00:38:48 +00:00
04f1d37471
mention the use of the maxtries attribute of FancyURLopener in bounding
...
redirection recursion.
2001-02-15 17:00:40 +00:00
bf416fa0dd
Document default blocksize for storbinary().
2001-02-15 13:53:40 +00:00
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
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
8bcc4e8446
Commit this so CVS doesn't keep noticing the next version number.
2001-02-14 20:53:07 +00:00
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
1d8ad2b1de
Updated to reflect the additional information and interfaces exported in
...
pyexpat.c revision 2.40.
2001-02-14 18:54:32 +00:00
7530208d8b
Feeble attempt to repair obsolete info about hex escapes.
2001-02-14 04:03:51 +00:00
162c6a637a
Reflect change in traceback format:
...
"innermost last" --> "most recent call last"
2001-02-14 03:20:18 +00:00
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
e7d7e6c879
Fix two typos
2001-02-14 02:39:11 +00:00
5401996638
Update to properly explain that the default Unicode encoding is ASCII, &c.
2001-02-13 22:20:22 +00:00
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
a05460c148
PyTuple_*() functions take PyObject* parameters, not PyTupleObject* values.
...
This closes SF bug #131304 .
2001-02-12 17:38:18 +00:00
e38d481e77
Add a "description" meta tag that includes a version number.
2001-02-12 16:04:24 +00:00
b258bedb13
Jon Nelson <jnelson@users.sourceforge.net>:
...
Make the documentation tools compatibile with Python 2.0.
2001-02-12 15:30:22 +00:00
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
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
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
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
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
40e43bfaf7
Document Node.isSameNode().
2001-02-03 01:20:01 +00:00
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
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
f0e08ef9cb
Remove an now-false statement about there being only one type flag
...
defined.
2001-02-03 01:11:26 +00:00
24da47708d
Do not pass names of individual files to shutil.rmtree(); use os.unlink()
...
for that.
2001-02-02 15:48:00 +00:00
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
57d943ad38
Move the whrandom entry to the "Obsolete Modules" appendix.
2001-02-02 02:45:08 +00:00
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
844bd5b4a9
Minor markup adjustments.
2001-02-02 02:42:31 +00:00
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
3faa52ecc4
Allow 'continue' inside 'try' clause
...
SF patch 102989 by Thomas Wouters
2001-02-01 22:48:12 +00:00
d0946da701
Fix some markup breakage that prevented formatting; re-wrapped a couple of
...
wide paragraphs.
2001-02-01 15:53:24 +00:00
c2e35e6f37
Remove spurious "\end{description}" that caused formatting to fail.
2001-02-01 15:37:56 +00:00
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
0d0e64861b
Add entry for weakref documentation.
2001-02-01 05:20:52 +00:00
ebcf6a8573
Documentation for the weakref module.
2001-02-01 05:20:20 +00:00
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
0eb107068a
update section 4.1 to describe nested scopes
2001-02-01 03:50:59 +00:00
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
Jeremy Hylton
Fred Drake
Ka-Ping Yee
Andrew M. Kuchling
Guido van Rossum
Moshe Zadka
Skip Montanaro
Martin v. Löwis
Barry Warsaw
Tim Peters
Thomas Heller