summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libnntplib.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>1999-04-22 16:45:26 (GMT)
committerFred Drake <fdrake@acm.org>1999-04-22 16:45:26 (GMT)
commitdd6c6d9b0a5d2bab8f0e4771d9406dd35c035a63 (patch)
tree637d4bb4e76f43eb8409c14adc0215055cad40c7 /Doc/lib/libnntplib.tex
parente2effbd32d56e35ba1789bbf3ca8e85fad37b49a (diff)
downloadcpython-dd6c6d9b0a5d2bab8f0e4771d9406dd35c035a63.zip
cpython-dd6c6d9b0a5d2bab8f0e4771d9406dd35c035a63.tar.gz
cpython-dd6c6d9b0a5d2bab8f0e4771d9406dd35c035a63.tar.bz2
Clean up some mark up.
Diffstat (limited to 'Doc/lib/libnntplib.tex')
-rw-r--r--Doc/lib/libnntplib.tex45
1 files changed, 21 insertions, 24 deletions
diff --git a/Doc/lib/libnntplib.tex b/Doc/lib/libnntplib.tex
index b8d7e5f..cc6dad5 100644
--- a/Doc/lib/libnntplib.tex
+++ b/Doc/lib/libnntplib.tex
@@ -1,13 +1,12 @@
\section{\module{nntplib} ---
- NNTP protocol client.}
-\declaremodule{standard}{nntplib}
+ NNTP protocol client}
+\declaremodule{standard}{nntplib}
\modulesynopsis{NNTP protocol client (requires sockets).}
\indexii{NNTP}{protocol}
\index{Network News Transfer Protocol}
-
This module defines the class \class{NNTP} which implements the client
side of the NNTP protocol. It can be used to implement a news reader
or poster, or automated news processors. For more information on NNTP
@@ -50,7 +49,7 @@ valid headers):
>>> s.quit()
'205 news.cwi.nl closing connection. Goodbye.'
\end{verbatim}
-%
+
The module itself defines the following items:
\begin{classdesc}{NNTP}{host\optional{, port
@@ -58,9 +57,9 @@ The module itself defines the following items:
Return a new instance of the \class{NNTP} class, representing a
connection to the NNTP server running on host \var{host}, listening at
port \var{port}. The default \var{port} is 119. If the optional
-\var{user} and \var{password} are provided, the \samp{AUTHINFO USER}
-and \samp{AUTHINFO PASS} commands are used to identify and
-authenticate the user to the server.
+\var{user} and \var{password} are provided, the
+\samp{AUTHINFO USER} and \samp{AUTHINFO PASS} commands are used to
+identify and authenticate the user to the server.
\end{classdesc}
\begin{excdesc}{error_reply}
@@ -81,8 +80,7 @@ not begin with a digit in the range 1--5.
\end{excdesc}
-\subsection{NNTP Objects}
-\label{nntp-objects}
+\subsection{NNTP Objects \label{nntp-objects}}
NNTP instances have the following methods. The \var{response} that is
returned as the first item in the return tuple of almost all methods
@@ -109,9 +107,9 @@ message text).
\begin{methoddesc}{newgroups}{date, time}
Send a \samp{NEWGROUPS} command. The \var{date} argument should be a
-string of the form \code{"\var{yy}\var{mm}\var{dd}"} indicating the
+string of the form \code{'\var{yy}\var{mm}\var{dd}'} indicating the
date, and \var{time} should be a string of the form
-\code{"\var{hh}\var{mm}\var{ss}"} indicating the time. Return a pair
+\code{'\var{hh}\var{mm}\var{ss}'} indicating the time. Return a pair
\code{(\var{response}, \var{groups})} where \var{groups} is a list of
group names that are new since the given date and time.
\end{methoddesc}
@@ -128,19 +126,19 @@ Send a \samp{LIST} command. Return a pair \code{(\var{response},
\var{list})} where \var{list} is a list of tuples. Each tuple has the
form \code{(\var{group}, \var{last}, \var{first}, \var{flag})}, where
\var{group} is a group name, \var{last} and \var{first} are the last
-and first article numbers (as strings), and \var{flag} is \code{'y'}
-if posting is allowed, \code{'n'} if not, and \code{'m'} if the
-newsgroup is moderated. (Note the ordering: \var{last}, \var{first}.)
+and first article numbers (as strings), and \var{flag} is
+\code{'y'} if posting is allowed, \code{'n'} if not, and \code{'m'} if
+the newsgroup is moderated. (Note the ordering: \var{last},
+\var{first}.)
\end{methoddesc}
\begin{methoddesc}{group}{name}
Send a \samp{GROUP} command, where \var{name} is the group name.
-Return a tuple \code{(}\var{response}\code{,} \var{count}\code{,}
-\var{first}\code{,} \var{last}\code{,} \var{name}\code{)} where
-\var{count} is the (estimated) number of articles in the group,
-\var{first} is the first article number in the group, \var{last} is
-the last article number in the group, and \var{name} is the group
-name. The numbers are returned as strings.
+Return a tuple \code{(\var{response}, \var{count}, \var{first},
+\var{last}, \var{name})} where \var{count} is the (estimated) number
+of articles in the group, \var{first} is the first article number in
+the group, \var{last} is the last article number in the group, and
+\var{name} is the group name. The numbers are returned as strings.
\end{methoddesc}
\begin{methoddesc}{help}{}
@@ -191,7 +189,7 @@ Send a \samp{SLAVE} command. Return the server's \var{response}.
Send an \samp{XHDR} command. This command is not defined in the RFC
but is a common extension. The \var{header} argument is a header
keyword, e.g. \code{'subject'}. The \var{string} argument should have
-the form \code{"\var{first}-\var{last}"} where \var{first} and
+the form \code{'\var{first}-\var{last}'} where \var{first} and
\var{last} are the first and last article numbers to search. Return a
pair \code{(\var{response}, \var{list})}, where \var{list} is a list of
pairs \code{(\var{id}, \var{text})}, where \var{id} is an article id
@@ -233,9 +231,8 @@ servers.
Return a pair \code{(\var{resp}, \var{list})}. \var{list} is a list
of tuples, one for each article in the range delimited by the \var{start}
and \var{end} article numbers. Each tuple is of the form
-\code{(}\var{article number}\code{,} \var{subject}\code{,}
-\var{poster}\code{,} \var{date}\code{,} \var{id}\code{,}
-\var{references}\code{,} \var{size}\code{,} \var{lines}\code{)}.
+\code{(\var{article number}, \var{subject}, \var{poster}, \var{date},
+\var{id}, \var{references}, \var{size}, \var{lines})}.
This is an optional NNTP extension, and may not be supported by all
servers.
\end{methoddesc}