Commit Graph

3831 Commits

Author SHA1 Message Date
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