Use the new {methoddesc} and {memberdesc} environments as appropriate.

Doc/lib/libhtmllib.tex

@@ -70,53 +70,50 @@ handlers for all HTML 2.0 and many HTML 3.0 and 3.2 elements.
 In addition to tag methods, the \class{HTMLParser} class provides some
 additional methods and instance variables for use within tag methods.
 
-\setindexsubitem{(HTMLParser attribute)}
-
-\begin{datadesc}{formatter}
+\begin{memberdesc}{formatter}
 This is the formatter instance associated with the parser.
-\end{datadesc}
+\end{memberdesc}
 
-\begin{datadesc}{nofill}
+\begin{memberdesc}{nofill}
 Boolean flag which should be true when whitespace should not be
 collapsed, or false when it should be.  In general, this should only
 be true when character data is to be treated as ``preformatted'' text,
 as within a \code{<PRE>} element.  The default value is false.  This
 affects the operation of \method{handle_data()} and \method{save_end()}.
-\end{datadesc}
+\end{memberdesc}
 
-\setindexsubitem{(HTMLParser method)}
 
-\begin{funcdesc}{anchor_bgn}{href, name, type}
+\begin{methoddesc}{anchor_bgn}{href, name, type}
 This method is called at the start of an anchor region.  The arguments
 correspond to the attributes of the \code{<A>} tag with the same
 names.  The default implementation maintains a list of hyperlinks
 (defined by the \code{href} attribute) within the document.  The list
 of hyperlinks is available as the data attribute \code{anchorlist}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{anchor_end}{}
+\begin{methoddesc}{anchor_end}{}
 This method is called at the end of an anchor region.  The default
 implementation adds a textual footnote marker using an index into the
 list of hyperlinks created by \method{anchor_bgn()}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_image}{source, alt\optional{, ismap\optional{, align\optional{, width\optional{, height}}}}}
+\begin{methoddesc}{handle_image}{source, alt\optional{, ismap\optional{, align\optional{, width\optional{, height}}}}}
 This method is called to handle images.  The default implementation
 simply passes the \var{alt} value to the \method{handle_data()}
 method.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{save_bgn}{}
+\begin{methoddesc}{save_bgn}{}
 Begins saving character data in a buffer instead of sending it to the
 formatter object.  Retrieve the stored data via \method{save_end()}.
 Use of the \method{save_bgn()} / \method{save_end()} pair may not be
 nested.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{save_end}{}
+\begin{methoddesc}{save_end}{}
 Ends buffering character data and returns all data saved since the
 preceeding call to \method{save_bgn()}.  If the \code{nofill} flag is
 false, whitespace is collapsed to single spaces.  A call to this
 method without a preceeding call to \method{save_bgn()} will raise a
 \exception{TypeError} exception.
-\end{funcdesc}
+\end{methoddesc}

Doc/lib/libpprint.tex

@@ -142,32 +142,31 @@ l/lib/python1.4/test', '/usr/local/lib/python1.4/sunos5', '/usr/local/lib/python
 
 \class{PrettyPrinter} instances have the following methods:
 
-\setindexsubitem{(PrettyPrinter method)}
 
-\begin{funcdesc}{pformat}{object}
+\begin{methoddesc}{pformat}{object}
 Return the formatted representation of \var{object}.  This takes into
-account the options passed to the \class{PrettyPrinter} constructor.
-\end{funcdesc}
+Account the options passed to the \class{PrettyPrinter} constructor.
+\end{methoddesc}
 
-\begin{funcdesc}{pprint}{object}
+\begin{methoddesc}{pprint}{object}
 Print the formatted representation of \var{object} on the configured
 stream, followed by a newline.
-\end{funcdesc}
+\end{methoddesc}
 
 The following methods provide the implementations for the
 corresponding functions of the same names.  Using these methods on an
 instance is slightly more efficient since new \class{PrettyPrinter}
 objects don't need to be created.
 
-\begin{funcdesc}{isreadable}{object}
+\begin{methoddesc}{isreadable}{object}
 Determine if the formatted representation of the object is
 ``readable,'' or can be used to reconstruct the value using
 \function{eval()}\bifuncindex{eval}.  Note that this returns false for
 recursive objects.  If the \var{depth} parameter of the
 \class{PrettyPrinter} is set and the object is deeper than allowed,
 this returns false.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{isrecursive}{object}
+\begin{methoddesc}{isrecursive}{object}
 Determine if the object requires a recursive representation.
-\end{funcdesc}
+\end{methoddesc}

Doc/lib/libprofile.tex

 \chapter{The Python Profiler}
 \label{profile}
-\stmodindex{profile}
-\stmodindex{pstats}
 
 Copyright \copyright{} 1994, by InfoSeek Corporation, all rights reserved.
 
@@ -256,8 +254,9 @@ of algorithms to be directly compared to iterative implementations.
 
 
 \section{Reference Manual}
+\stmodindex{profile}
+\label{module-profile}
 
-\setindexsubitem{(in module profile)}
 
 The primary entry point for the profiler is the global function
 \function{profile.run()}.  It is typically used to create any profile
@@ -269,7 +268,7 @@ Profiler Extensions, which includes discussion of how to derive
 ``better'' profilers from the classes presented, or reading the source
 code for these modules.
 
-\begin{funcdesc}{profile.run}{string\optional{, filename\optional{, ...}}}
+\begin{funcdesc}{run}{string\optional{, filename\optional{, ...}}}
 
 This function takes a single argument that has can be passed to the
 \keyword{exec} statement, and an optional file name.  In all cases this
@@ -336,7 +335,8 @@ printed.
 Analysis of the profiler data is done using this class from the
 \module{pstats} module:
 
-\setindexsubitem{(in module pstats)}
+% now switch modules....
+\stmodindex{pstats}
 
 \begin{classdesc}{Stats}{filename\optional{, ...}}
 This class constructor creates an instance of a ``statistics object''
@@ -361,7 +361,7 @@ need to be combined with data in an existing \class{Stats} object, the
 
 \setindexsubitem{(Stats method)}
 
-\begin{funcdesc}{strip_dirs}{}
+\begin{methoddesc}{strip_dirs}{}
 This method for the \class{Stats} class removes all leading path
 information from file names.  It is very useful in reducing the size
 of the printout to fit within (close to) 80 columns.  This method
@@ -372,19 +372,19 @@ initialization and loading.  If \method{strip_dirs()} causes two
 function names to be indistinguishable (i.e., they are on the same
 line of the same filename, and have the same function name), then the
 statistics for these two entries are accumulated into a single entry.
-\end{funcdesc}
+\end{methoddesc}
 
 
-\begin{funcdesc}{add}{filename\optional{, ...}}
+\begin{methoddesc}{add}{filename\optional{, ...}}
 This method of the \class{Stats} class accumulates additional
 profiling information into the current profiling object.  Its
 arguments should refer to filenames created by the corresponding
 version of \function{profile.run()}.  Statistics for identically named
 (re: file, line, name) functions are automatically accumulated into
 single function statistics.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{sort_stats}{key\optional{, ...}}
+\begin{methoddesc}{sort_stats}{key\optional{, ...}}
 This method modifies the \class{Stats} object by sorting it according
 to the supplied criteria.  The argument is typically a string
 identifying the basis of a sort (example: \code{"time"} or
@@ -430,18 +430,18 @@ interpreted as \code{"stdname"}, \code{"calls"}, \code{"time"}, and
 \code{"cumulative"} respectively.  If this old style format (numeric)
 is used, only one sort key (the numeric key) will be used, and
 additional arguments will be silently ignored.
-\end{funcdesc}
+\end{methoddesc}
 
 
-\begin{funcdesc}{reverse_order}{}
+\begin{methoddesc}{reverse_order}{}
 This method for the \class{Stats} class reverses the ordering of the basic
 list within the object.  This method is provided primarily for
 compatibility with the old profiler.  Its utility is questionable
 now that ascending vs descending order is properly selected based on
 the sort key of choice.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{print_stats}{restriction\optional{, ...}}
+\begin{methoddesc}{print_stats}{restriction\optional{, ...}}
 This method for the \class{Stats} class prints out a report as described
 in the \function{profile.run()} definition.
 
@@ -473,10 +473,10 @@ print_stats("foo:", .1)
 
 would limit the list to all functions having file names \samp{.*foo:},
 and then proceed to only print the first 10\% of them.
-\end{funcdesc}
+\end{methoddesc}
 
 
-\begin{funcdesc}{print_callers}{restrictions\optional{, ...}}
+\begin{methoddesc}{print_callers}{restrictions\optional{, ...}}
 This method for the \class{Stats} class prints a list of all functions
 that called each function in the profiled database.  The ordering is
 identical to that provided by \method{print_stats()}, and the definition
@@ -484,16 +484,16 @@ of the restricting argument is also identical.  For convenience, a
 number is shown in parentheses after each caller to show how many
 times this specific call was made.  A second non-parenthesized number
 is the cumulative time spent in the function at the right.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{print_callees}{restrictions\optional{, ...}}
+\begin{methoddesc}{print_callees}{restrictions\optional{, ...}}
 This method for the \class{Stats} class prints a list of all function
 that were called by the indicated function.  Aside from this reversal
 of direction of calls (re: called vs was called by), the arguments and
 ordering are identical to the \method{print_callers()} method.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{ignore}{}
+\begin{methoddesc}{ignore}{}
 This method of the \class{Stats} class is used to dispose of the value
 returned by earlier methods.  All standard methods in this class
 return the instance that is being processed, so that the commands can
@@ -503,7 +503,7 @@ be strung together.  For example:
 pstats.Stats('foofile').strip_dirs().sort_stats('cum') \
                        .print_stats().ignore()
 \end{verbatim}
-%
+
 would perform all the indicated functions, but it would not return
 the final reference to the \class{Stats} instance.%
 \footnote{
@@ -511,7 +511,7 @@ This was once necessary, when Python would print any unused expression
 result that was not \code{None}.  The method is still defined for
 backward compatibility.
 }
-\end{funcdesc}
+\end{methoddesc}
 
 
 \section{Limitations}

Doc/lib/libqueue.tex

@@ -37,34 +37,32 @@ other queue organizations (e.g. stack) but the inheritable interface
 is not described here.  See the source code for details.  The public
 methods are:
 
-\setindexsubitem{(Queue method)}
-
-\begin{funcdesc}{qsize}{}
+\begin{methoddesc}{qsize}{}
 Returns the approximate size of the queue.  Because of multithreading
 semantics, this number is not reliable.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{empty}{}
+\begin{methoddesc}{empty}{}
 Returns \code{1} if the queue is empty, \code{0} otherwise.  Because
 of multithreading semantics, this is not reliable.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{full}{}
+\begin{methoddesc}{full}{}
 Returns \code{1} if the queue is full, \code{0} otherwise.  Because of
 multithreading semantics, this is not reliable.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{put}{item}
+\begin{methoddesc}{put}{item}
 Puts \var{item} into the queue.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{get}{}
+\begin{methoddesc}{get}{}
 Gets and returns an item from the queue, blocking if necessary until
 one is available.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{get_nowait}{}
+\begin{methoddesc}{get_nowait}{}
 Gets and returns an item from the queue if one is immediately
 available.  Raises an \exception{Empty} exception if the queue is
 empty or if the queue's emptiness cannot be determined.
-\end{funcdesc}
+\end{methoddesc}

Doc/lib/libsgmllib.tex

@@ -38,37 +38,36 @@ spaces, tabs, and newlines are allowed between the trailing
 
 \class{SGMLParser} instances have the following interface methods:
 
-\setindexsubitem{(SGMLParser method)}
 
-\begin{funcdesc}{reset}{}
+\begin{methoddesc}{reset}{}
 Reset the instance.  Loses all unprocessed data.  This is called
 implicitly at instantiation time.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{setnomoretags}{}
+\begin{methoddesc}{setnomoretags}{}
 Stop processing tags.  Treat all following input as literal input
 (CDATA).  (This is only provided so the HTML tag \code{<PLAINTEXT>}
 can be implemented.)
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{setliteral}{}
+\begin{methoddesc}{setliteral}{}
 Enter literal mode (CDATA mode).
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{feed}{data}
+\begin{methoddesc}{feed}{data}
 Feed some text to the parser.  It is processed insofar as it consists
 of complete elements; incomplete data is buffered until more data is
 fed or \method{close()} is called.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{close}{}
+\begin{methoddesc}{close}{}
 Force processing of all buffered data as if it were followed by an
 end-of-file mark.  This method may be redefined by a derived class to
 define additional processing at the end of the input, but the
 redefined version should always call \method{close()}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_starttag}{tag, method, attributes}
+\begin{methoddesc}{handle_starttag}{tag, method, attributes}
 This method is called to handle start tags for which either a
 \code{start_\var{tag}()} or \code{do_\var{tag}()} method has been
 defined.  The \var{tag} argument is the name of the tag converted to
@@ -82,9 +81,9 @@ instance, for the tag \code{<A HREF="http://www.cwi.nl/">}, this
 method would be called as \samp{unknown_starttag('a', [('href',
 'http://www.cwi.nl/')])}.  The base implementation simply calls
 \var{method} with \var{attributes} as the only argument.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_endtag}{tag, method}
+\begin{methoddesc}{handle_endtag}{tag, method}
 This method is called to handle endtags for which an
 \code{end_\var{tag}()} method has been defined.  The \var{tag}
 argument is the name of the tag converted to lower case, and the
@@ -93,15 +92,15 @@ support semantic interpretation of the end tag.  If no
 \code{end_\var{tag}()} method is defined for the closing element,
 this handler is not called.  The base implementation simply calls
 \var{method}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_data}{data}
+\begin{methoddesc}{handle_data}{data}
 This method is called to process arbitrary data.  It is intended to be
 overridden by a derived class; the base class implementation does
 nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_charref}{ref}
+\begin{methoddesc}{handle_charref}{ref}
 This method is called to process a character reference of the form
 \samp{\&\#\var{ref};}.  In the base implementation, \var{ref} must
 be a decimal number in the
@@ -111,9 +110,9 @@ method \method{handle_data()} with the character as argument.  If
 \code{unknown_charref(\var{ref})} is called to handle the error.  A
 subclass must override this method to provide support for named
 character entities.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_entityref}{ref}
+\begin{methoddesc}{handle_entityref}{ref}
 This method is called to process a general entity reference of the
 form \samp{\&\var{ref};} where \var{ref} is an general entity
 reference.  It looks for \var{ref} in the instance (or class)
@@ -124,46 +123,46 @@ with the translation; otherwise, it calls the method
 \code{unknown_entityref(\var{ref})}.  The default \member{entitydefs}
 defines translations for \code{\&amp;}, \code{\&apos}, \code{\&gt;},
 \code{\&lt;}, and \code{\&quot;}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_comment}{comment}
+\begin{methoddesc}{handle_comment}{comment}
 This method is called when a comment is encountered.  The
 \var{comment} argument is a string containing the text between the
 \samp{<!--} and \samp{-->} delimiters, but not the delimiters
 themselves.  For example, the comment \samp{<!--text-->} will
 cause this method to be called with the argument \code{'text'}.  The
 default method does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{report_unbalanced}{tag}
+\begin{methoddesc}{report_unbalanced}{tag}
 This method is called when an end tag is found which does not
 correspond to any open element.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{unknown_starttag}{tag, attributes}
+\begin{methoddesc}{unknown_starttag}{tag, attributes}
 This method is called to process an unknown start tag.  It is intended
 to be overridden by a derived class; the base class implementation
 does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{unknown_endtag}{tag}
+\begin{methoddesc}{unknown_endtag}{tag}
 This method is called to process an unknown end tag.  It is intended
 to be overridden by a derived class; the base class implementation
 does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{unknown_charref}{ref}
+\begin{methoddesc}{unknown_charref}{ref}
 This method is called to process unresolvable numeric character
 references.  Refer to \method{handle_charref()} to determine what is
 handled by default.  It is intended to be overridden by a derived
 class; the base class implementation does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{unknown_entityref}{ref}
+\begin{methoddesc}{unknown_entityref}{ref}
 This method is called to process an unknown entity reference.  It is
 intended to be overridden by a derived class; the base class
 implementation does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
 Apart from overriding or extending the methods listed above, derived
 classes may also define methods of the following form to define
@@ -171,22 +170,22 @@ processing of specific tags.  Tag names in the input stream are case
 independent; the \var{tag} occurring in method names must be in lower
 case:
 
-\begin{funcdescni}{start_\var{tag}}{attributes}
+\begin{methoddescni}{start_\var{tag}}{attributes}
 This method is called to process an opening tag \var{tag}.  It has
 preference over \code{do_\var{tag}()}.  The \var{attributes}
 argument has the same meaning as described for
 \method{handle_starttag()} above.
-\end{funcdescni}
+\end{methoddescni}
 
-\begin{funcdescni}{do_\var{tag}}{attributes}
+\begin{methoddescni}{do_\var{tag}}{attributes}
 This method is called to process an opening tag \var{tag} that does
 not come with a matching closing tag.  The \var{attributes} argument
 has the same meaning as described for \method{handle_starttag()} above.
-\end{funcdescni}
+\end{methoddescni}
 
-\begin{funcdescni}{end_\var{tag}}{}
+\begin{methoddescni}{end_\var{tag}}{}
 This method is called to process a closing tag \var{tag}.
-\end{funcdescni}
+\end{methoddescni}
 
 Note that the parser maintains a stack of open elements for which no
 end tag has been found yet.  Only tags processed by

Doc/lib/libstrio.tex

@@ -3,15 +3,21 @@
 
 \stmodindex{StringIO}
 
-This module implements a file-like class, \code{StringIO},
+This module implements a file-like class, \class{StringIO},
 that reads and writes a string buffer (also known as \emph{memory
 files}). See the description on file objects for operations.
 
-When a \code{StringIO} object is created, it can be initialized
+\begin{classdesc}{StringIO}{\optional{buffer}}
+When a \class{StringIO} object is created, it can be initialized
 to an existing string by passing the string to the constructor.
-If no string is given, the \code{StringIO} will start empty.
+If no string is given, the \class{StringIO} will start empty.
+\end{classdesc}
 
-The method \code{getvalue()} can be called to retrieve the entire
-contents of the ``file'' at any time before the \code{StringIO}
-object's \code{close()} method is called.  Calling \code{close()} will
-free the memory buffer.
+\begin{methoddesc}{getvalue}{}
+Retrieve the entire contents of the ``file'' at any time before the
+\class{StringIO} object's \method{close()} method is called.
+\end{methoddesc}
+
+\begin{methoddesc}{close}{}
+Free the memory buffer.
+\end{methoddesc}

Doc/lib/libtypes.tex

@@ -707,30 +707,28 @@ device or writing a file opened for reading.
 Files have the following methods:
 
 
-\setindexsubitem{(file method)}
-
-\begin{funcdesc}{close}{}
+\begin{methoddesc}[file]{close}{}
   Close the file.  A closed file cannot be read or written anymore.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{flush}{}
+\begin{methoddesc}[file]{flush}{}
   Flush the internal buffer, like \code{stdio}'s \code{fflush()}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{isatty}{}
+\begin{methoddesc}[file]{isatty}{}
   Return \code{1} if the file is connected to a tty(-like) device, else
   \code{0}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{fileno}{}
+\begin{methoddesc}[file]{fileno}{}
 Return the integer ``file descriptor'' that is used by the underlying
 implementation to request I/O operations from the operating system.
 This can be useful for other, lower level interfaces that use file
 descriptors, e.g. module \code{fcntl} or \code{os.read()} and friends.
 \refbimodindex{fcntl}
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{read}{\optional{size}}
+\begin{methoddesc}[file]{read}{\optional{size}}
   Read at most \var{size} bytes from the file (less if the read hits
   \EOF{} or no more data is immediately available on a pipe, tty or
   similar device).  If the \var{size} argument is negative or omitted,
@@ -738,9 +736,9 @@ descriptors, e.g. module \code{fcntl} or \code{os.read()} and friends.
   object.  An empty string is returned when \EOF{} is encountered
   immediately.  (For certain files, like ttys, it makes sense to
   continue reading after an \EOF{} is hit.)
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{readline}{\optional{size}}
+\begin{methoddesc}[file]{readline}{\optional{size}}
   Read one entire line from the file.  A trailing newline character is
   kept in the string%
 \footnote{The advantage of leaving the newline on is that an empty string 
@@ -757,71 +755,71 @@ descriptors, e.g. module \code{fcntl} or \code{os.read()} and friends.
   immediately.  Note: unlike \code{stdio}'s \code{fgets()}, the returned
   string contains null characters (\code{'\e 0'}) if they occurred in the
   input.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{readlines}{\optional{sizehint}}
+\begin{methoddesc}[file]{readlines}{\optional{sizehint}}
   Read until \EOF{} using \code{readline()} and return a list containing
   the lines thus read.  If the optional \var{sizehint} argument is
   present, instead of reading up to \EOF{}, whole lines totalling
   approximately \var{sizehint} bytes (possibly after rounding up to an
   internal buffer size) are read.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{seek}{offset, whence}
+\begin{methoddesc}[file]{seek}{offset, whence}
   Set the file's current position, like \code{stdio}'s \code{fseek()}.
   The \var{whence} argument is optional and defaults to \code{0}
   (absolute file positioning); other values are \code{1} (seek
   relative to the current position) and \code{2} (seek relative to the
   file's end).  There is no return value.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{tell}{}
+\begin{methoddesc}[file]{tell}{}
   Return the file's current position, like \code{stdio}'s \code{ftell()}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{truncate}{\optional{size}}
+\begin{methoddesc}[file]{truncate}{\optional{size}}
 Truncate the file's size.  If the optional size argument present, the
 file is truncated to (at most) that size.  The size defaults to the
 current position.  Availability of this function depends on the
 operating system version (e.g., not all \UNIX{} versions support this
 operation).
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{write}{str}
+\begin{methoddesc}[file]{write}{str}
 Write a string to the file.  There is no return value.  Note: due to
 buffering, the string may not actually show up in the file until
 the \code{flush()} or \code{close()} method is called.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{writelines}{list}
+\begin{methoddesc}[file]{writelines}{list}
 Write a list of strings to the file.  There is no return value.
 (The name is intended to match \code{readlines}; \code{writelines}
 does not add line separators.)
-\end{funcdesc}
+\end{methoddesc}
 
 File objects also offer the following attributes:
 
 \setindexsubitem{(file attribute)}
 
-\begin{datadesc}{closed}
+\begin{memberdesc}[file]{closed}
 Boolean indicating the current state of the file object.  This is a
 read-only attribute; the \method{close()} method changes the value.
-\end{datadesc}
+\end{memberdesc}
 
-\begin{datadesc}{mode}
+\begin{memberdesc}[file]{mode}
 The I/O mode for the file.  If the file was created using the
 \function{open()} built-in function, this will be the value of the
 \var{mode} parameter.  This is a read-only attribute.
-\end{datadesc}
+\end{memberdesc}
 
-\begin{datadesc}{name}
+\begin{memberdesc}[file]{name}
 If the file object was created using \function{open()}, the name of
 the file.  Otherwise, some string that indicates the source of the
 file object, of the form \samp{<\mbox{\ldots}>}.  This is a read-only
 attribute.
-\end{datadesc}
+\end{memberdesc}
 
-\begin{datadesc}{softspace}
+\begin{memberdesc}[file]{softspace}
 Boolean that indicates whether a space character needs to be printed
 before another value when using the \keyword{print} statement.
 Classes that are trying to simulate a file object should also have a
@@ -829,7 +827,7 @@ writable \code{softspace} attribute, which should be initialized to
 zero.  This will be automatic for classes implemented in Python; types
 implemented in \C{} will have to provide a writable \code{softspace}
 attribute.
-\end{datadesc}
+\end{memberdesc}
 
 \subsubsection{Internal Objects}
 

Doc/libhtmllib.tex

@@ -70,53 +70,50 @@ handlers for all HTML 2.0 and many HTML 3.0 and 3.2 elements.
 In addition to tag methods, the \class{HTMLParser} class provides some
 additional methods and instance variables for use within tag methods.
 
-\setindexsubitem{(HTMLParser attribute)}
-
-\begin{datadesc}{formatter}
+\begin{memberdesc}{formatter}
 This is the formatter instance associated with the parser.
-\end{datadesc}
+\end{memberdesc}
 
-\begin{datadesc}{nofill}
+\begin{memberdesc}{nofill}
 Boolean flag which should be true when whitespace should not be
 collapsed, or false when it should be.  In general, this should only
 be true when character data is to be treated as ``preformatted'' text,
 as within a \code{<PRE>} element.  The default value is false.  This
 affects the operation of \method{handle_data()} and \method{save_end()}.
-\end{datadesc}
+\end{memberdesc}
 
-\setindexsubitem{(HTMLParser method)}
 
-\begin{funcdesc}{anchor_bgn}{href, name, type}
+\begin{methoddesc}{anchor_bgn}{href, name, type}
 This method is called at the start of an anchor region.  The arguments
 correspond to the attributes of the \code{<A>} tag with the same
 names.  The default implementation maintains a list of hyperlinks
 (defined by the \code{href} attribute) within the document.  The list
 of hyperlinks is available as the data attribute \code{anchorlist}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{anchor_end}{}
+\begin{methoddesc}{anchor_end}{}
 This method is called at the end of an anchor region.  The default
 implementation adds a textual footnote marker using an index into the
 list of hyperlinks created by \method{anchor_bgn()}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_image}{source, alt\optional{, ismap\optional{, align\optional{, width\optional{, height}}}}}
+\begin{methoddesc}{handle_image}{source, alt\optional{, ismap\optional{, align\optional{, width\optional{, height}}}}}
 This method is called to handle images.  The default implementation
 simply passes the \var{alt} value to the \method{handle_data()}
 method.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{save_bgn}{}
+\begin{methoddesc}{save_bgn}{}
 Begins saving character data in a buffer instead of sending it to the
 formatter object.  Retrieve the stored data via \method{save_end()}.
 Use of the \method{save_bgn()} / \method{save_end()} pair may not be
 nested.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{save_end}{}
+\begin{methoddesc}{save_end}{}
 Ends buffering character data and returns all data saved since the
 preceeding call to \method{save_bgn()}.  If the \code{nofill} flag is
 false, whitespace is collapsed to single spaces.  A call to this
 method without a preceeding call to \method{save_bgn()} will raise a
 \exception{TypeError} exception.
-\end{funcdesc}
+\end{methoddesc}

Doc/libpprint.tex

@@ -142,32 +142,31 @@ l/lib/python1.4/test', '/usr/local/lib/python1.4/sunos5', '/usr/local/lib/python
 
 \class{PrettyPrinter} instances have the following methods:
 
-\setindexsubitem{(PrettyPrinter method)}
 
-\begin{funcdesc}{pformat}{object}
+\begin{methoddesc}{pformat}{object}
 Return the formatted representation of \var{object}.  This takes into
-account the options passed to the \class{PrettyPrinter} constructor.
-\end{funcdesc}
+Account the options passed to the \class{PrettyPrinter} constructor.
+\end{methoddesc}
 
-\begin{funcdesc}{pprint}{object}
+\begin{methoddesc}{pprint}{object}
 Print the formatted representation of \var{object} on the configured
 stream, followed by a newline.
-\end{funcdesc}
+\end{methoddesc}
 
 The following methods provide the implementations for the
 corresponding functions of the same names.  Using these methods on an
 instance is slightly more efficient since new \class{PrettyPrinter}
 objects don't need to be created.
 
-\begin{funcdesc}{isreadable}{object}
+\begin{methoddesc}{isreadable}{object}
 Determine if the formatted representation of the object is
 ``readable,'' or can be used to reconstruct the value using
 \function{eval()}\bifuncindex{eval}.  Note that this returns false for
 recursive objects.  If the \var{depth} parameter of the
 \class{PrettyPrinter} is set and the object is deeper than allowed,
 this returns false.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{isrecursive}{object}
+\begin{methoddesc}{isrecursive}{object}
 Determine if the object requires a recursive representation.
-\end{funcdesc}
+\end{methoddesc}

Doc/libprofile.tex

 \chapter{The Python Profiler}
 \label{profile}
-\stmodindex{profile}
-\stmodindex{pstats}
 
 Copyright \copyright{} 1994, by InfoSeek Corporation, all rights reserved.
 
@@ -256,8 +254,9 @@ of algorithms to be directly compared to iterative implementations.
 
 
 \section{Reference Manual}
+\stmodindex{profile}
+\label{module-profile}
 
-\setindexsubitem{(in module profile)}
 
 The primary entry point for the profiler is the global function
 \function{profile.run()}.  It is typically used to create any profile
@@ -269,7 +268,7 @@ Profiler Extensions, which includes discussion of how to derive
 ``better'' profilers from the classes presented, or reading the source
 code for these modules.
 
-\begin{funcdesc}{profile.run}{string\optional{, filename\optional{, ...}}}
+\begin{funcdesc}{run}{string\optional{, filename\optional{, ...}}}
 
 This function takes a single argument that has can be passed to the
 \keyword{exec} statement, and an optional file name.  In all cases this
@@ -336,7 +335,8 @@ printed.
 Analysis of the profiler data is done using this class from the
 \module{pstats} module:
 
-\setindexsubitem{(in module pstats)}
+% now switch modules....
+\stmodindex{pstats}
 
 \begin{classdesc}{Stats}{filename\optional{, ...}}
 This class constructor creates an instance of a ``statistics object''
@@ -361,7 +361,7 @@ need to be combined with data in an existing \class{Stats} object, the
 
 \setindexsubitem{(Stats method)}
 
-\begin{funcdesc}{strip_dirs}{}
+\begin{methoddesc}{strip_dirs}{}
 This method for the \class{Stats} class removes all leading path
 information from file names.  It is very useful in reducing the size
 of the printout to fit within (close to) 80 columns.  This method
@@ -372,19 +372,19 @@ initialization and loading.  If \method{strip_dirs()} causes two
 function names to be indistinguishable (i.e., they are on the same
 line of the same filename, and have the same function name), then the
 statistics for these two entries are accumulated into a single entry.
-\end{funcdesc}
+\end{methoddesc}
 
 
-\begin{funcdesc}{add}{filename\optional{, ...}}
+\begin{methoddesc}{add}{filename\optional{, ...}}
 This method of the \class{Stats} class accumulates additional
 profiling information into the current profiling object.  Its
 arguments should refer to filenames created by the corresponding
 version of \function{profile.run()}.  Statistics for identically named
 (re: file, line, name) functions are automatically accumulated into
 single function statistics.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{sort_stats}{key\optional{, ...}}
+\begin{methoddesc}{sort_stats}{key\optional{, ...}}
 This method modifies the \class{Stats} object by sorting it according
 to the supplied criteria.  The argument is typically a string
 identifying the basis of a sort (example: \code{"time"} or
@@ -430,18 +430,18 @@ interpreted as \code{"stdname"}, \code{"calls"}, \code{"time"}, and
 \code{"cumulative"} respectively.  If this old style format (numeric)
 is used, only one sort key (the numeric key) will be used, and
 additional arguments will be silently ignored.
-\end{funcdesc}
+\end{methoddesc}
 
 
-\begin{funcdesc}{reverse_order}{}
+\begin{methoddesc}{reverse_order}{}
 This method for the \class{Stats} class reverses the ordering of the basic
 list within the object.  This method is provided primarily for
 compatibility with the old profiler.  Its utility is questionable
 now that ascending vs descending order is properly selected based on
 the sort key of choice.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{print_stats}{restriction\optional{, ...}}
+\begin{methoddesc}{print_stats}{restriction\optional{, ...}}
 This method for the \class{Stats} class prints out a report as described
 in the \function{profile.run()} definition.
 
@@ -473,10 +473,10 @@ print_stats("foo:", .1)
 
 would limit the list to all functions having file names \samp{.*foo:},
 and then proceed to only print the first 10\% of them.
-\end{funcdesc}
+\end{methoddesc}
 
 
-\begin{funcdesc}{print_callers}{restrictions\optional{, ...}}
+\begin{methoddesc}{print_callers}{restrictions\optional{, ...}}
 This method for the \class{Stats} class prints a list of all functions
 that called each function in the profiled database.  The ordering is
 identical to that provided by \method{print_stats()}, and the definition
@@ -484,16 +484,16 @@ of the restricting argument is also identical.  For convenience, a
 number is shown in parentheses after each caller to show how many
 times this specific call was made.  A second non-parenthesized number
 is the cumulative time spent in the function at the right.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{print_callees}{restrictions\optional{, ...}}
+\begin{methoddesc}{print_callees}{restrictions\optional{, ...}}
 This method for the \class{Stats} class prints a list of all function
 that were called by the indicated function.  Aside from this reversal
 of direction of calls (re: called vs was called by), the arguments and
 ordering are identical to the \method{print_callers()} method.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{ignore}{}
+\begin{methoddesc}{ignore}{}
 This method of the \class{Stats} class is used to dispose of the value
 returned by earlier methods.  All standard methods in this class
 return the instance that is being processed, so that the commands can
@@ -503,7 +503,7 @@ be strung together.  For example:
 pstats.Stats('foofile').strip_dirs().sort_stats('cum') \
                        .print_stats().ignore()
 \end{verbatim}
-%
+
 would perform all the indicated functions, but it would not return
 the final reference to the \class{Stats} instance.%
 \footnote{
@@ -511,7 +511,7 @@ This was once necessary, when Python would print any unused expression
 result that was not \code{None}.  The method is still defined for
 backward compatibility.
 }
-\end{funcdesc}
+\end{methoddesc}
 
 
 \section{Limitations}

Doc/libqueue.tex

@@ -37,34 +37,32 @@ other queue organizations (e.g. stack) but the inheritable interface
 is not described here.  See the source code for details.  The public
 methods are:
 
-\setindexsubitem{(Queue method)}
-
-\begin{funcdesc}{qsize}{}
+\begin{methoddesc}{qsize}{}
 Returns the approximate size of the queue.  Because of multithreading
 semantics, this number is not reliable.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{empty}{}
+\begin{methoddesc}{empty}{}
 Returns \code{1} if the queue is empty, \code{0} otherwise.  Because
 of multithreading semantics, this is not reliable.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{full}{}
+\begin{methoddesc}{full}{}
 Returns \code{1} if the queue is full, \code{0} otherwise.  Because of
 multithreading semantics, this is not reliable.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{put}{item}
+\begin{methoddesc}{put}{item}
 Puts \var{item} into the queue.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{get}{}
+\begin{methoddesc}{get}{}
 Gets and returns an item from the queue, blocking if necessary until
 one is available.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{get_nowait}{}
+\begin{methoddesc}{get_nowait}{}
 Gets and returns an item from the queue if one is immediately
 available.  Raises an \exception{Empty} exception if the queue is
 empty or if the queue's emptiness cannot be determined.
-\end{funcdesc}
+\end{methoddesc}

Doc/libsgmllib.tex

@@ -38,37 +38,36 @@ spaces, tabs, and newlines are allowed between the trailing
 
 \class{SGMLParser} instances have the following interface methods:
 
-\setindexsubitem{(SGMLParser method)}
 
-\begin{funcdesc}{reset}{}
+\begin{methoddesc}{reset}{}
 Reset the instance.  Loses all unprocessed data.  This is called
 implicitly at instantiation time.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{setnomoretags}{}
+\begin{methoddesc}{setnomoretags}{}
 Stop processing tags.  Treat all following input as literal input
 (CDATA).  (This is only provided so the HTML tag \code{<PLAINTEXT>}
 can be implemented.)
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{setliteral}{}
+\begin{methoddesc}{setliteral}{}
 Enter literal mode (CDATA mode).
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{feed}{data}
+\begin{methoddesc}{feed}{data}
 Feed some text to the parser.  It is processed insofar as it consists
 of complete elements; incomplete data is buffered until more data is
 fed or \method{close()} is called.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{close}{}
+\begin{methoddesc}{close}{}
 Force processing of all buffered data as if it were followed by an
 end-of-file mark.  This method may be redefined by a derived class to
 define additional processing at the end of the input, but the
 redefined version should always call \method{close()}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_starttag}{tag, method, attributes}
+\begin{methoddesc}{handle_starttag}{tag, method, attributes}
 This method is called to handle start tags for which either a
 \code{start_\var{tag}()} or \code{do_\var{tag}()} method has been
 defined.  The \var{tag} argument is the name of the tag converted to
@@ -82,9 +81,9 @@ instance, for the tag \code{<A HREF="http://www.cwi.nl/">}, this
 method would be called as \samp{unknown_starttag('a', [('href',
 'http://www.cwi.nl/')])}.  The base implementation simply calls
 \var{method} with \var{attributes} as the only argument.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_endtag}{tag, method}
+\begin{methoddesc}{handle_endtag}{tag, method}
 This method is called to handle endtags for which an
 \code{end_\var{tag}()} method has been defined.  The \var{tag}
 argument is the name of the tag converted to lower case, and the
@@ -93,15 +92,15 @@ support semantic interpretation of the end tag.  If no
 \code{end_\var{tag}()} method is defined for the closing element,
 this handler is not called.  The base implementation simply calls
 \var{method}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_data}{data}
+\begin{methoddesc}{handle_data}{data}
 This method is called to process arbitrary data.  It is intended to be
 overridden by a derived class; the base class implementation does
 nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_charref}{ref}
+\begin{methoddesc}{handle_charref}{ref}
 This method is called to process a character reference of the form
 \samp{\&\#\var{ref};}.  In the base implementation, \var{ref} must
 be a decimal number in the
@@ -111,9 +110,9 @@ method \method{handle_data()} with the character as argument.  If
 \code{unknown_charref(\var{ref})} is called to handle the error.  A
 subclass must override this method to provide support for named
 character entities.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_entityref}{ref}
+\begin{methoddesc}{handle_entityref}{ref}
 This method is called to process a general entity reference of the
 form \samp{\&\var{ref};} where \var{ref} is an general entity
 reference.  It looks for \var{ref} in the instance (or class)
@@ -124,46 +123,46 @@ with the translation; otherwise, it calls the method
 \code{unknown_entityref(\var{ref})}.  The default \member{entitydefs}
 defines translations for \code{\&amp;}, \code{\&apos}, \code{\&gt;},
 \code{\&lt;}, and \code{\&quot;}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{handle_comment}{comment}
+\begin{methoddesc}{handle_comment}{comment}
 This method is called when a comment is encountered.  The
 \var{comment} argument is a string containing the text between the
 \samp{<!--} and \samp{-->} delimiters, but not the delimiters
 themselves.  For example, the comment \samp{<!--text-->} will
 cause this method to be called with the argument \code{'text'}.  The
 default method does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{report_unbalanced}{tag}
+\begin{methoddesc}{report_unbalanced}{tag}
 This method is called when an end tag is found which does not
 correspond to any open element.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{unknown_starttag}{tag, attributes}
+\begin{methoddesc}{unknown_starttag}{tag, attributes}
 This method is called to process an unknown start tag.  It is intended
 to be overridden by a derived class; the base class implementation
 does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{unknown_endtag}{tag}
+\begin{methoddesc}{unknown_endtag}{tag}
 This method is called to process an unknown end tag.  It is intended
 to be overridden by a derived class; the base class implementation
 does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{unknown_charref}{ref}
+\begin{methoddesc}{unknown_charref}{ref}
 This method is called to process unresolvable numeric character
 references.  Refer to \method{handle_charref()} to determine what is
 handled by default.  It is intended to be overridden by a derived
 class; the base class implementation does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{unknown_entityref}{ref}
+\begin{methoddesc}{unknown_entityref}{ref}
 This method is called to process an unknown entity reference.  It is
 intended to be overridden by a derived class; the base class
 implementation does nothing.
-\end{funcdesc}
+\end{methoddesc}
 
 Apart from overriding or extending the methods listed above, derived
 classes may also define methods of the following form to define
@@ -171,22 +170,22 @@ processing of specific tags.  Tag names in the input stream are case
 independent; the \var{tag} occurring in method names must be in lower
 case:
 
-\begin{funcdescni}{start_\var{tag}}{attributes}
+\begin{methoddescni}{start_\var{tag}}{attributes}
 This method is called to process an opening tag \var{tag}.  It has
 preference over \code{do_\var{tag}()}.  The \var{attributes}
 argument has the same meaning as described for
 \method{handle_starttag()} above.
-\end{funcdescni}
+\end{methoddescni}
 
-\begin{funcdescni}{do_\var{tag}}{attributes}
+\begin{methoddescni}{do_\var{tag}}{attributes}
 This method is called to process an opening tag \var{tag} that does
 not come with a matching closing tag.  The \var{attributes} argument
 has the same meaning as described for \method{handle_starttag()} above.
-\end{funcdescni}
+\end{methoddescni}
 
-\begin{funcdescni}{end_\var{tag}}{}
+\begin{methoddescni}{end_\var{tag}}{}
 This method is called to process a closing tag \var{tag}.
-\end{funcdescni}
+\end{methoddescni}
 
 Note that the parser maintains a stack of open elements for which no
 end tag has been found yet.  Only tags processed by

Doc/libstrio.tex

@@ -3,15 +3,21 @@
 
 \stmodindex{StringIO}
 
-This module implements a file-like class, \code{StringIO},
+This module implements a file-like class, \class{StringIO},
 that reads and writes a string buffer (also known as \emph{memory
 files}). See the description on file objects for operations.
 
-When a \code{StringIO} object is created, it can be initialized
+\begin{classdesc}{StringIO}{\optional{buffer}}
+When a \class{StringIO} object is created, it can be initialized
 to an existing string by passing the string to the constructor.
-If no string is given, the \code{StringIO} will start empty.
+If no string is given, the \class{StringIO} will start empty.
+\end{classdesc}
 
-The method \code{getvalue()} can be called to retrieve the entire
-contents of the ``file'' at any time before the \code{StringIO}
-object's \code{close()} method is called.  Calling \code{close()} will
-free the memory buffer.
+\begin{methoddesc}{getvalue}{}
+Retrieve the entire contents of the ``file'' at any time before the
+\class{StringIO} object's \method{close()} method is called.
+\end{methoddesc}
+
+\begin{methoddesc}{close}{}
+Free the memory buffer.
+\end{methoddesc}

Doc/libtypes.tex

@@ -707,30 +707,28 @@ device or writing a file opened for reading.
 Files have the following methods:
 
 
-\setindexsubitem{(file method)}
-
-\begin{funcdesc}{close}{}
+\begin{methoddesc}[file]{close}{}
   Close the file.  A closed file cannot be read or written anymore.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{flush}{}
+\begin{methoddesc}[file]{flush}{}
   Flush the internal buffer, like \code{stdio}'s \code{fflush()}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{isatty}{}
+\begin{methoddesc}[file]{isatty}{}
   Return \code{1} if the file is connected to a tty(-like) device, else
   \code{0}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{fileno}{}
+\begin{methoddesc}[file]{fileno}{}
 Return the integer ``file descriptor'' that is used by the underlying
 implementation to request I/O operations from the operating system.
 This can be useful for other, lower level interfaces that use file
 descriptors, e.g. module \code{fcntl} or \code{os.read()} and friends.
 \refbimodindex{fcntl}
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{read}{\optional{size}}
+\begin{methoddesc}[file]{read}{\optional{size}}
   Read at most \var{size} bytes from the file (less if the read hits
   \EOF{} or no more data is immediately available on a pipe, tty or
   similar device).  If the \var{size} argument is negative or omitted,
@@ -738,9 +736,9 @@ descriptors, e.g. module \code{fcntl} or \code{os.read()} and friends.
   object.  An empty string is returned when \EOF{} is encountered
   immediately.  (For certain files, like ttys, it makes sense to
   continue reading after an \EOF{} is hit.)
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{readline}{\optional{size}}
+\begin{methoddesc}[file]{readline}{\optional{size}}
   Read one entire line from the file.  A trailing newline character is
   kept in the string%
 \footnote{The advantage of leaving the newline on is that an empty string 
@@ -757,71 +755,71 @@ descriptors, e.g. module \code{fcntl} or \code{os.read()} and friends.
   immediately.  Note: unlike \code{stdio}'s \code{fgets()}, the returned
   string contains null characters (\code{'\e 0'}) if they occurred in the
   input.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{readlines}{\optional{sizehint}}
+\begin{methoddesc}[file]{readlines}{\optional{sizehint}}
   Read until \EOF{} using \code{readline()} and return a list containing
   the lines thus read.  If the optional \var{sizehint} argument is
   present, instead of reading up to \EOF{}, whole lines totalling
   approximately \var{sizehint} bytes (possibly after rounding up to an
   internal buffer size) are read.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{seek}{offset, whence}
+\begin{methoddesc}[file]{seek}{offset, whence}
   Set the file's current position, like \code{stdio}'s \code{fseek()}.
   The \var{whence} argument is optional and defaults to \code{0}
   (absolute file positioning); other values are \code{1} (seek
   relative to the current position) and \code{2} (seek relative to the
   file's end).  There is no return value.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{tell}{}
+\begin{methoddesc}[file]{tell}{}
   Return the file's current position, like \code{stdio}'s \code{ftell()}.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{truncate}{\optional{size}}
+\begin{methoddesc}[file]{truncate}{\optional{size}}
 Truncate the file's size.  If the optional size argument present, the
 file is truncated to (at most) that size.  The size defaults to the
 current position.  Availability of this function depends on the
 operating system version (e.g., not all \UNIX{} versions support this
 operation).
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{write}{str}
+\begin{methoddesc}[file]{write}{str}
 Write a string to the file.  There is no return value.  Note: due to
 buffering, the string may not actually show up in the file until
 the \code{flush()} or \code{close()} method is called.
-\end{funcdesc}
+\end{methoddesc}
 
-\begin{funcdesc}{writelines}{list}
+\begin{methoddesc}[file]{writelines}{list}
 Write a list of strings to the file.  There is no return value.
 (The name is intended to match \code{readlines}; \code{writelines}
 does not add line separators.)
-\end{funcdesc}
+\end{methoddesc}
 
 File objects also offer the following attributes:
 
 \setindexsubitem{(file attribute)}
 
-\begin{datadesc}{closed}
+\begin{memberdesc}[file]{closed}
 Boolean indicating the current state of the file object.  This is a
 read-only attribute; the \method{close()} method changes the value.
-\end{datadesc}
+\end{memberdesc}
 
-\begin{datadesc}{mode}
+\begin{memberdesc}[file]{mode}
 The I/O mode for the file.  If the file was created using the
 \function{open()} built-in function, this will be the value of the
 \var{mode} parameter.  This is a read-only attribute.
-\end{datadesc}
+\end{memberdesc}
 
-\begin{datadesc}{name}
+\begin{memberdesc}[file]{name}
 If the file object was created using \function{open()}, the name of
 the file.  Otherwise, some string that indicates the source of the
 file object, of the form \samp{<\mbox{\ldots}>}.  This is a read-only
 attribute.
-\end{datadesc}
+\end{memberdesc}
 
-\begin{datadesc}{softspace}
+\begin{memberdesc}[file]{softspace}
 Boolean that indicates whether a space character needs to be printed
 before another value when using the \keyword{print} statement.
 Classes that are trying to simulate a file object should also have a
@@ -829,7 +827,7 @@ writable \code{softspace} attribute, which should be initialized to
 zero.  This will be automatic for classes implemented in Python; types
 implemented in \C{} will have to provide a writable \code{softspace}
 attribute.
-\end{datadesc}
+\end{memberdesc}
 
 \subsubsection{Internal Objects}