diff options
Diffstat (limited to 'Doc/lib/libnntplib.tex')
-rw-r--r-- | Doc/lib/libnntplib.tex | 45 |
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} |