Fred Drake
b6bdcb23df
Documentation for Just's ColorPicker module, so the Mac OS guys get
...
something out of this documentation release as well. ;-)
2001-04-13 04:49:30 +00:00
Eric S. Raymond
4f3980d3cb
Added a test main to the pstats library that can help you browse profile dumps.
2001-04-13 00:23:01 +00:00
Fred Drake
47f11ce591
Added warning that FancyURLopener prompts the user on the terminal when
...
basic authentication is needed.
Added documentation for FancyURLopener.prompt_user_passwd(), explaining
that subclasses should provide more appropriate behavior for the hosting
environment.
2001-04-12 20:26:49 +00:00
Fred Drake
62a26699c4
Added module synopsis for the chapter summary.
...
Added documentation for TestCase.assertRaises().
Added text for "Mapping concepts to classes", and merged it into the
front matter instead of separating it into a new section.
Removed use of "assert" in examples.
Update the descriptions to reflect further changes from discussions on
the pyunit-interest list.
Added documentation for the defaultTestLoader object and the
TestLoader methods.
Added the assert*() names for the TestCase helper methods.
2001-04-12 19:34:38 +00:00
Fred Drake
e20bd19f86
Convert several \seetext references to \seerfc and \seetitle versions.
...
These format somewhat better and include more semantic information in the
source.
2001-04-12 16:47:17 +00:00
Fred Drake
24e7a29292
Work around the conversion of ">>" and "<<" to guillemets. Reported by
...
Ping on the Doc-SIG mailing list.
2001-04-12 12:37:03 +00:00
Fred Drake
0056a427bb
Added a lot of text from Steve Purcell's HTML documentation.
...
Updated reference material substantially based on discussions on the
pyunit-interest mailing list (not all changes are in the code in CVS
yet).
2001-04-12 04:50:06 +00:00
Fred Drake
c790e08ac1
Use "2.1c1" since that is what Guido used for the Python version number.
2001-04-12 04:34:26 +00:00
Fred Drake
0c14961872
Update to reflect the new string repr -- \n instead of \012. This is the
...
only documentation file that appears to be affected by the change!
2001-04-12 04:26:24 +00:00
Fred Drake
9ad526fac3
Markup nit: use \envvar to mark environment variables.
2001-04-12 04:11:21 +00:00
Fred Drake
e0197bfaeb
When forming the <A> tag for a \seepep or \seerfc, make sure we strip
...
HTML markup from the string used as the title in the TITLE attribute.
This fixes formatting in the "What's New in Python 2.1" document.
2001-04-12 04:03:22 +00:00
Andrew M. Kuchling
db7657d4e0
Explain popitem()
...
Add Unixware 7 port
Ready for RC1
Minor rewrites
2001-04-12 03:37:19 +00:00
Fred Drake
b942c2f788
Fixed bug in example.
...
This closes SF bug #415522 .
Also fix markup error in text following the example.
2001-04-11 21:33:47 +00:00
Barry Warsaw
c3cbbaf513
Added some additional documentation describing how BabylMailbox
...
actually works (it returns a message containing the visible headers,
not the original headers). Doc change approved by Fred; closes SF bug
#412230 .
2001-04-11 20:12:33 +00:00
Fred Drake
eedf985056
Include a synopsis for the chapter overview.
2001-04-11 19:17:11 +00:00
Moshe Zadka
2bd0d88360
Fixing bug 405999 -- clarifying differences between Python's
...
getopt and GNU getopt -- Python is like classical UNIX getopt.
2001-04-11 07:33:08 +00:00
Fred Drake
5d6e402e0c
Based on a comment by Konrad Hinsen on python-list:
...
Change "EOF" to "end-of-file", on the premise that it is easier for
new programmers to understand (at least a little).
This does not attempt to explain "file or device attached to standard
input."
2001-04-11 04:38:34 +00:00
Fred Drake
29be70195a
Added definition of "test fixture".
...
Added description of optional parameter to the TestSuite constructor.
Added descriptions of the TestLoader and TextTestRunner classes.
Added method descriptions for the TestCase class.
2001-04-10 22:25:06 +00:00
Fred Drake
8875c86a12
Typo: "BuildApple" --> "BuildApplet"
...
Added reference to the webbrowser module from the nsremote description.
2001-04-10 20:32:16 +00:00
Fred Drake
c5287ac66a
Bump version numbers for upcoming release candidate.
2001-04-10 20:19:25 +00:00
Fred Drake
20931fb3f4
Update the XML conversion specification.
2001-04-10 19:59:31 +00:00
Fred Drake
ac154a17a3
Remove the mapping() function from the documentation.
...
Add a description of the ReferenceError exception.
2001-04-10 19:57:58 +00:00
Fred Drake
da00cda9fa
Add note that difflib was added in Python 2.1.
2001-04-10 19:56:09 +00:00
Fred Drake
cfac6d23fd
Normalize tabs to spaces.
...
Update the attribution for the "Curses Programming with Python" How-To.
Change the way the reference to the Demo/curses/ directory is marked up.
2001-04-10 18:49:09 +00:00
Fred Drake
6fda3ac474
Add reference to the DDJ article discussing a similar algorithm.
2001-04-10 18:41:16 +00:00
Fred Drake
86333606f6
Add corresponding support for the alltt environment to the HTML generator.
2001-04-10 17:13:39 +00:00
Fred Drake
b5309a956e
Import the alltt package and wrap that environment in a similar way to
...
the way we handle verbatim, so that it picks up the same indentation and
minipage behavior.
2001-04-10 15:53:06 +00:00
Fred Drake
90a72f8dcd
Add documentation for getmoduleinfo() and getmodulename().
2001-04-10 15:12:34 +00:00
Fred Drake
697c9c9c71
In the typeset versions, the legal notices had grown past the one-page
...
size. This constrains them to fit in one page again.
2001-04-10 05:26:29 +00:00
Fred Drake
819815abea
Fix typo in example (\b should be \n in string literal).
...
This closes SF bug #414279 .
2001-04-09 15:57:06 +00:00
Fred Drake
9c846366ee
Fix a number of bugs and omissions in the AddressList documentation, most
...
noted by Steve Holden.
This closes SF bug #413876 .
2001-04-09 15:42:56 +00:00
Greg Stein
4d4d0034c0
Correct the documentation for getreadbufferproc and getwritebufferproc.
...
Fixes bug #233308 from Travis Oliphant.
2001-04-07 16:14:49 +00:00
Fred Drake
501d90471d
Add entry for unittest documentation.
2001-04-07 05:42:14 +00:00
Fred Drake
b9ad228798
Start of documentation for the unittest module. Some of this comes from
...
Steve Purcell's documentation, and a lot of it is written based on
using PyUnit and reading the implementation.
There is more to come, but I want to get this check in before I have a
disk crash or anything else bad happens.
2001-04-07 05:41:39 +00:00
Fred Drake
4cf1227e56
Change {\em ...} to \emph{...} for consistency with the rest of the Python
...
documentation.
2001-04-05 18:31:27 +00:00
Fred Drake
f459d852e5
Add some information about what to expect of the DocumentType's
...
.internalSubset attribute based on a clarification from the www-dom
list.
2001-04-05 18:30:04 +00:00
Fred Drake
c6a3cb4baf
Document PySequence_Size(), and describe PySequence_Length() as simply an
...
alternate name for the same function.
2001-04-04 01:25:17 +00:00
Fred Drake
979d041b6f
Make reference to the Library Reference in the "What Now?" chapter a
...
hyperlink.
Fix two English usage errors caught by Jan Wells: Changed "subsequence"
to "sub-sequence" in two places, and avoid improper use of "hopefully" in
the first paragraph of the "What Now?" chapter.
2001-04-03 17:41:56 +00:00
Fred Drake
c81d470648
Allow the <author/> element to appear before a paragraph without being
...
made a part of the paragraph.
2001-03-29 23:31:22 +00:00
Fred Drake
659f377ed9
Add entry for curses.panel documentation.
2001-03-29 22:23:19 +00:00
Fred Drake
14631f674f
Fix serious markup errors.
2001-03-29 22:22:23 +00:00
Fred Drake
c612a14e9e
Remove the spurious space of uncertain origin from the output for function,
...
method and constructor signatures. Suggested by Peter Funk on the Doc-SIG
mailing list.
2001-03-29 18:24:08 +00:00
Fred Drake
cb83988151
Added example use of weak references, contributed by Tim Peters.
2001-03-28 21:15:41 +00:00
Fred Drake
58c8f9f631
Added documentation for PyObject_IsInstance() and PyObject_IsSubclass().
2001-03-28 21:14:32 +00:00
Fred Drake
e2645775d1
Typo: "ariables" --> "variables"
...
This fixes SF bug #411118 .
2001-03-28 16:55:53 +00:00
Fred Drake
2bbc6974d0
Fix a number of small issues; this closes SF bug #411063 .
2001-03-28 16:51:20 +00:00
Fred Drake
21e036ccca
Add a note that the "kfm" controller supports "konqueror" as well as the
...
old KDE 1 "kfm" command.
2001-03-26 16:17:21 +00:00
Andrew M. Kuchling
4240bc50f6
Note missing explanation
2001-03-26 13:34:53 +00:00
Guido van Rossum
c8da0f966f
Document use_rawinput. (Although now that I think more about it, a
...
better solution would have been to factor out the raw_input() call and
make it into an overridable method. Oh well, maybe later...)
2001-03-24 19:17:35 +00:00
Fred Drake
8f6df46d40
Strengthen the constraints on calling PyObject_GC_Fini().
2001-03-23 17:42:09 +00:00
Jeremy Hylton
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
Fred Drake
7190247e0b
Remove the annoying __version__ definitions.
2001-03-23 17:09:02 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
a9d0450f72
No quotes around the "future" in the first use of the term "future
...
statement".
2001-03-23 16:47:11 +00:00
Fred Drake
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
Fred Drake
a4699a71b8
Pick the "escape" function from the standard library instead of from PyXML.
2001-03-23 16:38:12 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
557c1ae150
Include the futures appendix.
2001-03-23 16:21:15 +00:00
Fred Drake
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
Jeremy Hylton
324cc6ee0e
Add some initial text for the appendix on future statements and nested scopes.
2001-03-23 15:29:54 +00:00
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