Commit Graph

2415 Commits

Author SHA1 Message Date
Fred Drake 812860e81d Hack places where '--' should appear as literal output but the -- was
(properly) converted to - by LaTeX2HTML.
1999-04-23 14:46:18 +00:00
Fred Drake d960dc81b5 Fix square brackets around optional parameters to macros. 1999-04-23 14:44:53 +00:00
Fred Drake 7a737dffc4 General small improvements and fixes. 1999-04-23 14:41:44 +00:00
Fred Drake ffbe68723a Make internal module references hyperlinks wherever it makes sense. 1999-04-22 21:23:22 +00:00
Fred Drake 7b8b125fa6 Remove bogus characters in code sample. 1999-04-22 21:19:53 +00:00
Fred Drake fcf94d4edd Work around LaTeX2HTML comment-handling bug. 1999-04-22 20:55:59 +00:00
Fred Drake 4a406c619b Shorten the section title. 1999-04-22 20:52:44 +00:00
Fred Drake c4a623ebdc Add command line flags to just list the files that contain the
offending lines or to include line numbers in the output.
1999-04-22 20:32:21 +00:00
Fred Drake c8c40ff699 Added a "See also" section with some external references. 1999-04-22 20:16:02 +00:00
Fred Drake 4e28c593ad Markup nits.
Make module references hyperlinks.
1999-04-22 18:25:47 +00:00
Fred Drake b7168c3a07 Clean up lots of mark up. 1999-04-22 17:53:37 +00:00
Fred Drake 79936fe73f Added descriptions of the various exceptions, based on the docstrings.
Various small cleanups.
1999-04-22 17:23:34 +00:00
Fred Drake c8993aad10 Logical markup and small nits.
Don't refer to the STDWIN chapter; chances are really good it wasn't
included.  ;-)
1999-04-22 16:50:40 +00:00
Fred Drake 12a956921f Make some module references hyperlinks. 1999-04-22 16:47:27 +00:00
Fred Drake b774550ba5 Minor logical markup nits.
Make some module references hyperlinks.
1999-04-22 16:46:18 +00:00
Fred Drake dd6c6d9b0a Clean up some mark up. 1999-04-22 16:45:26 +00:00
Fred Drake e2effbd32d Fix minor (English) usage nits. 1999-04-22 16:21:09 +00:00
Fred Drake bcd5454d63 Reference to urllib module can be a hyperlink. 1999-04-22 16:17:45 +00:00
Fred Drake 4429772ea3 Fix dropped space in the HTML output. 1999-04-22 16:15:34 +00:00
Fred Drake babdda53d5 Make reference to the socket module a hyperlink. 1999-04-22 16:03:30 +00:00
Fred Drake bf0f4346af Shorten the section title. 1999-04-22 15:53:35 +00:00
Fred Drake 47894d2858 Don't describe this module as being a popen() wrapper; that's a little
confusing.  This is clearly Unix-specific; label it as such.
1999-04-22 15:19:01 +00:00
Fred Drake a694e00085 Remove \platform declaration; this module is generic. 1999-04-22 15:14:11 +00:00
Fred Drake 5254a6d682 Move stat to the Generic chapter. 1999-04-22 15:01:44 +00:00
Fred Drake ca69a03dd6 Don't refer to the system documentation as "man pages"; too
Unix-centric.  Note that this can be used with the output of
os.fstat() as well as os.stat() and os.lstat().
1999-04-22 14:55:43 +00:00
Fred Drake 7bf96ca32d Make an assertion. 1999-04-22 14:16:59 +00:00
Fred Drake 6532b9b8e0 Updated a comment and the release number. 1999-04-22 14:16:14 +00:00
Fred Drake 2ea30f4d8c Add warning that last() and previous() don't work for hashtable
databases (opened using hashopen()), as noted by Skip Montanaro on
comp.lang.python.
1999-04-22 14:06:36 +00:00
Fred Drake 693a2c6581 Script to locate uses of \module where the module referred to is not
the module being documented at that point in the documentation; these
are candidates for conversion to \refmodule, which produces a
hyperlink in the HTML and PDF versions of the output.
1999-04-22 13:08:09 +00:00
Fred Drake e0208cc83c Add a couple of items. 1999-04-22 13:05:52 +00:00
Fred Drake adade928be Fill in a lot of the blanks. Add a start to the LaTeX primer section.
Use Python-traditional XXX comments instead of square brackets that
aren't as obvious or usefully grepable.
1999-04-22 13:05:27 +00:00
Fred Drake 30a535c0f7 Added support for adding environment/macro parameters more cleanly:
\op adds an optional parameter, and \p adds a required parameter.
These are only defined in the context of the parameter list parameter
of the envdesc and macrodesc environments.
1999-04-22 13:03:49 +00:00
Fred Drake b9f1f6d90b Misc. markup nits.
All sections get reasonable file names in the HTML output.
1999-04-21 21:43:17 +00:00
Fred Drake 2dabd811cd Fix markup typo. 1999-04-21 21:33:24 +00:00
Fred Drake d146edfaf1 Mark the "Notes:" sections under tables the same way it's done
elsewhere in the library reference.
1999-04-21 21:15:35 +00:00
Fred Drake b11d108cdc The version information here was checked good in 1999, not 199. ;-)
Added "See also" reference to zlib home page, even though it's
mentioned in the text.
1999-04-21 18:44:41 +00:00
Fred Drake 2799f9d09a Reflow paragraph to work around LaTeX2HTML dropping a space.
Make all references to the os module hyperlinks.
1999-04-21 18:33:47 +00:00
Fred Drake 6d20caa2ce Reflow paragraph to work around LaTeX2HTML dropping a space. 1999-04-21 18:17:11 +00:00
Fred Drake 543e19d923 Small nits, more hyperlinks.
Added more information for cStringIO.
1999-04-21 18:15:22 +00:00
Fred Drake 048b75bd9a Make references to whrandom hyperlinks. 1999-04-21 18:14:22 +00:00
Fred Drake ec6baaf618 Small markup nits. 1999-04-21 18:13:31 +00:00
Fred Drake 54f2fdd1ad Make the names of the referenced modules hyperlinks; they had not been
marked at all.
1999-04-21 18:10:08 +00:00
Fred Drake 02e8c0fd2d Nits. Reference to signal module becomes a hyperlink. 1999-04-21 18:01:14 +00:00
Fred Drake 283c588402 Work around LaTeX2HTML comment-handling bug. 1999-04-21 17:57:15 +00:00
Fred Drake 318c0b131f Logical markup nits.
Make references to other modules hyperlinks.
1999-04-21 17:29:14 +00:00
Fred Drake c3845a14d3 Logical markup & other small nits. 1999-04-21 17:18:04 +00:00
Fred Drake 11bc8cfee3 Explain *why* the copytree() implementation is presented as the
example!
1999-04-21 17:08:51 +00:00
Fred Drake e688aec707 Textual references to the glob module can be hyperlinks. 1999-04-21 17:04:43 +00:00
Fred Drake 737aa552f4 Markup nit to fixed dropped space in HTML output. 1999-04-21 17:01:15 +00:00
Fred Drake 4747f7f61d Markup nits. 1999-04-21 16:41:40 +00:00
Fred Drake 4f6e4fbc1d Added "See also" reference to xdrlib.
Markup nits.
1999-04-21 16:38:53 +00:00
Fred Drake 69fa56327a Markup nits. 1999-04-21 16:29:57 +00:00
Fred Drake 8307e21a2a Mark the references to module names use \module or \refmodule (the
closing paragraph used \code).
1999-04-21 16:29:18 +00:00
Guido van Rossum 6ed122a334 Important fix mentioned by The Dragon De Monsyne: the sendmail()
method does _not_ disconnect the connection when it throws a
SMTPHeloError!
1999-04-21 16:19:16 +00:00
Fred Drake a889add5d6 Oops; minor nit in example: none of the other interactive examples
show the "trailing" prompt, so don't show it here!
1999-04-21 16:00:24 +00:00
Fred Drake ca675e491b do_cmd_funcline(): Remove some bogus generated stuff from the output
(some text was only intended for the index).
1999-04-21 15:58:58 +00:00
Fred Drake 3d815bd1c7 Added link to xdrlib module in "See also" section. 1999-04-21 15:57:29 +00:00
Fred Drake 085b8121eb Fix some remaining index & consistency nits. (Many data member
references were being omitted from the general index.)
1999-04-21 14:00:29 +00:00
Fred Drake c3fcd6fa0e Added index entry for "file objects"; this is appearantly referenced
somewhere in the Reference Manual, and someone tried to locate it via
the index.  Report on the omission by Stefan Franke
<sfranke@cdc-group.com>.
1999-04-21 13:58:17 +00:00
Fred Drake 7ceb5777d7 Added doc for the "module" attribute on the class descriptor objects;
omission repoorted by Glyn Webster <glyn@ninz.org.nz>.
1999-04-20 18:18:53 +00:00
Fred Drake ad56dafd62 Added example use of pack_list() to help explain the pack_item
parameter.  Lack of clarity reported by Matthew Gallagher
<hew@hons.cs.usyd.edu.au>.
1999-04-20 13:41:14 +00:00
Fred Drake 4ae52694c9 Updated to reflect additions. 1999-04-19 21:21:28 +00:00
Fred Drake 32c562bdec colorsys docs from David Ascher. 1999-04-19 21:20:13 +00:00
Fred Drake 9d15881744 bsddb docs from Skip Montanaro; added interesting links. 1999-04-19 21:19:21 +00:00
Fred Drake e9af64c373 Remove superfluous index entry for posix.popen(); no longer
appropriate since popen() is only documented in os.
1999-04-16 19:00:48 +00:00
Fred Drake dac9a4e3db Added link to Fredrik Lundh's online Tkinter reference material. 1999-04-16 18:26:22 +00:00
Fred Drake 31bfbc6bff Minor nits, include author info. 1999-04-16 14:03:32 +00:00
Fred Drake 511281ac00 In list of sequence comparison examples, "=" should be "==". Reported
by Mirko Liss <n89553@hrz.uni-paderborn.de>.
1999-04-16 13:17:04 +00:00
Fred Drake 0ebd5483be Removed dbhash from the undocumented list. 1999-04-15 16:05:29 +00:00
Fred Drake 460f1dd6b7 Add libdbhash.tex. 1999-04-15 15:12:37 +00:00
Fred Drake 666255f5ac Document the dbhash module, and link to it from appropriate places. 1999-04-15 15:11:40 +00:00
Fred Drake f4cbada3f9 Correct documentation for <file>.read(); Python makes a serious
best-effort to return 'size' bytes.  Point out that this may mean
multiple fread() calls.  Reported by Anders Hammarquist
<iko@iko.pp.se> via the Debian crew.
1999-04-14 14:31:53 +00:00
Fred Drake e79f5c1d2b Use the standard stylesheet here as well. 1999-04-14 14:28:48 +00:00
Fred Drake 6ab98325f7 Use the tools/mkdvi.sh script to generate DVI and PDF output for the
library reference now that it's sufficiently capable.
1999-04-14 14:04:39 +00:00
Fred Drake c260c0bcdb Further refinement, to allow this to handle the library reference as
well as the other "manual" documents.
1999-04-14 13:13:32 +00:00
Fred Drake 011f6fca31 Typo: "Otherwose" --> "Otherwise" (reported by Joakim Sernbrant
<joakim.sernbrant@front.se>).

Misc. small fixes to the logical markup.
1999-04-14 12:52:14 +00:00
Fred Drake 79d41ccdd3 Add some support for the module index, so this can be used to build
the .aux file for any of the "manual" class documents.
1999-04-14 05:02:06 +00:00
Fred Drake 7a64b355c1 For now, comment out the \ignorePlatformAnnotation; the global index
doesn't really work with this.
1999-04-13 22:19:21 +00:00
Fred Drake 9444df0844 Don't include the verbatim style; the default handling is better. 1999-04-13 22:17:55 +00:00
Fred Drake 1cc5899742 Fix problem of LaTeX leakage in the module synopsis tables at the
beginning of chapters.  Known problem reported by Barry Scott
<barry@scottb.demon.co.uk>.
1999-04-13 22:08:59 +00:00
Fred Drake e331356ff7 Fix availability declaration for popen2 module; report by Barry Scott
<barry@scottb.demon.co.uk>.
1999-04-13 22:03:26 +00:00
Fred Drake b9971b9964 Minor cleanup. 1999-04-13 21:39:31 +00:00
Fred Drake 592dd78408 Fix availability declaration for stat module; report by Barry Scott
<barry@scottb.demon.co.uk>.
1999-04-13 21:38:02 +00:00
Fred Drake 31ec33ed60 Work around problems with HTML conversion by making the break and
tbreak synopses be all on one line (each).  Known problem, most
recently reported by Barry Scott <barry@scottb.demon.co.uk>.
1999-04-13 21:36:44 +00:00
Fred Drake cc10e0469a Just in case a copy of the documentation gets released somehow... 1999-04-13 21:22:46 +00:00
Fred Drake 07bd1d1b7b Ignore the doc/ directory ("Documenting Python"). 1999-04-12 15:41:44 +00:00
Fred Drake bfb092eb86 Misspellling: "occurance" --> "occurrence" 1999-04-09 19:57:09 +00:00
Fred Drake 2e1094e4ef Use #!/usr/bin/env python instead of #!/usr/local/bin/python. 1999-04-09 14:53:35 +00:00
Guido van Rossum 7969f31c4d Updated documentation by Per Cederqvist. I've added back the
documentation sendmail() to reflect the changes by The Dragon
(see smtplib.py checkin).
1999-04-07 15:56:51 +00:00
Fred Drake 4f21d54764 Added more "See also" entries, + 1 inline hyperlink. 1999-04-05 22:18:12 +00:00
Fred Drake ea003fcc2a Fixed latex2html weirdness with footnotes. 1999-04-05 21:59:15 +00:00
Jeremy Hylton 45b0aeda3c correct version info for zlib.
add note about module failing with old versions of the library.

update comment that explains that this doc is *still* out of date
1999-04-05 21:55:21 +00:00
Fred Drake 93aa0f23a7 Fixed latex2html weirdness with footnotes. 1999-04-05 21:39:17 +00:00
Fred Drake b55ce1e8b6 Fixed latex2html weirdness with footnotes. 1999-04-05 21:32:52 +00:00
Fred Drake 52e2d51ef3 Fixed latex2html weirdness for a footnote. 1999-04-05 21:26:37 +00:00
Fred Drake 9aa8543c84 open() description: Made it more clear that 'b' should always be
added to the mode value for binary files to improve
	portability.

Fixed latex2html weirdness with a couple of footnotes.
1999-04-05 21:22:41 +00:00
Fred Drake 01553706bf Added a few items to the "See also" sections at Guido's prompting. Made
more references to other modules in the text hyperlinks for the HTML and
PDF versions.
1999-04-05 19:46:21 +00:00
Fred Drake 766e0cbde1 Added "doc" target to match the other document-prefix targets. 1999-04-05 19:28:29 +00:00
Fred Drake 50ae47b0de Removed bosities around example code; not sure where that stuff crept
in!
1999-04-05 19:26:16 +00:00
Fred Drake 1dc3a501a6 Made improvements based on changes just made and comments from
Bernhard Reiter <bernhard@csd.uwm.edu>.
1999-04-05 19:00:54 +00:00