mirror of
https://github.com/python/cpython.git
synced 2025-07-24 03:35:53 +00:00
(libhtmllib.tex, libsgmllib.tex, libformatter.tex):
Improve indexing somewhat. Add small intros to the "implementations" sections of the formatter module doc.
This commit is contained in:
parent
7edd8d3c58
commit
8f925959c6
6 changed files with 58 additions and 12 deletions
|
@ -46,11 +46,15 @@ be called without having to track whether the property was changed.
|
|||
|
||||
The following attributes are defined for formatter instance objects:
|
||||
|
||||
\renewcommand{\indexsubitem}{(formatter object data)}
|
||||
|
||||
\begin{datadesc}{writer}
|
||||
The writer instance with which the formatter interacts.
|
||||
\end{datadesc}
|
||||
|
||||
|
||||
\renewcommand{\indexsubitem}{(formatter object method)}
|
||||
|
||||
\begin{funcdesc}{end_paragraph}{blanklines}
|
||||
Close any open paragraphs and insert at least \code{blanklines}
|
||||
before the next paragraph.
|
||||
|
@ -178,16 +182,25 @@ output.
|
|||
|
||||
\subsection{Formatter Implementations}
|
||||
|
||||
Two implementations of formatter objects are provided by this module.
|
||||
Most applications may use one of these classes without modification or
|
||||
subclassing.
|
||||
|
||||
\renewcommand{\indexsubitem}{(in module formatter)}
|
||||
|
||||
\begin{funcdesc}{NullFormatter}{\optional{writer\code{ = None}}}
|
||||
A formatter which does nothing. If \code{writer} is omitted, a
|
||||
\code{NullWriter} instance is created. No methods of the writer are
|
||||
called by \code{NullWriter} instances.
|
||||
called by \code{NullWriter} instances. Implementations should inherit
|
||||
from this class if implementing a writer interface but don't need to
|
||||
inherit any implementation.
|
||||
\end{funcdesc}
|
||||
|
||||
\begin{funcdesc}{AbstractFormatter}{writer}
|
||||
The standard formatter. This implementation has demonstrated wide
|
||||
applicability to many writers, and may be used directly in most
|
||||
circumstances.
|
||||
circumstances. It has been used to implement a full-featured
|
||||
world-wide web browser.
|
||||
\end{funcdesc}
|
||||
|
||||
|
||||
|
@ -201,6 +214,8 @@ Note that while most applications can use the \code{AbstractFormatter}
|
|||
class as a formatter, the writer must typically be provided by the
|
||||
application.
|
||||
|
||||
\renewcommand{\indexsubitem}{(writer object method)}
|
||||
|
||||
\begin{funcdesc}{new_alignment}{align}
|
||||
Set the alignment style. The \code{align} value can be any object,
|
||||
but by convention is a string or \code{None}, where \code{None}
|
||||
|
@ -283,6 +298,12 @@ will only be called at the beginning of a line.
|
|||
|
||||
\subsection{Writer Implementations}
|
||||
|
||||
Three implementations of the writer object interface are provided as
|
||||
examples by this module. Most applications will need to derive new
|
||||
writer classes from the \code{NullWriter} class.
|
||||
|
||||
\renewcommand{\indexsubitem}{(in module formatter)}
|
||||
|
||||
\begin{funcdesc}{NullWriter}{}
|
||||
A writer which only provides the interface definition; no actions are
|
||||
taken on any methods. This should be the base class for all writers
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue