Commit Graph

1618 Commits

Author SHA1 Message Date
Fred Drake 390636382a Typo: "Availabilty" --> "Availability"
Thanks to /F!
1999-02-26 14:05:02 +00:00
Fred Drake 51027c4173 Added note about comments, from Christopher Petrilli. 1999-02-24 22:36:44 +00:00
Fred Drake 16e81f4484 Update some of the top comments and shorten title of the first
section.
1999-02-24 19:57:14 +00:00
Barry Warsaw f2b4554403 Document the correct class hierarchy for SystemExit. It is not an
error and so it derives from Exception and not SystemError.
1999-02-24 00:27:14 +00:00
Fred Drake 1ec71cb556 Incorporated updates to describe geturl() by Sjoerd Mullender
<Sjoerd.Mullender@cwi.nl>.
1999-02-22 22:42:14 +00:00
Fred Drake 00a3a65cc0 Refer to the right RFC in the intro. 1999-02-22 17:12:42 +00:00
Fred Drake 7d9b13325d Other chapter titles refer to collections of modules as "Services"; do
the same here.
1999-02-22 14:48:00 +00:00
Fred Drake fab41f1788 BabylMailbox description: Properly escape the backslashes in the
string representations.
1999-02-22 14:26:16 +00:00
Fred Drake b63e77ccb0 Oops, used a \label twice - fix one of them. 1999-02-22 14:14:48 +00:00
Fred Drake 180b68b3cf More reasonable section titles. 1999-02-22 13:45:09 +00:00
Fred Drake 76991ec75a Shorten section title. 1999-02-20 05:20:49 +00:00
Fred Drake 199b79c37b Added descriptions for BabylMailbox and Maildir (Qmail) mailbox
objects.
1999-02-20 05:04:59 +00:00
Fred Drake 67d229ea76 Shorten section title. 1999-02-20 04:51:16 +00:00
Fred Drake bbac43223c Shorten a few section titles. 1999-02-20 00:14:17 +00:00
Fred Drake da57365337 Give subsections reasonable file names in the HTML. 1999-02-19 23:48:05 +00:00
Fred Drake 342501142d Added an index entry. 1999-02-19 23:45:06 +00:00
Fred Drake 56f8185a53 Shortened the short synopsis -- too long. 1999-02-19 22:59:56 +00:00
Fred Drake 9f03380d1c Use more current approach to recording authors. 1999-02-19 22:56:08 +00:00
Fred Drake c60047575d Shortened the short synopsis -- way too long. 1999-02-19 22:33:51 +00:00
Fred Drake d8a41e6391 Fix an amazing number of typos & malformed sentences reported by Detlef
Lannert <lannert@uni-duesseldorf.de>.
1999-02-19 17:54:10 +00:00
Fred Drake f6346345b0 Noted that the module was added in 1.5.2. 1999-02-19 15:46:38 +00:00
Fred Drake 4e7c205470 Update description of what modules "look like" when printed. 1999-02-19 15:30:25 +00:00
Fred Drake cd71aa2a38 Use current approach to record documentation author. 1999-02-18 21:13:03 +00:00
Fred Drake 2a2f1fe4d5 Record module & documentation author. 1999-02-18 21:10:32 +00:00
Fred Drake 6b103f1e12 Documentation for pyclbr and tokenize modules. 1999-02-18 21:06:50 +00:00
Fred Drake 4d358b5d23 Added sections for pyclbr and tokenize. 1999-02-18 20:40:26 +00:00
Fred Drake 7c829b3179 Remove the "Parsing Python" section. Hurray! 1999-02-18 20:39:44 +00:00
Fred Drake 70a66c9d6d Add notes to __builtin__.float() and string.atof() that the NaN and Inf
results are possible but non-portable.
1999-02-18 16:08:36 +00:00
Fred Drake 951eea4733 atof() description: Add information about accepting 'NaN' to produce
the NaN value.
1999-02-18 03:49:20 +00:00
Fred Drake 85a59dd68b The _O_* constants are defined as O_* in the os module. 1999-02-16 19:41:01 +00:00
Fred Drake 9329e5ec75 Remove "_" from the P_* symbols used with the spawn*() functions. 1999-02-16 19:40:19 +00:00
Fred Drake c7b72dbbca Added chapter on Windows modules, including msvcrt and winsound. 1999-02-16 19:18:38 +00:00
Fred Drake aa1afa8d30 Added availability notes for samefile(), sameopenfile(), samestat()
since these are not available on Windows.
1999-02-15 16:34:00 +00:00
Fred Drake 9474d86242 Make sure all HTML pages generated from this section have reasonable
names.

Markup nits.
1999-02-12 22:05:33 +00:00
Fred Drake 2d2b6a0074 Markup nits. 1999-02-12 20:40:49 +00:00
Fred Drake 28bc711f5f Added section for MimeWriter, contributed by Christopher Petrilli
<petrilli@amber.org>.

This spells the end of another whole section in the undoc chapter!
1999-02-12 19:26:09 +00:00
Fred Drake 26b698fa4d Document <complex #>.conjugate(). 1999-02-12 18:27:31 +00:00
Guido van Rossum ce67f06491 Update documentation to reflect changes to Queue.py by Tim Peters. 1999-02-08 18:43:13 +00:00
Fred Drake d673d481f5 Document sameopenfile(), samestat(). 1999-02-03 22:31:30 +00:00
Fred Drake 0256c1f453 Document splitdrive().
For all split*(), these split path *into* pairs, not split path *in*
pairs.  "Into" can be used for transformations, "in" is for
containment.
1999-02-03 19:24:44 +00:00
Guido van Rossum 0c9608cf1b Portability fix for [f]statvfs() return tuple: no longer return the
f_fsid field, since it's not a scalar on all systems supporting this
call (in particular, it's a tuple of two longs on AIX).  Since it's
not particularly useful, just nuke it.  Adapted the doc strings too.
1999-02-03 16:32:37 +00:00
Fred Drake 215fe2f204 Fix the os/posix documentation issue. 1999-02-02 19:02:35 +00:00
Fred Drake dda199b261 Moved \versionadded to end of description sections. 1999-02-02 19:01:37 +00:00
Fred Drake 12ba7868e4 Moved posixpath to os.path. 1999-02-02 19:00:37 +00:00
Fred Drake 560bcae0f0 Added posixpath, winsound. 1999-02-02 18:59:58 +00:00
Fred Drake a9b9bf96fe Change this to be os.path.
Use consistent parameter naming with the os documentation (paths
always named "path" or "path1", "path2"...).
1999-02-02 18:58:33 +00:00
Fred Drake d0bceeeb59 Move \versionadded macros to end of descriptions. 1999-02-02 18:00:40 +00:00
Guido van Rossum 09da65ef2f Patch by Sjoerd Mullender to placate /F:
Clarified (hopefully :-) the documentation of elements and attributes
variables.
1999-02-02 17:55:12 +00:00
Fred Drake dbd72a4e4f Added module synopsis. 1999-02-01 21:27:59 +00:00
Fred Drake 68a8c69499 Take out just about everything and refer the reader to the os module. 1999-02-01 20:23:02 +00:00
Fred Drake b23ee1d899 Make the text generic, and call it os.path instead of posixpath. 1999-02-01 20:20:39 +00:00
Fred Drake 98be47e737 OSError description: "as the by the" --> "as the" 1999-02-01 16:17:40 +00:00
Guido van Rossum 1804dc3c07 Document abspath() (implementation is forthcoming). 1999-01-29 18:05:05 +00:00
Fred Drake 703b70e260 Added \modulesynopsis. 1999-01-28 19:30:49 +00:00
Fred Drake 9d814c6805 Document the repr module. This removes the entire "Code objects and
files, debugger etc." section from "Undocumented Modules"!
1999-01-27 17:20:33 +00:00
Fred Drake da452bf6a7 Don't say that the module defines the "following functions" and then
only describe one; say "following function" instead!

Merge the two one-sentence paragraphs into a single paragraph, so it
doesn't look too stupid.
1999-01-27 15:48:23 +00:00
Fred Drake ebe2a12de8 Incorporate changes for patched version of ConfigParser. 1999-01-26 21:49:05 +00:00
Fred Drake bc866ce2e3 Documentation for the ConfigParser module, by Christopher G. Petrilli
(petrilli@amber.org).
1999-01-26 15:47:59 +00:00
Guido van Rossum 9700e9becc Document the default for tabsize in expandtabs(). 1999-01-25 22:31:53 +00:00
Fred Drake 19a0dba342 Add caveat on partial dependence on the "cl" module, only available on
IRIX systems.
1999-01-20 16:26:09 +00:00
Fred Drake 9ea3e36419 Move the jpeg module to the SGI section; it is dependent on the "cl"
module available on IRIX.
1999-01-20 15:55:20 +00:00
Fred Drake a7998f650a Revised comments on null bytes in pattern string.
Removed "New" from module synopsis.
1999-01-19 20:00:08 +00:00
Fred Drake 6ffa445832 Fix second description of handling 2-digit years (last item in
introductory text).
1999-01-19 19:35:18 +00:00
Fred Drake 7eca8e5017 Fix typo spotted by Jeff MacDonald <jam@ans.net>. 1999-01-18 15:46:02 +00:00
Barry Warsaw 53610caee2 for method getaddrlist(): Added a note clarifying that all named
headers and their continuation lines are parsed.
1999-01-14 21:26:54 +00:00
Fred Drake e36e4e6778 Use \refmodule when we say "use the XXX module instead".
For the whatsound module, point to sndhdr.
1999-01-13 17:11:52 +00:00
Fred Drake 39cddb7439 Added \modulesynopsis. 1999-01-12 19:22:11 +00:00
Fred Drake 03dd3efd5a <writer>.send_paragraph(): Clarify what needs to be done by this
method and what it should not do.  (Specifically: handling
	breaking of last line of preceeding paragraph.)
1999-01-12 18:33:47 +00:00
Fred Drake bb3b0028ba Patches describing the statvfs() and fstatvfs() functions. Additional
text about large file support.

All new text by Steve Clift <clift@mail.anacapa.net>, with only minor
revision / addition of markup.
1999-01-11 18:36:23 +00:00
Fred Drake c7dd3e11da Markup nit.
Add module synopsis.
1999-01-07 15:45:55 +00:00
Guido van Rossum cf3ce92ef4 Explain how come that pickle and cPickle, while using the same data
format, can produce different pickle strings for the same object.
1999-01-06 23:34:39 +00:00
Guido van Rossum 87e611e441 Replace the docs for reduce with an adaptation of its docstring, which
was actually clearer!
1999-01-06 23:10:51 +00:00
Guido van Rossum 74429eacb5 Add doc for access() and ttyname(). Patch by Sean Reifschneider. 1999-01-06 23:03:43 +00:00
Fred Drake c553358c63 Remove documentation for whatraw() since it's gone now. 1999-01-06 15:21:19 +00:00
Fred Drake 60adb362df Document the sndhdr module.
Document that the whatsound module is obsolete.
1999-01-05 23:09:12 +00:00
Fred Drake a2e4017394 Shorten the synopsis that gets into the table of contents. 1999-01-05 22:54:49 +00:00
Fred Drake 02e18b4b84 Added missing "from" in IOError description. 1999-01-05 21:42:18 +00:00
Andrew M. Kuchling f07c328c07 Document the optional mode argument (Z_FLUSH, Z_SYNC_FLUSH, etc.)
to the flush() method of compressor objects.
1998-12-31 21:14:23 +00:00
Fred Drake 94c4a7976f Added index entries to make it easier to locate directory & file operations. 1998-12-28 21:58:57 +00:00
Fred Drake 8692998018 Added index entries to make it easier to locate directory operations. 1998-12-28 21:58:15 +00:00
Fred Drake 76fa3b73d6 Remove recently documented modules from the undoc list. 1998-12-28 20:53:19 +00:00
Fred Drake 449e18f459 Add documentation for shutil module. 1998-12-28 20:16:58 +00:00
Fred Drake cd058539a8 Adjust a few niggles that affected the HTML conversion (a couple of
"^"s were being dropped in the context of [^...]).
1998-12-28 19:03:24 +00:00
Fred Drake 99e2c39b31 Add the getpass module. 1998-12-22 23:37:46 +00:00
Fred Drake 5ac2a07fca Basic documentation for the getpass module. 1998-12-22 23:37:21 +00:00
Fred Drake 5cb48a4c98 Added a \versionchanged since the API changed to support
namespaces with 1.5.2.

Added an index entry.

Fixed XML expansion:  XML is the "Extensible Markup Language", not the
"eXtended Markup Language".
1998-12-22 18:46:13 +00:00
Fred Drake 292b9ebfba Added information on when this was added, allowing us to release the
documentation on the Web while people are still using < 1.5.2b1.
1998-12-22 18:40:50 +00:00
Fred Drake 1189fa98eb Adjust markup to match current conventions, and make it formattable. 1998-12-22 18:24:13 +00:00
Fred Drake 768ac6b804 Start of text that describes differences between match and search.
Strengthen pointers to the search() function and method.
1998-12-22 18:19:45 +00:00
Fred Drake 191f2857f5 Use \moduleauthor and \sectionauthor instead of a comment to credit
the author (just happened to notice this one).
1998-12-22 18:06:02 +00:00
Fred Drake 7be0cde3a0 Add an explanation about what the example does and doesn't do.
Fix an appearantly new behavior with latex2html with quoting.  (Good
incentive to work on the SGML conversion! ;)
1998-12-22 18:04:48 +00:00
Guido van Rossum 5e97c9dff9 Adding libshlex and libnetrc by Eric Raymond. 1998-12-22 05:18:24 +00:00
Fred Drake e848976fba Clarify descriptions of some operations; it's not always clear that
strings are not actually modified.  Problem reported by Dr. Peter
Stoehr <peter.stoehr@weihenstephan.org>.
1998-12-21 18:56:13 +00:00
Fred Drake 3b02ddfa41 Add a bunch of index entries related to retrieving information from
the process table.
1998-12-21 18:52:53 +00:00
Guido van Rossum b083a9fb54 Sjoerd Mullender writes:
Here is my current version of xmllib.py and the documentation.  This
version has some API changes with respect to the version currently in
Python (also the one in 1.5.2a).
This version supports XML namespaces.
1998-12-18 20:17:13 +00:00
Fred Drake fee6abea90 Remove another {\rm ...} construct.
Sheesh, where do these things come from?
1998-12-10 19:57:52 +00:00
Fred Drake e9e05968e3 Nits. 1998-12-10 05:04:21 +00:00
Fred Drake 0ad55fb241 Update the descriptions of strftime() and strptime() to avoid
confusion, and describe what the "directives" are about.
1998-12-08 19:59:36 +00:00
Guido van Rossum aac399b80b Correct the poplib example. Stephan Richter pointed out some problems
with it.
1998-12-08 16:30:10 +00:00
Fred Drake 64583d3f87 Rename the parameters of atan2(), based on comments from Guido & Peter
A. Koren <pkoren@hex.net>.
1998-12-08 16:10:44 +00:00
Guido van Rossum f484a3366b Sjoerd writes:
When literal mode is entered it should exit automatically when the
matching close tag of the last unclosed open tag is encountered.  This
patch fixes this.
1998-12-07 21:59:56 +00:00
Fred Drake d83675f344 "singed" --> "signed" (3 places)
Noticed by Andrew MacIntyre <andymac@bullseye.apana.org.au>.
1998-12-07 17:13:18 +00:00
Guido van Rossum 8c2da61811 Add explicit example on how to import a submodule of a package using
__import__ and getattr().
1998-12-04 15:32:17 +00:00
Barry Warsaw 6d26f4b188 Moved NotImplementedError into alphabetical order, and reword
description.
1998-12-01 19:48:04 +00:00
Barry Warsaw 1e151322fb Added documentation for NotImplementedError. Fred (I'm sure) will
sanitize for your protection :-)
1998-12-01 19:19:21 +00:00
Fred Drake 2f8592cbea Ignore the byproducts of SGML/XML conversions for now. 1998-12-01 18:58:28 +00:00
Fred Drake eabfab1048 Nits to support conversions. 1998-12-01 18:37:59 +00:00
Fred Drake 1e270f0e03 Nits to support conversions. 1998-11-30 22:58:12 +00:00
Fred Drake 50b804dc88 Fix minor nit with respect to conversion.
Update some logical markup.
1998-11-30 22:14:58 +00:00
Fred Drake caa3379c4f Remove {\rm ...} constructs. 1998-11-30 21:53:47 +00:00
Fred Drake 84538cd076 Remove some remaining {\rm ...} constructs.
Update logical markup in a few spots.
1998-11-30 21:51:25 +00:00
Fred Drake 1776556f8f Markup nit to ease conversions. 1998-11-30 19:00:16 +00:00
Fred Drake 3d29955a6e Markup improvements to help with conversions. 1998-11-30 18:59:44 +00:00
Fred Drake 01d5d94020 Remove cruft from the old Texinfo conversion. This simplifies some of
the newer processing.
1998-11-30 17:33:38 +00:00
Fred Drake 5208823158 Remove bogus \@. 1998-11-30 16:27:37 +00:00
Fred Drake d61975e179 Minor markup nit to ease conversion processing. 1998-11-30 16:26:50 +00:00
Fred Drake f6c59e8fff Do all the right imports. Problem reported by Martijn Faassen
<faassen@vet.uu.nl>.
1998-11-30 15:07:26 +00:00
Fred Drake 4471f20ed4 Logical markup.
Fix a few things for the conversion to structured markup.

Removed texinfo special cases, since there's likely a new info
process.
1998-11-25 22:38:24 +00:00
Fred Drake f65e323101 Fix remaining {\rm ...} construct. 1998-11-25 20:55:03 +00:00
Guido van Rossum 5eabf3823b Clarify that min and max also take multiple arguments. 1998-11-25 18:53:05 +00:00
Fred Drake e839199014 Fix indexing of func_code attribute; this is on a function, not a code
object.

Add "()" to method names indexed using \ttindex{}.
1998-11-25 17:09:19 +00:00
Guido van Rossum 04307ce789 Rewrote the section on sys.exit(), documenting other argument types
than integers and recommending sys.exit("message").
(I see this as Python's answer to Perls ``die "message";''.)
1998-11-23 17:49:53 +00:00
Guido van Rossum da30f4ca6b Fix typo in doc for handle(): client_request should be client_address.
Noted by Stefan Witzel.
1998-11-16 19:07:04 +00:00
Fred Drake c46973c89b Document the user and password parameters to the NNTP constructor. 1998-11-16 17:11:30 +00:00
Fred Drake 2510d22048 Clarify the default buffering for open(). (Comment from Andrew Dalke
<dalke@bioreason.com>).
1998-11-02 18:57:34 +00:00
Fred Drake cab91efd34 Fix Barry's markup. 1998-11-02 17:23:25 +00:00
Fred Drake 9ed1a0afb9 Moved zmod and poly descriptions to the Obsolete section. 1998-11-02 15:46:21 +00:00
Barry Warsaw 4a1cdd7f22 Document the new features of this module 1998-10-31 23:19:00 +00:00
Fred Drake 130072d663 Don't describe something as "below"; that won't make sense for the
HTML version.  Give a reference to the actual section to allow a
hyperlink to be built.
1998-10-28 20:08:35 +00:00
Fred Drake c024c99faf Fix typo reported by Gerry Weiner <gerry@ucar.edu>. 1998-10-28 18:19:16 +00:00
Andrew M. Kuchling c1cea208bc Added URL to HOWTO page, with reference to Regex HOWTO.
Corrected error: {,5} is not equivalent to {0,5}.
1998-10-28 15:44:14 +00:00
Guido van Rossum 04101960e6 Indicate that os.environ may not be a real dictionary. 1998-10-24 20:16:56 +00:00
Guido van Rossum 18fa7d2800 Typo: JIFF -> JFIF. 1998-10-19 13:30:01 +00:00
Guido van Rossum f35b884c91 Clarify that close() of a stream opened by popen() returns None if the
exit status is zero.
1998-10-15 13:28:29 +00:00
Guido van Rossum 7d447aabbf Moved search and match around so that search is documented first. 1998-10-13 16:03:52 +00:00
Barry Warsaw afd974c2ab Document the new list.extend() method. Interesting enough, the
canonical definition of extend() is very similar to append() except
that the former doesn't list-ify the argument!
1998-10-09 16:39:58 +00:00
Fred Drake 09b295754f Remove extra } at end of method description parameters. 1998-10-01 20:43:13 +00:00
Barry Warsaw b2031f72d3 Document that apply() can now take any sequence in argument 2. 1998-10-01 15:35:43 +00:00
Guido van Rossum 9814a943a5 Add warning that on Windows it only works on sockets. 1998-09-28 14:28:38 +00:00
Guido van Rossum 954b9adcd2 Document new urllib features by Eric Raymond. 1998-09-28 14:08:29 +00:00
Guido van Rossum 5fb2631ff9 Explicitly document the fact that the search method returns a MatchObject.
(Reported by Gary Herron.)
1998-09-21 19:26:16 +00:00
Guido van Rossum 6ac06b39b3 Patch by Greg Stein to document the 'P' flag. 1998-09-21 14:44:34 +00:00
Fred Drake 10a7985565 re.findall(): Mark as added in 1.5.2. 1998-09-18 17:11:49 +00:00
Guido van Rossum 43b655c0ab Get rid of 'ppp' that accidentally crept in. 1998-09-17 17:07:15 +00:00
Guido van Rossum 6442116029 Richard Wolff's changes, documenting his changes to pdb.py. 1998-09-17 15:11:51 +00:00
Fred Drake d16d4981d1 Markup nits. 1998-09-10 20:21:00 +00:00
Fred Drake 9b134bf716 Added comment about support for rational numbers, and pointer to
Demos/classes/Rat.py.
1998-09-10 18:42:55 +00:00
Fred Drake 7a2f0668e4 Markup nits.
Fixes/index improvements from Michael Ernst <mernst@cs.washington.edu>.
1998-09-10 18:25:58 +00:00
Guido van Rossum dbf7956e52 Clarify Y2K behavior when a tuple with a 2-digit date is passed to
mktime() and such.
1998-08-25 14:44:49 +00:00
Fred Drake 607f802886 round(): Mark the second (optional) parameter as optional, since it's
described that way.

setattr():  Clarify that the attribute doesn't need to exist to be set.
1998-08-24 20:30:07 +00:00
Fred Drake c859350fa6 Added some cross-references to the end. 1998-08-24 18:46:14 +00:00
Fred Drake d0421dd448 spoking --> speaking
object whose method this is --> object on which the method operates
1998-08-24 17:57:20 +00:00
Fred Drake 637af13dca There is no <ISINPUT> element, just <ISINDEX>. ;-) 1998-08-21 20:02:06 +00:00
Andrew M. Kuchling 42db27fedc Added an example that uses signal.alarm() to time out an os.open() that
takes too long. This example relies on the fact that raising an
    exception in a signal handler causes the exception to be re-raised
    when the main line of the program resumes execution.  Is this guaranteed
    in CPython, or is this something that just happens to work by accident?

Also fixed a typo.
1998-08-18 19:38:54 +00:00
Fred Drake e7210dad6c Fix arguments for renames(); bug spotted by Oliver Andrich
<oli@rhein-zeitung.de>.
1998-08-17 13:29:06 +00:00
Fred Drake a5aefbad5a Fix markup where C include files get named in <...> form; bug reported by
Lorenzo M. Catucci <lorenzo@argon.roma2.infn.it>.
1998-08-14 17:05:17 +00:00
Andrew M. Kuchling d22e25002a Clarify wording in the description of re.split
Simplify the patterns in the examples for re.split
1998-08-14 14:49:20 +00:00
Guido van Rossum 3a5a02f3da Second definition of popen2 should be popen3. 1998-08-13 01:27:01 +00:00
Fred Drake 211f22c1b1 Added the test package under "Frameworks". 1998-08-11 18:13:31 +00:00
Fred Drake 2f343eb5cf Moved to ../templates/module.tex. 1998-08-11 17:30:02 +00:00
Fred Drake 5bdf88a364 Removed now-documented modules from the list. 1998-08-11 15:49:09 +00:00
Fred Drake 23f414c539 Added new sections. 1998-08-11 15:47:16 +00:00
Fred Drake e72e1e02fe Documentation for the compileall module. 1998-08-11 15:46:42 +00:00
Fred Drake 4756bb3e54 Documentation for the py_compile module. 1998-08-11 15:46:25 +00:00
Fred Drake 64c105d3d2 Added index entries.
Small markup nits.
1998-08-11 15:18:45 +00:00
Fred Drake 295da24eaf New section header style.
Fix up a few synopses.
1998-08-10 19:42:37 +00:00
Fred Drake 23329d41bc Some logical markup, some nits. 1998-08-10 17:46:22 +00:00
Fred Drake 66da9d69fc re is standard, not built-in. 1998-08-07 18:57:18 +00:00
Guido van Rossum cdf6af1233 Document gethostbyname_ex(). 1998-08-07 18:07:36 +00:00
Guido van Rossum 730d83797e Clarify that quit() and close() render the instance useless. 1998-08-07 17:36:59 +00:00
Fred Drake 161edc29a6 Added file transfer to example. 1998-08-07 17:30:49 +00:00
Fred Drake 60c3cafc24 In the example, make sure all the imports are done. 1998-08-07 16:03:32 +00:00
Fred Drake 3700b6f94e Markup nits. 1998-08-07 16:02:28 +00:00
Fred Drake c18a6f3bfe Clarify xdrlib synopsis. 1998-08-07 16:01:15 +00:00
Fred Drake 2d62395a8e Fix typo in binascii synopsis. 1998-08-07 16:00:30 +00:00
Fred Drake 150ee43c64 Removed obsolete chapter header. 1998-08-07 15:58:54 +00:00
Fred Drake f44c4851e9 New organization of internet modules into protocols/support and data
chapters.
1998-08-07 15:58:31 +00:00
Fred Drake 29fe944787 New chapter headers for Internet Protocols and Internet Data chapters,
which replace the existing internet chapter.
1998-08-07 15:56:52 +00:00
Fred Drake d795c5cbd1 Fix synopsis for multifile. 1998-08-07 15:55:14 +00:00
Fred Drake 399fea89cb Shorten the module synopsis. 1998-08-06 21:30:32 +00:00
Fred Drake 72d157e998 Shorten the module synopsis. 1998-08-06 21:23:17 +00:00
Fred Drake 23a163454a Markup nit. 1998-08-06 15:33:55 +00:00
Fred Drake 1a3c2a0ede Markup nits. 1998-08-06 15:18:23 +00:00
Fred Drake 56fa8a7e4b Marked makedirs(), removedirs(), renames() as added in 1.5.2. 1998-08-06 13:45:42 +00:00
Guido van Rossum 5fdd119aba Clarify the + and b mode characters for open() a bit. 1998-07-29 21:05:35 +00:00
Fred Drake 9f86b662d1 Update to use a separate page for front matter. 1998-07-28 21:55:19 +00:00
Fred Drake ee7fd697bf Fixed the gzip synopsis. 1998-07-27 22:30:15 +00:00
Fred Drake a30e469fda Added the popen2 synopsis. 1998-07-27 22:20:02 +00:00
Fred Drake 54327c4c05 Added the calendar synopsis. 1998-07-27 22:18:24 +00:00
Fred Drake edf6b1f431 Added the bisect synopsis. 1998-07-27 22:16:46 +00:00
Fred Drake 9030b0f053 Added the dumbdbm synopsis. 1998-07-27 22:12:26 +00:00
Fred Drake 08caa964c4 Added a synopsis. 1998-07-27 22:08:49 +00:00
Fred Drake 9643c6706f Fix the synopsis.
Change one \code{} to \samp{}.
1998-07-27 22:06:12 +00:00
Fred Drake b44e75339a Mark the new & changed items. 1998-07-27 21:11:42 +00:00
Guido van Rossum 2babd7b151 Document getsize(), getmtime(), getatime(). 1998-07-24 20:49:39 +00:00
Guido van Rossum 89a79d19b7 Document makedirs(), removedirs(), renames() -- ESR-inspired super-versions
of mkdir(), rmdir() and rename() that make or remove intermediate
directories as well.
1998-07-24 20:48:20 +00:00
Guido van Rossum b193c95165 Document Ellipsis (not much of a documentation snippet, but at least
it's mentioned.
1998-07-24 15:02:02 +00:00
Guido van Rossum 1eb200d360 Added 3 missing types: ComplexType, SliceType, EllipsisType. 1998-07-24 15:01:05 +00:00
Fred Drake 78a6ddbdd1 Move files around in a different way, so CVS picks up all the changes. ;-) 1998-07-24 14:27:22 +00:00
Fred Drake 64e3b43583 Move files around to get the names to match the module names except for
case.  Two modules (SocketServer, BaseHTTPServer) still don't match; those
names are just too long!
1998-07-24 13:56:11 +00:00
Fred Drake cf0fb8bfee Document the 'p' format character.
Clean up some of the markup.
1998-07-23 21:18:25 +00:00
Fred Drake c457ca7ede Fix up Barry's markup, which didn't pass the latex test. ;-) 1998-07-23 20:31:53 +00:00
Barry Warsaw da00c878bd Added descriptions of EnvironmentError and OSError; updated IOError to
reflect its new place in the exception hierarchy; fixed typos, etc.
1998-07-23 19:57:35 +00:00
Barry Warsaw eef2cd14c9 Updated the description of os.error to reflect the fact that it is now
equivalent to exceptions.OSError.
1998-07-23 19:50:09 +00:00
Fred Drake 27467e4b7e Logical markup. 1998-07-23 19:47:41 +00:00
Fred Drake 3bd9ab0ef3 Use the new module synopsis syntax, even though we don't need a synopsis table
for this chapter.  This protects against backend changes for \declaremodule.
1998-07-23 19:33:08 +00:00
Fred Drake b91e934cf1 Adjusted to use the new module synopsis support macros. 1998-07-23 17:59:49 +00:00
Guido van Rossum be260101cb # Oops, correct Latex errors. 1998-07-22 21:51:41 +00:00
Guido van Rossum 0af2f63056 Document how to make a POST request with urlopen().
Change the argument name for quote() and quote_plus() to safe (which
matches the implementation).

Add doc for the *new* function urlencode().
1998-07-22 21:34:21 +00:00
Guido van Rossum 897b9f0b0d Add new syntax for specifying filenames on break and clear commands. 1998-07-20 23:29:10 +00:00
Guido van Rossum d623d20e7d Complete the addition of libthreading.tex. (Isn't it annoying that
you need to edit four files in order to add one section to the manual?)
1998-07-20 17:34:50 +00:00
Andrew M. Kuchling 16440e63be Added libthreading.tex ; this is mostly the contents of threading_api.py,
with LaTeX markup added, and some small rewrites to improve the prose.
1998-07-20 13:46:10 +00:00
Guido van Rossum dfba2fbfd0 Eric Raymond documents two already-existing functions (bmp, png). 1998-07-17 19:01:29 +00:00
Guido van Rossum 7bda89f694 Rewritten a bit to address some criticism in the newsgroup. 1998-07-06 20:47:40 +00:00
Fred Drake 1717ba498f Normalize markup. 1998-07-02 19:36:50 +00:00
Fred Drake 579d366458 Normalize the markup. 1998-07-02 19:35:12 +00:00
Fred Drake 3f6034dcce Added index entry. 1998-07-02 19:33:43 +00:00
Fred Drake 91e5211bbf Added \deprecated to exit_thread() function.
Reflects Guido's revision.
1998-07-02 19:33:12 +00:00
Fred Drake 3240dd2bc2 Mark the actual SMTP commands (HELO, etc.) the same way FTP & NNTP commands
are in the appropriate sections.

Some minor nits.
1998-07-01 14:10:52 +00:00
Guido van Rossum cf51dacfb8 Document __copy__() and __deepcopy__() methods. 1998-06-30 16:54:33 +00:00
Fred Drake 5b68362a3a Use the real name of the module: "smtplib", not "smtp".
Use logical (& consistent) markup.

Added a see-also section at the end.
1998-06-30 16:53:52 +00:00
Guido van Rossum 8ec619f60e Note that readline returns '' on EOF, not "EOF" (whatever that may be). 1998-06-30 16:35:25 +00:00
Guido van Rossum 472b9a3f06 Clearly I was to quick with the previous commit...
Need to add \optional{} to sort argument too.

Made x a \var in descr of pop.

Fixed note for pop() and mentioned that it is experimental.

Also added pop to index.
1998-06-30 16:02:35 +00:00
Guido van Rossum 97ea116472 Documented the pop() method for lists.
# The brackets generated by \optional{} are real ugly.  Alas...
1998-06-30 15:56:23 +00:00
Guido van Rossum 9c59ce9b5a Documented os.linesep (line separator). 1998-06-30 15:54:27 +00:00
Guido van Rossum cd90509d58 As suggested by pson@pson.pp.se, correct the docs for head(), body(),
article().
1998-06-30 14:53:41 +00:00
Andrew M. Kuchling 52a79e8e1c Changed URL to crypto page. 1998-06-30 13:42:05 +00:00
Guido van Rossum 6c373f758f Document new default arg to groups() and new functions/methods
groupdict() and findall().
1998-06-29 22:48:01 +00:00
Guido van Rossum f9cfb173cd Now cmd is documented too. 1998-06-28 18:01:59 +00:00
Guido van Rossum a40d643cdc Documented smtplib, multifile 1998-06-28 17:58:06 +00:00
Guido van Rossum 8ddbe9119f Documented cmd, smtplib, multifile 1998-06-28 17:57:27 +00:00
Guido van Rossum 8668e8e49c Contributions by Eric Raymond: documentation for modules
cmd, multifile and smtplib.
1998-06-28 17:55:53 +00:00
Guido van Rossum 73d8bff44d Document optional kwargs argument to start_new_thread(). Also
document new LockType and reverse the preference for exit()
vs. exit_thread() -- exit() is now preferred and exit_thread() is
obsolete.
1998-06-27 18:25:44 +00:00
Fred Drake e5836d9811 Mark the 'whence' parameter of the file object's seek() method as optional;
it's already decribed that way in the description.
1998-06-25 16:26:56 +00:00
Andrew M. Kuchling 65b7863efc Fix unclear wording pointed out by Tim Peters, about the interaction between
^ and the pos argument to re.match().
Also, fixed a typo in libregex.tex.
1998-06-22 15:02:42 +00:00
Guido van Rossum a7874d1505 Revert the change of revision 1.30. While it's in general a laudable
goal to use isinstance(x, y) instead of comparing type(x) to y, it
doesn't make sense to change this in the example code for the type()
builtin...
1998-06-22 14:07:36 +00:00
Fred Drake 1b0ff2c32f eval() example: Removed final interpreter prompt; other examples don't have
the empty prompt.
1998-06-19 21:19:50 +00:00
Fred Drake 59160706b3 Somewhat updated, but not checked for everything (just the stuff I was using). 1998-06-19 21:18:28 +00:00
Guido van Rossum 7b7f6688d2 Added a stronger warning about changing the dictionary returned by
locals().
1998-06-18 16:45:34 +00:00
Guido van Rossum faac0136f4 # Untabified the example :-( 1998-06-17 22:38:09 +00:00
Guido van Rossum bca1207ac8 Documented that by default the output goes to stderr, and that a file
keyword argument can be used to direct it somewhere else.  Also
documented all the other functions in this module, and even added a
little example.

# Haven't tested the latex for correctness -- all latex installations
# appear broken.
1998-06-17 22:37:26 +00:00
Guido van Rossum 777dcc6b21 Change the description of input() -- it is exactly equivalent to
eval(raw_input(s)).  The statement about breaking a long expression
over multiple lines is no longer true.
1998-06-17 15:16:40 +00:00
Guido van Rossum 872948350f Some extra notes, and describe a new class (AddressList), all by ESR. 1998-06-16 22:27:40 +00:00
Guido van Rossum a3eebe60dc Add warning about use of lowercase/uppercase with maketrans(). 1998-06-11 16:03:30 +00:00
Guido van Rossum 444d0f87c9 Eric Raymond: added doc for isheader(); improved docs for constructor. 1998-06-11 13:50:02 +00:00
Guido van Rossum 1299100324 Document the changes I just checked in. 1998-06-10 21:34:27 +00:00
Guido van Rossum 3e5fe422cc Document several variables that were previously undocumented,
including the new __stdin__, __stdout__ and __stderr__.
Also moved setttrace around to its proper place in the alphabet.
1998-06-10 17:57:44 +00:00
Guido van Rossum 929bd0e02e Added notes about epochs, the year 2038, and a small Y2K disclaimer
(all with index entries!).  Also update the list of functions that
take or yield a time represented as a 9-tuple.
1998-06-09 21:25:41 +00:00
Guido van Rossum 5d23758be7 Added docs for strptime(). 1998-06-09 16:30:56 +00:00
Guido van Rossum 52481484e6 Clarify the type of the signal handler. 1998-06-09 15:42:25 +00:00
Guido van Rossum a58e9edbef Document missing functions: xor, not, truth, countOf, indexOf, and
(new!) contains.
1998-05-22 18:48:37 +00:00
Fred Drake 6a50ba82ce Minor grammatical correction: "This module perform ..." --> "This module
performs ...".
1998-05-22 18:19:19 +00:00
Fred Drake 7c68ab2f2b Added entry for mimetypes. 1998-05-19 19:13:01 +00:00
Fred Drake b818b46b38 Add section documenting mimetypes module. 1998-05-19 15:03:45 +00:00
Fred Drake 203b4f1a25 Add an index entry.
Bow to font lock.
1998-05-14 15:16:12 +00:00
Fred Drake a4c640e142 Reverted the last change; the extra cruft is harmless for formatted versions,
and allows the info to work through this section.
1998-05-11 19:51:11 +00:00
Fred Drake 02379fab61 Use \ldots, not \dots. The info process doesn't know about \dots. 1998-05-08 15:39:40 +00:00
Guido van Rossum 7b0c9d8a07 exec is a statement, not a function! 1998-05-08 13:27:38 +00:00
Fred Drake 4775d0a353 Relocating file to mac. 1998-05-07 12:58:57 +00:00
Fred Drake f7ffa92ce3 Fix typo in example found by Anthony Starks <anthony_starks@merck.com>,
reported to me by Piers Lauder <piers@cs.su.oz.au>.
1998-05-06 12:42:37 +00:00
Fred Drake 91eeefdee4 Work around lack of support for \if... in latex2html. 1998-04-29 17:56:44 +00:00
Fred Drake 06245ac2fa Fix documentation based on comments from Sean Reifschneider
<jafo-9804@tummy.com>.

Logical markup.
1998-04-29 14:38:34 +00:00
Fred Drake b5aa3de118 Remove extra cruft for texi processing. 1998-04-28 18:37:12 +00:00
Fred Drake ca6b4fe36b Section for bisect module. 1998-04-28 18:28:21 +00:00
Fred Drake 188a8471b8 Moved popen2 entry to make more sense.
Added bisect entry.
1998-04-28 18:27:53 +00:00
Fred Drake 125024a87d Updated. 1998-04-28 18:27:22 +00:00
Guido van Rossum 2aefe8d7c0 Document changed semantics -- open() now guesses the db type and error
is now a tuple of various and sundry exceptions.
1998-04-28 15:29:26 +00:00
Fred Drake f8d50bfdb0 Hook in the calendar and popen2 sections. 1998-04-28 14:29:27 +00:00
Fred Drake 1c127e74af calendar module section for the library reference, by Drew Csillag. 1998-04-28 14:28:57 +00:00
Fred Drake 6afad3792d popen2 section for the library reference, contributed by Drew Csillag, with
some reorganization.
1998-04-28 14:28:15 +00:00
Fred Drake 2a1cc3e171 Use of \key and \kbd were isolated to one instance each in this file;
normalize to \kbd to allow removal of \key from the document class.
1998-04-28 13:38:54 +00:00
Fred Drake 4f31694d37 Document transfercmd(), ntransfercmd(), delete(), rmd(), size().
Thanks to Timothy Wild <twild@clear.net.nz> for catching the omission of
delete().
1998-04-27 14:54:06 +00:00
Fred Drake a468404dda Added a section for the poplib module, contributed by Drew Csillag. 1998-04-24 20:49:02 +00:00
Fred Drake e28fb67c2c Add entry for poplib. 1998-04-24 20:08:28 +00:00
Fred Drake 42de185a77 Added \label to subsections which didn't have one, since this module has
subsections listed in the documentation index sidebar.  (Why?)
1998-04-20 16:28:44 +00:00
Guido van Rossum a933f6a53d Fix vonmisesvariate() -- it now returns an angle between 0 and *two*
times pi.  Got rid of $math$ here and in one other place.
1998-04-20 14:43:44 +00:00
Fred Drake 4f5155817b Mark TMPDIR correctly. 1998-04-17 14:51:04 +00:00
Fred Drake 1d9fb63293 Remove commented-out Mac chapter. 1998-04-17 13:24:55 +00:00
Fred Drake 6b303b4bdd Signature for dir() omitted the optional argument. 1998-04-16 22:10:27 +00:00
Fred Drake 12d9fc94f4 Use shorter labels; using long labels creates problems on the Macintosh.
(Thanks, Just!)
1998-04-14 17:19:54 +00:00
Fred Drake 95638f5b0f Added entry for Tkdnd.py. 1998-04-14 04:55:43 +00:00
Fred Drake 68fede768a Added item in Misc. for getpass module. 1998-04-13 20:31:31 +00:00
Fred Drake 916d8f8733 No more threats, just list the new methods under "AST Objects". 1998-04-13 18:46:16 +00:00
Fred Drake c4f1ca1967 Add a note that pickling is supported. 1998-04-13 16:27:27 +00:00
Fred Drake 3e7a48e0d9 Revert markup around list of display fields from the disassembler; it doesn't
look at good in print, but doesn't break the HTML.
1998-04-13 16:15:02 +00:00
Fred Drake 6250205166 Use {methoddesc} instead of {funcdesc} for object methods. 1998-04-12 03:31:31 +00:00
Fred Drake 898601bf8f Add cPickle to the list of modules in the chapter. 1998-04-12 03:08:41 +00:00
Fred Drake d6d88ffaf9 Add cStringIO to the list of modules in the chapter. 1998-04-12 03:07:35 +00:00
Fred Drake ee60191d1d Lighten up tables. 1998-04-11 20:53:03 +00:00
Fred Drake 17e564042d Change order of \seemodule macros at end of pickle module section. 1998-04-11 20:43:51 +00:00
Fred Drake 9463de2092 Document cPickle and cStringIO. 1998-04-11 20:05:43 +00:00
Fred Drake fab2f34538 When the text of a table cell should be wrapped, used a "p" column. 1998-04-11 18:46:56 +00:00
Fred Drake 7e9383ab59 Add a comment to indicate the methods of the StringIO are being discussed... 1998-04-11 18:05:24 +00:00
Fred Drake 70c460c84d Remove imaplib from the undocumented list. 1998-04-11 16:58:26 +00:00
Fred Drake a38a2867d0 Include () after function name.
One more logical mark.
1998-04-11 16:57:05 +00:00
Fred Drake 0d213d3497 When the text of a table cell should be wrapped, used a "p" column. 1998-04-11 16:40:46 +00:00
Fred Drake 34672dbb38 Remove over-active replace-string turds. 1998-04-11 16:24:21 +00:00
Fred Drake 8f6b958fdb Use {memberdesc} to mark the instance attributes. 1998-04-11 15:11:55 +00:00
Fred Drake 7dba8e2ab4 Hmmm... better add some \label macros for logical addressing while I'm at it. 1998-04-11 13:51:05 +00:00
Fred Drake 2a37455967 It's "Lauder", not "Lauders"! 1998-04-11 13:48:26 +00:00
Fred Drake e5cf53ad89 Formatting nits.
An index entry.
1998-04-11 05:02:45 +00:00
Fred Drake eb4ed15be8 Shift index entries around a little so the HTML doesn't have weird spacing. 1998-04-11 04:52:15 +00:00
Fred Drake 1e0f8bfea9 Add imaplib to appropriate lists. 1998-04-11 04:27:07 +00:00
Fred Drake 36751b0ed2 Remove obsolete module soundex from list of modules. 1998-04-11 04:23:07 +00:00
Fred Drake c48b772a77 Remove obsolete module rand from list of modules.
Add fileinput to list.
1998-04-11 04:22:02 +00:00
Fred Drake 89de314cfc First cut at documentation for imaplib. Based on original documentation by
Piers Lauders.
1998-04-11 04:19:04 +00:00
Fred Drake 007bac3b0b Added smtplib.py (thanks, Guido!). 1998-04-09 18:54:01 +00:00
Fred Drake 2cb824cbf9 Don't use \samp when \code is better.
Consistently use ' instead of ":  this conforms to my unofficial stance that
constants should be presented using the repr() whenever it makes sense.  This
isn't because I think repr() is the greatest thing since spam, just that it's
an easy to adopt consistency standard.  (It also holds no new surprises!)
1998-04-09 18:10:35 +00:00
Fred Drake 45c634ecae Work around a small (& annoying) limitation of the latex2html support for
\seemodule.  This is far easier than figuring out the real problem, but it
works.
1998-04-09 15:44:58 +00:00
Fred Drake 8a254b5967 Removed misleading comment about GNU software. This module and the zlib
library have no relationship with GNU software other than implementing some of
the same algorithms and file format.  (The zlib module is more general.)
1998-04-09 15:41:44 +00:00
Andrew M. Kuchling 253328104f Many markup changes (to \regexp, mostly)
Clarified text on 8-bit cleanness, complemented sets like [^5], and {m,n}
  qualifier.
1998-04-09 14:56:04 +00:00
Fred Drake 20ca9171c1 Don't assume that \version expands to the 3-character major.minor number; it
is the full release version name ("1.5.1beta1", for instance).

Add section for previously documented obsolete modules.  Includes ni, rand,
and soundex.
1998-04-09 14:32:28 +00:00
Fred Drake 363ab1a613 Comment out the soundex section. 1998-04-09 14:23:48 +00:00
Fred Drake 2de75ec245 Don't assume that \version expands to the 3-character major.minor number; it
is the full release version name ("1.5.1beta1", for instance).
1998-04-09 14:12:11 +00:00
Fred Drake 9da38814a3 Use the correct URL to AMK's regex-to-re HOWTO! 1998-04-09 14:06:33 +00:00
Fred Drake 54c3947fbc Updated URL to AMK's regex-to-re HOWTO. 1998-04-09 14:03:00 +00:00
Fred Drake 5406e7071f Added reference to AMK's HOWTO on the topic. 1998-04-09 14:02:02 +00:00
Fred Drake 223395c0a0 Added imaplib. 1998-04-09 13:55:06 +00:00
Fred Drake b8efda01e6 Update URL to the related HOWTO document. 1998-04-09 13:49:18 +00:00
Fred Drake bd400881dd Add section for ni back in, but comment it out. 1998-04-09 11:04:19 +00:00
Fred Drake eac469ca3d Commented out sections on obsolete & Macintosh modules. 1998-04-09 04:51:07 +00:00
Fred Drake f1b72ddf82 Reduced description of the obsolete method Stats.ignore(). 1998-04-09 04:49:56 +00:00
Guido van Rossum ae2be7144d Correct definition of CTIME. 1998-04-08 22:44:25 +00:00
Fred Drake 2764dd33cf Separate sections on anydbm and dumbdbm.
This is the last separation; each module now gets its own section.  This will
be useful in performing conversions.
1998-04-07 22:08:02 +00:00
Fred Drake 8e729ec31a Caught a few more spurious \setindexsubitem macros.... 1998-04-07 22:06:41 +00:00
Fred Drake a3f5c32f18 Removed unnecessary \setindexsubitem. 1998-04-07 21:45:52 +00:00
Fred Drake 1ce3604cfd Separate UserDict and UserList documentation into separate sections. 1998-04-07 20:05:33 +00:00
Fred Drake c708605f4f Added a reference to the discussion in Knuth's "Sorting and Searching", and
noted that the original algorithm produces 4-character results rather than
the 6-character results provided by this module.
1998-04-07 19:58:19 +00:00
Fred Drake 396b827a93 Minor markup nit. 1998-04-07 19:17:27 +00:00
Fred Drake 82d493fb96 Fixed some index entries. 1998-04-07 19:14:17 +00:00
Fred Drake 6b9ff7257b Added entry for wdb. 1998-04-07 19:09:32 +00:00
Fred Drake 810349b685 Fix the formatting of the list of fields in the disassemble() function. 1998-04-07 14:16:41 +00:00
Fred Drake 272fb3aaa4 Added poplib.
Made the module lists look like the other module lists in the documentation.
1998-04-07 14:15:28 +00:00
Fred Drake af370ea254 Move a short paragraph outside the description of ASTType. 1998-04-05 20:23:02 +00:00
Fred Drake 3a0351cf85 Remove all uses of \sectcode; we can now use logical markup everywhere. 1998-04-04 07:23:21 +00:00
Fred Drake fc57619811 Remove obsolete \setindexsubitem macros.
Massive migration to methoddesc and memberdesc.

Logical markup as needed.

A sprinkling of index entries for flavor.
1998-04-04 07:15:02 +00:00
Fred Drake 71c1e502f0 Moved some things around.
Adjusted a couple of the comments to be more informative.

Tell a little bit about what obsolete means now, and how to use obsolete
modules.
1998-04-04 07:03:19 +00:00
Fred Drake 13beac1289 Removed obsolete \setindexsubitem macros. 1998-04-04 06:46:51 +00:00
Fred Drake 85ea68b2a2 Added index entries. 1998-04-04 06:46:05 +00:00
Fred Drake 81acc2e988 Remove obsolete \setindexsubitem macro.
Logical markup, methoddesc, etc.
1998-04-04 06:35:41 +00:00
Fred Drake 61f45c7cb5 Remove obsolete \setindexsubitem macro,
Added index entries.

Markup nits.
1998-04-04 06:31:51 +00:00
Fred Drake b208f128b4 Added index entry. 1998-04-04 06:28:54 +00:00
Fred Drake 82143348aa Remove obsolete \setindexsubitem macro. 1998-04-04 06:28:14 +00:00
Fred Drake 858f787a02 Fix index entry for HTMLParser class. 1998-04-04 06:25:27 +00:00
Fred Drake 41788db3e2 Logical markup.
Index entries.
1998-04-04 06:23:02 +00:00
Fred Drake 9b28fe285d Logical markup. 1998-04-04 06:20:28 +00:00
Fred Drake e14dde2117 Fixed description of similarity between m[name] and m.getheader(name),
reported by Samuel L. Bayer.

Use methoddesc instead of funcdesc, etc.
1998-04-04 06:19:30 +00:00
Fred Drake d275de985a Remove obsolete lines like this:
\setindexsubitem{(in module frobnitz)}

These are no longer needed when present before any other \setindexsubitem{}
in the module section.  The indexsubitem is now set by \bimodindex and
\stmodindex.
1998-04-04 05:56:51 +00:00
Fred Drake 4bde97f190 Add fileinput section under Misc. Services. 1998-04-04 05:50:12 +00:00
Fred Drake 35ca0d69e1 Document fileinput. 1998-04-04 04:20:51 +00:00
Fred Drake 07bcd99873 Start at updating the template a little bit. There's a lot of stuff that's
just not here yet.
1998-04-03 21:25:16 +00:00
Guido van Rossum 791468f731 Some clarifications of out-of-range group indexes/names 1998-04-03 20:07:37 +00:00
Fred Drake 61885924b1 Lots of markup consistency nits.
Logical markup.
1998-04-03 07:16:46 +00:00
Fred Drake 6251c169c6 Small nits.
One more index entry.

Be more specific about an exception raised by range().
1998-04-03 07:15:54 +00:00
Fred Drake 8efde2197b Several minor markup nits. 1998-04-03 07:13:56 +00:00
Fred Drake 9f6aec870e "alternative" is a noun, use "alternate" for the adjective.
Minor nits.
1998-04-03 07:12:52 +00:00
Fred Drake 14c198b146 Talk about some minor nits... 1998-04-03 07:11:32 +00:00
Fred Drake 395e8e4860 Capitalize "Python" for consistency.
Describe UserDict and UserList individually so they aren't too hideous in
the presentation.
1998-04-03 07:10:41 +00:00
Fred Drake 7932a6bf8c Small markup nits. 1998-04-03 07:09:38 +00:00
Fred Drake d59db4f974 Small consistency nits. 1998-04-03 07:06:56 +00:00
Fred Drake 2123774287 Capitalize "Python" for consistency. 1998-04-03 07:06:01 +00:00
Fred Drake e6cedb362c New index entries. 1998-04-03 07:05:16 +00:00
Fred Drake 3f1c4720b5 Use {methoddesc} as appropriate. 1998-04-03 07:04:45 +00:00
Fred Drake 5dabeed4ea Index entries.
Consistency nits.
1998-04-03 07:02:35 +00:00
Fred Drake d0a40cb4cf Added comment crediting Sue Williams with this documentation section (the
ACKS file should be checked....).
1998-04-03 06:56:31 +00:00
Fred Drake 55e3cbd115 Fix one typo.
Add a manpage reference.

Add an index entry.
1998-04-03 06:54:27 +00:00
Fred Drake 74810d5abb Nits.
Add {excdesc} for zlib.error.

Use {methoddesc} where appropriate.
1998-04-03 06:49:26 +00:00
Fred Drake c3486318e0 Add index entry for GzipFile class. 1998-04-03 06:48:16 +00:00
Fred Drake d678cb7a6c Logical markup. 1998-04-03 06:35:54 +00:00
Fred Drake 9fee071ab6 Markup consistency. 1998-04-03 06:21:23 +00:00
Fred Drake 5bfe4850cf Consistency: Don't use module name when referring to functions defined
in the same module.
1998-04-03 06:14:54 +00:00
Fred Drake 2cfc835b7b Minor nits.
Lots of index entries.
1998-04-03 06:12:21 +00:00
Fred Drake 4e6688747c Consistency nits:
Use math-mode pi instead of mixing forms.

Use spaces around relational operators.
1998-04-03 06:04:12 +00:00
Fred Drake 76547c5631 Minor nits.
Moved IGNORECASE & friends to "top level" definitions following compile(),
since there is no other case of nesting in the manual.

Use {memberdesc} and {methoddesc} as appropriate.
1998-04-03 05:59:05 +00:00
Fred Drake dff21a6b93 Minor nits.
Indent code sample to use 4-space indents.
1998-04-03 05:42:10 +00:00
Fred Drake 5bd7fccef9 Minor nits.
Index entry.
1998-04-03 05:31:45 +00:00
Fred Drake 6a79be8db8 Capitalize "Python" for consistency.
Add an index entry.
1998-04-03 03:47:03 +00:00
Fred Drake 930f134fc9 Logical markup. 1998-04-03 03:44:56 +00:00
Fred Drake dd1f52b0c4 Use {seealso} environment to refer to the struct module.
Document ArrayType.

Use {memberdesc} and {methoddesc} environments, as appropriate.

Minor nits.
1998-04-03 03:35:24 +00:00
Fred Drake 3a18f3ba38 Hyphenate "built-in" for consistency. 1998-04-02 19:36:25 +00:00
Fred Drake dc40904a32 Hyphenate "built-in" for consistency. 1998-04-02 18:54:54 +00:00
Fred Drake da70ee1fae Use methoddesc and memberdesc, as needed.
Added description of BastionClass, since it is referred to in the Bastion
description as subclassable.
1998-04-02 18:51:30 +00:00
Fred Drake 182bd2d176 Use methoddesc instead of funcdesc to describe the only method. 1998-04-02 18:50:21 +00:00
Fred Drake 0a73d4db51 Removed reference to ni module. 1998-04-02 18:46:44 +00:00
Fred Drake 9ac80cb5bd Removed references to ni. 1998-04-02 18:45:09 +00:00
Fred Drake b401637bd8 Markup nits, index entries. 1998-04-02 18:44:38 +00:00
Fred Drake 674e0fd7a8 Be more specific about where in RFC 1421 to look, since it's not at all
obvious when taking a quick look.

Say "base64" instead of "base-64", since that seems to be how it's referred
to in other RFCs.
1998-04-02 16:24:29 +00:00
Fred Drake 9e9c89e67c Some nits.
Fixed quoting in third paragraph of the findmatch() description.
1998-04-02 15:53:07 +00:00
Guido van Rossum e9625e86b8 AMK's version from the latest pypcre distribution. This clarifies a
few things and adds docs for what happens to escapes in replacement
strings.
1998-04-02 01:32:24 +00:00
Fred Drake 8fe533e6a0 Use the new {methoddesc} and {memberdesc} environments as appropriate. 1998-03-27 05:27:08 +00:00
Fred Drake f76abb51ef Make sure both hyphens of a long-option show up in the HTML output. 1998-03-27 00:37:40 +00:00
Guido van Rossum 685ef4e604 According to Tim Peters, there should be 'print' statements in one
particular example.
1998-03-17 14:37:48 +00:00
Fred Drake cce1090d49 Change "\," to just "," in function signatures. This is easier to maintain,
works better with LaTeX2HTML, and allows some simplification of the python.sty
macros.
1998-03-17 06:33:25 +00:00
Fred Drake f3aa0e0627 Revert the index stuff to work better with LaTeX2HTML. 1998-03-17 06:23:13 +00:00
Fred Drake d98329cdf0 Logical markup.
Convert a {description} list to a {tableii} environment.
1998-03-16 06:38:42 +00:00
Fred Drake 1a855fad30 Markup nits.
Adjusted some index entries.
1998-03-16 05:23:50 +00:00
Fred Drake abdea226dc Adjusted an index entry. 1998-03-16 05:22:08 +00:00
Fred Drake 52405c899a Added an index entry. 1998-03-16 05:21:08 +00:00
Fred Drake 7bf5e0828f Use {classdesc} consistently. 1998-03-16 05:07:04 +00:00
Fred Drake c9808b3af2 Logical markup.
Emphasized title "4Sight User's Guide".
1998-03-15 02:04:59 +00:00
Fred Drake 5f874d618f Markup nits.
Some additional index entries.
1998-03-15 01:59:57 +00:00
Fred Drake bd9ded8190 Logical markup.
Replace ugly {description} with a {tableii}, for the what() return values.
1998-03-14 20:09:15 +00:00
Fred Drake 434493b207 Logical markup.
Replace ugly {description} with a {tableii}, for the option descriptions.
1998-03-14 19:47:23 +00:00
Fred Drake a891230688 Logical markup, using {classdesc} as appropriate. 1998-03-14 07:08:02 +00:00
Fred Drake f9e1f658ed Logical markup. 1998-03-14 07:00:41 +00:00
Fred Drake 2e495c93b0 Logical markup, using {classdesc} as appropriate. 1998-03-14 06:48:33 +00:00
Fred Drake be2b6d7f42 Logical markup. 1998-03-14 06:40:34 +00:00
Fred Drake ff79a21119 Logical markup.
Use {classdesc} environments to describe the constructors, and place them
at the top.
1998-03-14 06:30:13 +00:00
Fred Drake cdea8a3c60 Logical markup.
Wrap general Message class description in a {classdesc} instead of nothing at
all.
1998-03-14 06:17:43 +00:00
Fred Drake 0f51fff57e Logical markup. 1998-03-14 06:16:57 +00:00
Fred Drake 3b5da76182 Logical markup. 1998-03-12 15:33:05 +00:00
Fred Drake 2dde74c778 Logical markup. 1998-03-12 14:42:23 +00:00
Fred Drake 51375ae07b Use {classdesc} instead of {funcdesc} for HTMLParser.
Clean up index reference to SGMLParser class.
1998-03-12 14:39:09 +00:00
Fred Drake 6ef871ce2f Logical markup.
Lots of nits in both.
1998-03-12 06:52:05 +00:00
Fred Drake 7be8fcb42a Use \envvar{FOO} instead of \code{\$FOO}. 1998-03-12 06:47:48 +00:00
Fred Drake 4e7e11abe5 Use \withsubitem{} for indexing extra-module functions. 1998-03-12 06:46:16 +00:00
Fred Drake 371ecc0c1b Use \withsubitem{} for indexing functions from other modules. This fixes
things in the index.
1998-03-12 06:44:58 +00:00
Fred Drake 6a1eefe535 Logical markup. 1998-03-12 06:04:53 +00:00
Fred Drake a2e9818467 Logical markup.
Improve some index entries.
1998-03-12 05:54:02 +00:00
Fred Drake c71585e069 Logical markup.
Markup consistency.

Removed incorrect \setindexsubitem{}.
1998-03-12 05:33:40 +00:00
Fred Drake bc8ad5bdeb Replace lists of attributes for code and frame objects with a reference to the
Python Reference Manual.
1998-03-11 06:29:59 +00:00
Fred Drake fdbd51db8b Logical markup. 1998-03-11 06:24:46 +00:00
Fred Drake 60ba44750f Logical markup. 1998-03-11 06:18:15 +00:00
Fred Drake 295eaa84b0 Logical markup.
Changed example to use "import posixfile" instead of "from posixfile import *"
since only one symbol was used.
1998-03-11 06:11:37 +00:00
Fred Drake e42f595e5c Logical markup.
Made references to constants in other TERMIOS module explicit in termios
description.

Removed superfluous backslash from example.
1998-03-11 06:00:23 +00:00
Fred Drake db9693ec97 Logical markup. 1998-03-11 05:50:42 +00:00
Fred Drake 75aae9ad89 Logical markup.
Added information on the exception attributes when exceptions are classes.
1998-03-11 05:29:58 +00:00
Fred Drake b30d0164bf Logical markup. 1998-03-10 05:41:08 +00:00
Fred Drake 4ef3329259 Logical markup.
Correct misuse of indexsubutem.

Describe the Queue class using {classdesc}{Queue}, not {funcdesc}{__init__}.
1998-03-10 05:32:30 +00:00
Fred Drake 8aee0e0356 Add some more labels for logical addressing. 1998-03-10 05:21:39 +00:00
Fred Drake d883ca1dcb Logical markup. 1998-03-10 05:20:33 +00:00
Fred Drake 193338afeb Logical markup.
Convert one bulleted list to a {tableii} environment; the other should
probably be converted, but I haven't decided to what.
1998-03-10 04:23:12 +00:00
Fred Drake 2cb1074937 Use a {datadesc} environment to describe errorcode. 1998-03-10 03:53:03 +00:00
Fred Drake 92f31f1260 Logical markup. 1998-03-10 03:38:31 +00:00
Fred Drake a44d74086c Logical markup.
Use {funcdesc} and {excdesc} to describe the module, not just running text.
1998-03-10 03:36:00 +00:00
Fred Drake c4f15af7de Logical markup. small nits. 1998-03-10 03:17:26 +00:00
Fred Drake 7d20ffe245 Adjust the index inclusion for the new index support. 1998-03-09 16:39:22 +00:00
Fred Drake 2eda4ca4df Markup adjustments. 1998-03-08 08:13:53 +00:00
Fred Drake cd14a87c02 Mark the journal title. 1998-03-08 08:02:58 +00:00
Fred Drake 23bc85a8a6 Correct spelling of emdash. 1998-03-08 07:56:48 +00:00
Fred Drake 7ddd043191 Moved solitary "see also" paragraph into a {seealso} environment, and told
why the reader should see also.
1998-03-08 07:44:13 +00:00
Fred Drake 013ad9869e Cleaned up some remaining markup nits.
Andrew:  In description of (?iLmsx), you say it matches the empty string and
sets the corresponding flag.  Is this correct?  Or does it only set the flag?
1998-03-08 07:38:27 +00:00
Fred Drake 8fab8cf211 Logical markup. 1998-03-08 07:14:20 +00:00
Fred Drake b991f8d2e0 Some logical markup. 1998-03-08 07:09:19 +00:00
Fred Drake b55f9d3dfc Small nits.
Don't run into the right margin.
1998-03-08 07:03:27 +00:00
Fred Drake cc444e39e5 Nits. 1998-03-08 06:47:24 +00:00
Fred Drake bccc64020e Logical markup.
Spell emdash right.
1998-03-08 06:41:57 +00:00
Fred Drake 0c2af2bef6 Spell emdash with three hyphens.
Minor nits.
1998-03-08 06:28:00 +00:00
Fred Drake 266b4c1506 Logical markup.
Index entry.
1998-03-08 06:12:10 +00:00
Fred Drake c07ae9f4d2 Some logical markup.
Combine function pairs:  add() and __add__() go together.  This way they
share a single description and use less space.
1998-03-08 05:56:15 +00:00
Fred Drake 0fd72ee369 Logical markup.
Don't prepend the module name when referring to functions or data in the same
module.

Correct the description of "modules".
1998-03-08 05:43:51 +00:00
Fred Drake 580eb26044 Logical markup, a couple of index entries. 1998-03-08 05:41:11 +00:00
Fred Drake 4074896a1e Add reference to the copy_reg module in the See Also: section. 1998-03-06 21:27:14 +00:00
Fred Drake 859c797a48 Fix the URL for the regex-to-re HOWTO. 1998-03-06 15:11:30 +00:00
Fred Drake 2135117542 Oops, I *thoughT* I had seen a better address for Andrew.... 1998-03-05 20:06:31 +00:00
Fred Drake 8b8eae3e68 Updated URL & email addresses related to the PCT.
Andrew, plase check to make sure these are the ones you want used and get
back to me; this stuff will be "published" in the near future.
1998-03-05 20:04:23 +00:00
Fred Drake 6659c30b67 Convert LaTeX support to create a new class of documents. HTML generation
now requires LaTeX2HTML 98.1p1 or newer (& and is still in progress).

This means that doing things to change the formatting of the manuals (at the
"normal user" level, like A4 paper), can happen in just one place, rather
than in each document file.
1998-03-03 22:02:19 +00:00
Fred Drake 53525379da Logical markup. 1998-03-03 21:56:15 +00:00
Guido van Rossum 9bdc436aaa Added msvcrt. 1998-03-03 02:00:14 +00:00
Fred Drake 92e31944f4 Deprecate the read() and write() methods.
Don't refer to them from the fromfile() and tofile() methods.
1998-02-27 16:21:31 +00:00
Fred Drake 8a13525274 Updates by AMK.
Markup corrected, logical markup.
1998-02-27 15:19:42 +00:00
Fred Drake 8fa5eb8784 Logical markup. 1998-02-27 05:23:37 +00:00
Fred Drake 540e13dd1e Derive the name of the modules .ind from the jobname. 1998-02-25 15:31:20 +00:00
Fred Drake d10d0faaa5 Logical markup. 1998-02-24 21:43:05 +00:00
Fred Drake 78f6aac73e Clean up some stuff in the {seealso} at the end. This avoids a little nit
(which causes processing to fail) when using the LaTeX hyperref package.
1998-02-23 21:31:24 +00:00
Fred Drake a705da7aa0 Marked the unmarked AttributeError. (AMK)
"Protect the class instance" --> "Protect the object"  It works for anything
with attributes to look up!  (AMK)

Logical markup.
1998-02-23 14:42:00 +00:00
Fred Drake 71f894ad56 "streans" --> "streams" (AMK) 1998-02-23 14:37:40 +00:00
Fred Drake eb72a275b4 Add a period to "Written by James Roskind" 1998-02-22 20:42:11 +00:00
Guido van Rossum d028ca989a Fixed and extended the example; the original example contained some
bogus code.
1998-02-22 04:41:51 +00:00
Guido van Rossum 3ffb715032 Added two subsections with extra hints and details, even for
extensions and embedding programs.
1998-02-22 04:23:51 +00:00
Fred Drake 2c8aa650a8 Added \label{}s for logical addressing.
Logical markup.
1998-02-20 06:03:52 +00:00
Fred Drake d67e12e65c Added \label{}s for logical addressing. 1998-02-20 05:49:37 +00:00
Guido van Rossum 505d80b39d Jeff Kunce writes (and he is right):
Also, I just ran across a [possible] minor glitch
in the library documentation for site.py. It says:

"For example, suppose sys.prefix and
sys.exec_prefix are set to `/usr/local'. The
Python 1.5 library is then installed in
`/usr/local/lib/python1.5'. Suppose this has a
subdirectory `/usr/local/python1.5/site-packages'
with three subsubdirectories, `foo', `bar' and
`spam'..."

I think it should be:
"...Suppose this has a subdirectory
`/usr/local/lib/python1.5/site-packages' with..."
          ^^^^
1998-02-19 21:02:32 +00:00
Fred Drake 0cf0cfbaa9 Adjusted \label{} for *consistent* logical addressing.
Logical markup.
1998-02-19 20:59:19 +00:00
Fred Drake c83db33781 Added \label{} for logical addressing. 1998-02-19 20:50:52 +00:00
Fred Drake c3e4549012 Added \label{} for logical addressing. 1998-02-19 20:22:13 +00:00
Fred Drake 83efb54562 Added \label{} for logical addressing. 1998-02-19 20:07:39 +00:00
Fred Drake 83c1a39c4b Separate chapter and section. 1998-02-19 18:59:48 +00:00
Fred Drake 1aabe5e4d1 Separate binhex and binuu documentation from binascii. Support better
module addressing in HTML.
1998-02-19 18:29:18 +00:00
Fred Drake c92740708d Adjust grouping for the "b(reak)" command syntax description. This is
required to get the info generation back in operation, yet again.
1998-02-19 15:18:02 +00:00
Fred Drake 20e01966f5 Logical markup.
Several uses of "\^" could be simplified; this fixes part of the info
generation process.
1998-02-19 15:09:35 +00:00
Fred Drake ea8006a865 \nodename{} must immediately follow \chapter{} to be handled correctly;
adding the \label{} broke that.
1998-02-19 14:00:22 +00:00
Fred Drake 75bfb0f7bb {fulllineitems} is now an environment; use it as such. 1998-02-19 06:32:06 +00:00
Fred Drake 802a202d0d Logical markup.
Changed {funcdesc} to {classdesc}.  This is a test case for {classdesc}.
1998-02-19 06:26:35 +00:00
Guido van Rossum a73033fcc2 Feature added by Bill van Melle: when no timezone is present, assume
local time -- that's better than failure.
1998-02-19 00:28:58 +00:00
Guido van Rossum 026d9626df Consistent spelling: "time zone" -> "timezone".
Clarify that the sign of the timezone offset returned by
parsedate_tz() is the opposite of time.timezone.
1998-02-18 21:47:29 +00:00
Fred Drake b4efb6c8cb Separate Mac user interface modules into separate files, to better support
bookmarkable module sections in the HTML.
1998-02-18 17:19:11 +00:00
Fred Drake b0df567897 Separate the parse, symbol, and token documentation into separate files. 1998-02-18 15:59:13 +00:00
Fred Drake 710c035c05 Added \label{} for logical addressing. 1998-02-18 15:47:17 +00:00
Fred Drake 31ecd50d02 Added \label{} for logical addressing. 1998-02-18 15:40:11 +00:00
Fred Drake af0bfbee46 Added \label{} for logical addressing.
Logical markup.
1998-02-18 15:39:15 +00:00
Fred Drake 1f3ab1cb6c Added \label{} for logical addressing. 1998-02-18 15:22:08 +00:00
Fred Drake 55fca54ebb Added \label{} for logical addressing.
Logical markup.
1998-02-18 15:21:26 +00:00
Fred Drake 12918af83e Added \label{} for logical addressing. 1998-02-18 15:10:24 +00:00
Fred Drake ddf03bf8e1 Added \label{} for logical addressing.
Logical markup.
1998-02-18 15:05:47 +00:00
Guido van Rossum 1931c0c961 Add normpath(). Clarify normcase(). (Note -- this doc section
probably needs more work, describing new functions and the differences
between unix/mac/win.
1998-02-18 14:00:05 +00:00
Guido van Rossum 8cf94e608e Add mktime_tz(). Add () to a function reference in parsedate_tz(). 1998-02-18 05:09:14 +00:00
Fred Drake 57b5e42c0c Added \label{} for logical addressing. 1998-02-17 22:30:13 +00:00
Fred Drake e2f194b57d Use \manpage{} markup for referencing a UNIX man page.
Added index entry for DES cipher.
1998-02-17 22:24:45 +00:00
Fred Drake 8ecc705ba4 Added comment explaining the only warning produced by makeindex, since there
doesn't appear to be a way to fix that's reasonable.
1998-02-17 20:31:08 +00:00
Fred Drake 7154d382c3 Update indexsubitem for file attributes correctly. 1998-02-17 02:11:21 +00:00
Fred Drake a200faac55 \nodename{} must appear immediately after \section{} for the info conversion. 1998-02-17 02:10:41 +00:00
Fred Drake fac431e7d5 NNTP.xgtitle() description: Add a missing ")" from the response value
description.

NNTP.xover() description:  Adjust some markup for consistency.
1998-02-16 21:57:37 +00:00
Fred Drake 009ab92c12 Made the area for wildcards in the description wider, so we don't invade the
left margin.
1998-02-16 21:37:58 +00:00
Fred Drake 75fc045bf5 Fixed formatting of the program name for crypt.
Added another index entry.
1998-02-16 21:36:57 +00:00
Fred Drake ad51192a4f In the example file name, use the current Python version, not a hardcoded
value.

Use logical markup.
1998-02-16 21:25:53 +00:00
Fred Drake 2705e801d9 For the lists which describe the regular expression syntax, increase the
width available so we don't run into the left page margin.
1998-02-16 21:21:13 +00:00
Fred Drake b0f77d65db Use \version to get the current Python version number, where possible. This
can only be done in the running text, and not in {verbatim} environments.
1998-02-16 20:58:58 +00:00
Fred Drake 7506298dfb Mark up filename extensions consistently.
Logical markup.
1998-02-16 20:40:37 +00:00
Fred Drake b666c15c4a Normalization of markup. 1998-02-13 22:22:36 +00:00
Fred Drake 6e99adb1c9 Don't capitalize identifiers at the beginning of the sentence; re-write to
place them elsewhere so they get the right capitalization.
1998-02-13 22:17:21 +00:00
Fred Drake 01dbb88831 Fix some markup so that the right characters are printed.
"EOF" --> "\EOF{}"
1998-02-13 22:13:07 +00:00
Fred Drake 4a1efb63a9 Capitalize subsection title. 1998-02-13 22:10:21 +00:00
Fred Drake ab875b9a32 Make one paragraph wrap a little better. 1998-02-13 22:07:33 +00:00
Fred Drake a19bb9bbcf Capitalize first word in sentences, use periods at end. 1998-02-13 21:57:33 +00:00
Fred Drake 86b5dcec86 Change {datadesc} environments with empty descriptions to \dataline{}s; this
removes extra vertical space from the list of names, and makes the display
more similar to that used in the socket module, where several constants share
a description.
1998-02-13 21:55:21 +00:00
Fred Drake fc931ecf92 In description of sound_similar(), break up the markup for long
\code{} at each embedded space, so that the words will wrap.  This keeps
it from being too ugly.
1998-02-13 21:49:12 +00:00
Fred Drake 315b5d8a7f In description of __import__, second paragraph, break up the markup for long
\code{} at each embedded space, so that the words will wrap.  This keeps it
from running off the side of the page, and is only slightly weird.
1998-02-13 21:26:35 +00:00
Fred Drake 83bd081920 Minor stuff:
Explain what happens when a negative shift count is used (what exception).

Mark the title "Python Reference Manual" as \emph{}, for consistency.

"info" --> "information"

Tell more about the data attributes of file objects, using the {datadesc}
environment.

When refering the user to the language reference for information about
internal types, tell what internal types to expect information on.
1998-02-13 20:59:25 +00:00
Fred Drake fb74a463ad Add "Pretty Good Privacy" as well as "PGP" to the index. 1998-02-13 14:52:17 +00:00
Fred Drake c9c456ef69 In add_label_data() description, use "\samp{}" instead of "``\code{...}''"
to indicate the interpreted letters from the format string.
1998-02-13 14:48:00 +00:00
Fred Drake 7f6e2c45ec Use "\samp{...}" instead of "``\code{...}''" when showing markup fragments
in the running text.

For computed attribute and method names (where there's a \var{} part to
the name), use the non-indexing forms of \datadesc{} and \funcdesc{}.
This doesn't change the printed output, but removes 3 rejections from the
makeindex run and allows the LaTeX2HTML support to exclude these from the
index.
1998-02-13 14:38:23 +00:00
Fred Drake b441eb84d3 Use "\samp{...}" instead of "``\code{...}''" when showing markup fragments
in the running text.

For computed method names (where there's a \var{} part to the name), use
the non-indexing form of \funcdesc{}.  This doesn't change the printed
output, but removes 3 rejections from the makeindex run and allows the
LaTeX2HTML support to exclude these from the index.
1998-02-13 14:37:12 +00:00
Fred Drake 2a4646c660 Remove obsolete pagenumbering / pagestyle cruft. 1998-02-13 07:08:56 +00:00
Fred Drake 1947991c2f Remove all \bcode / \ecode cruft; this is no longer needed. See previous
checkin of myformat.sty.

Change "\renewcommand{\indexsubitem}{(...)}" to "\setindexsubitem{(...)}"
everywhere.

Some other minor nits that I happened to come across.
1998-02-13 06:58:54 +00:00
Guido van Rossum da62398139 Correct description of BUILD_SLICE. 1998-02-12 03:53:02 +00:00
Fred Drake dd1f6cc402 Mark opcode arguments \var{} in the running text.
In IMPORT_NAME description:  "is not affect:" --> "is not affected:"
1998-02-12 03:32:18 +00:00
Fred Drake 71c1ef34bf Remove second index entry for UserList. 1998-02-12 03:10:55 +00:00
Guido van Rossum 692b87db15 Added \nodename; added index entry for UserList. 1998-02-11 23:00:08 +00:00
Guido van Rossum f6a7b443c2 Added entries for stat, commands modules. 1998-02-11 22:58:55 +00:00
Guido van Rossum 6d659b3e51 Added entries for re, soundex modules. 1998-02-11 22:57:10 +00:00
Guido van Rossum 38e0df330b Some subtleties suggested by Tamito Kajiyama, including an added
\nodename macro for a section with a very underscriptive title.
1998-02-11 22:55:55 +00:00
Guido van Rossum f5370f4019 Turn the space in [\^ ...] into a hard space: [\^\ ...]. 1998-02-11 22:52:47 +00:00
Guido van Rossum 1c974db134 Split UserDict and UserList on two separate lines; added entries for
modules symbol and token.
1998-02-11 22:36:17 +00:00
Guido van Rossum ee833cca7b Don't break a long line at an unpleasant point. 1998-02-11 22:34:51 +00:00
Guido van Rossum 8b0927eddc Added missing entry for cmath. 1998-02-11 22:33:57 +00:00
Guido van Rossum c57aff20e3 Replace $math$ with \code{}. 1998-02-11 22:33:28 +00:00
Guido van Rossum c4452fd08f Swap ni and imp (so they are in the same order as their sections are). 1998-02-11 22:32:23 +00:00
Guido van Rossum 34122fa99c Remove a spurious space from the title. 1998-02-11 22:31:54 +00:00
Fred Drake 526467ce0a Removed all references to the \rfcindex{} macro; now only \rfc{} is used. 1998-02-10 21:42:27 +00:00
Fred Drake 1624a507e6 Oops, missed a \POSIX{} in an index entry. 1998-02-09 22:12:28 +00:00
Fred Drake 88223904c8 Add some index entries; switch to logical markup. 1998-02-09 20:52:48 +00:00
Fred Drake 65b32f7f74 Consistently use \POSIX{} to denote POSIX. There were at least two different
ways to do it previously (not counting module names).
1998-02-09 20:27:12 +00:00
Fred Drake 41785fb864 Do the right magic to make \ABC{} get sorted correctly in the index. 1998-02-09 20:16:46 +00:00
Fred Drake 19b97b13fa Do the right magic to make \UNIX{} get sorted correctly in the index. 1998-02-09 20:16:18 +00:00
Fred Drake c58912426e Use the new RFC macros wherever RFCs are referenced by number. No other
changes.
1998-02-09 19:16:20 +00:00
Guido van Rossum 8083c176a3 Add a note about rounding up of readlines()' sizehint to 8K. 1998-02-08 22:51:09 +00:00
Guido van Rossum 6e91c6a344 Document getrefcount(). 1998-02-07 21:17:05 +00:00
Fred Drake 31c4ed75fc Remove commented-out \itembreak. 1998-02-06 22:26:04 +00:00
Fred Drake c660233cfb Update two of the \indexsubitem values to use singular rather than plural form
of "variable": each individual variable should be identified as a single
variable and not a collection in the index.
1998-02-06 22:19:23 +00:00
Guido van Rossum 8e1e68de49 Add ref to errno module, and change ref to posix.error to os.error. 1998-02-06 15:18:25 +00:00
Guido van Rossum f499e09f94 Add ref to errno module. 1998-02-06 15:18:05 +00:00
Fred Drake 8aad4c80b3 Added missing "{" for "\code <?stuff?>}". 1998-02-03 23:12:13 +00:00
Guido van Rossum ad37e9e77d Clarify that capwords() removes leading/trailing whitespace.
Remove references to regsub, which is obsolescent.
1998-02-02 03:01:10 +00:00
Guido van Rossum c45c2f3dc1 Add S_ISBLK(). 1998-01-29 22:03:41 +00:00
Guido van Rossum 02505e4850 New version of xmllib from Sjoerd.
The main incompatibility is that the error reporting method is now
called as
 parser.syntax_error(msg)
instead of
 parser.syntax_error(lineno, msg)

This new version also has some code to deal with the <?xml?> and
<!DOCTYPE> tags at the start of an XML document.
The documentation has been updated, and a small test module has been
created.
1998-01-29 14:55:24 +00:00
Guido van Rossum 7570669a08 Add a note explaining that multiplying a sequence with a negative
number is the same as multiplying it with zero, and yields an empty
sequence.
1998-01-27 19:09:43 +00:00
Fred Drake 16f88454f1 Use \url{} to mark a URL. 1998-01-22 20:47:26 +00:00
Fred Drake ff3f0d0a5c Use \url{} to mark URLs, \email{} to mark an email address. 1998-01-22 20:45:31 +00:00
Fred Drake 7c418ed89c Added descriptions for log() and log10().
Clarified that floor() and ceil() return reals.  Same for the integer part
returned by modf().

Some markup consistency changes.
1998-01-22 17:37:50 +00:00
Fred Drake ed79783bb2 Converted to use new macros. This example demonstrate \method{} and, more
importantly, \url{}.
1998-01-22 16:11:18 +00:00
Fred Drake 55f4492859 Converted to use semantic markup. This is an example of how many of the new
constructs should be used.
1998-01-22 15:56:41 +00:00
Fred Drake 0f35495563 Add entry for copy_reg module. 1998-01-21 05:04:52 +00:00
Fred Drake 6eb9f10063 Removed entry for copy_reg module. 1998-01-21 05:00:28 +00:00
Fred Drake 2d754437d4 Add entry for copy_reg module. 1998-01-21 04:58:39 +00:00
Fred Drake 1abf0df5b4 Simple documentation of the copy_reg module.
Guido, you should probably look at this.  The pickle documentation is out of
date; I don't see anything about the __reduce__() stuff or the
__safe_for_unpickling__ attribute.
1998-01-21 04:58:10 +00:00
Fred Drake d1cc9c2b92 Update comment about relative URL internet draft to reflect current RFC status;
index references the appropriate RFCs.

Consistency:  Always use trailing "()" on function names in running text.
1998-01-21 04:55:02 +00:00
Fred Drake 61b0452626 Added a bunch of "concept" index entries.
Use trailing "()" on function names in running text.
1998-01-20 05:52:23 +00:00
Fred Drake a46f84d293 Added index entry and \label{} for exceptions module. This isn't in the
normal modules portion of the manual, but that's the basic effect of this
section with the 1.5 change in exception support.
1998-01-20 05:26:12 +00:00
Fred Drake 73a973bf8d Always mark variables in the "Notes" following a table the same way as in the
tables:  \var{}

Add a couple of index entries to the File Objects section.
1998-01-20 05:20:39 +00:00
Fred Drake cbe50f4829 Removed bogus index entry for the type() built-in.
Marked title of the Python Reference Manual as \emph{}, like other Python
manual titles.
1998-01-20 05:12:36 +00:00
Fred Drake 9eb5e5097e Consistency: "{\it ...}" ==> "\emph{...}" 1998-01-20 04:54:23 +00:00
Fred Drake c520b695fe The soundex module is built-in, not standard.
"--" ==> "---"
1998-01-20 04:45:44 +00:00
Fred Drake ca12b9df7b Consistency: {\it ...} ==> \emph{...} 1998-01-20 04:43:29 +00:00
Fred Drake dd17d1ce62 ni is a standard module, not a built-in module. The only other reference to
it already got it right.
1998-01-20 04:40:41 +00:00
Fred Drake bac354cd80 Consistency: (Yes, I know this section is not formatted by default, and
isn't likely to be of much interest these days....)

{\tt ...} ==> \code{...}

Added \label{module-blat} for the two supporting modules.

Added index entries for referred-to modules.
1998-01-20 04:32:09 +00:00
Guido van Rossum 46503922a0 Various updates to the effect that the group argument is always optional.
Also documented that groups() now always returns a tuple.
1998-01-19 23:14:17 +00:00
Fred Drake 8095ebfc4a Consistency: Replaced 4 {\it ...} with \emph{...}. 1998-01-19 04:02:41 +00:00
Fred Drake 94e8f690dd Consistency: Replaced one {\tt ...} with \code{...}. 1998-01-19 02:55:11 +00:00
Fred Drake b6ce6427e8 Consistency: In two places, change {\it ...} to \emph{...}. 1998-01-19 02:51:02 +00:00
Fred Drake b660b63edf Use \emph{} for all references to the other documents, not just some of them. 1998-01-16 16:34:34 +00:00
Fred Drake 5081b227f1 Ouch: "accounces" ==> "announces"
(In description of AbstractWriter class.)
1998-01-15 05:49:00 +00:00
Fred Drake af8a015c93 Consistency: "{\bf ...}" ==> "\strong{...}"
"{\em ...}" ==> "\emph{...}"

	      Not at all sure what to do with "{\rm ...}".
	      Leaving it for now.
1998-01-14 14:51:31 +00:00
Fred Drake b215137224 Added the standard \label{module-*} for the two supporting modules. 1998-01-14 05:47:15 +00:00
Fred Drake 8ac34c2928 Consistency: "Unix" ==> "\UNIX{}"
Always include the comma *inside* the \optional{} markup!
1998-01-13 22:41:33 +00:00
Fred Drake 4d4f9e726a Removed \mytableofcontents; just use \tableofcontents. 1998-01-13 22:25:02 +00:00
Fred Drake a809064166 Consistency: "Unix" ==> "\UNIX{}" 1998-01-13 19:10:02 +00:00
Fred Drake 6862b46b70 Consistency: "unix" ==> "\UNIX{}" 1998-01-13 19:03:36 +00:00
Fred Drake c9dc5151b6 Consistency: "unix" ==> "\UNIX{}"
Added \label{} for referring to the module.
1998-01-13 19:01:57 +00:00
Fred Drake efc1e0f43b Consistency:
"Unix" ==> "\UNIX{}"
1998-01-13 19:00:33 +00:00
Fred Drake 18f9f539f2 Removed obsolete \kwindex{} call.
Added "user configuration file", ".pythonrc.py file" to the index.

Made reference to site module a {seealso} environment.
1998-01-13 18:45:34 +00:00
Fred Drake 2b67bee8e1 Added "module search path" to the index. 1998-01-13 18:35:51 +00:00
Fred Drake cf75754357 Removed obsolete \kwindex{} calls.
Added "module search path" to the index.

"Unix" ==> "\UNIX{}"
1998-01-13 18:34:40 +00:00
Fred Drake dca8792b52 Added openright option the the \documentclass{} for each of the manuals. 1998-01-13 16:53:23 +00:00
Fred Drake 023f87fbf8 Lots of minor markup nits, all consistency related.
Consistently use trailing "()" on function / method names.

Wrapped some long lines.
1998-01-12 19:16:24 +00:00
Guido van Rossum 97546399c7 Document maxsplit arg for split(), with incompatibility note about 1.5
release bug.

Document groups() changed behaviour (now always returns tuple).
1998-01-12 18:58:53 +00:00
Fred Drake 054f8fd12c Wrapped some long lines.
Added trailing "()" for function and method names.

Added index entries for referenced modules.
1998-01-12 18:28:20 +00:00
Fred Drake 74947ac473 Modify command descriptions to use \optional{} instead of ad-hoc markup.
There are still weirdnesses, but less of them.
1998-01-12 15:38:30 +00:00
Guido van Rossum b2c45a8197 Sigh. Apply a similar patch to the *other* occurrence of [^...]. 1998-01-12 05:49:05 +00:00
Fred Drake fd49a964bc Follow current recommended practice in an example: Use isinstance() to
perform a type test instead of type(x) == types.FoobarType.  In example
for type().
1998-01-11 21:15:23 +00:00