Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
translation more difficult, as well as reading the English more difficult for non-native speakers. Add an index entry for the Telnet protocol. Always refer to the protocol as Telnet instead of telnet.
This commit is contained in:
parent
40fb452be9
commit
ab1df4fe88
|
@ -5,13 +5,15 @@
|
||||||
\modulesynopsis{Telnet client class.}
|
\modulesynopsis{Telnet client class.}
|
||||||
\sectionauthor{Skip Montanaro}{skip@mojam.com}
|
\sectionauthor{Skip Montanaro}{skip@mojam.com}
|
||||||
|
|
||||||
|
\index{protocol!Telnet}
|
||||||
|
|
||||||
The \module{telnetlib} module provides a \class{Telnet} class that
|
The \module{telnetlib} module provides a \class{Telnet} class that
|
||||||
implements the Telnet protocol. See \rfc{854} for details about the
|
implements the Telnet protocol. See \rfc{854} for details about the
|
||||||
protocol.
|
protocol.
|
||||||
|
|
||||||
|
|
||||||
\begin{classdesc}{Telnet}{\optional{host\optional{, port}}}
|
\begin{classdesc}{Telnet}{\optional{host\optional{, port}}}
|
||||||
\class{Telnet} represents a connection to a telnet server. The
|
\class{Telnet} represents a connection to a Telnet server. The
|
||||||
instance is initially not connected by default; the \method{open()}
|
instance is initially not connected by default; the \method{open()}
|
||||||
method must be used to establish a connection. Alternatively, the
|
method must be used to establish a connection. Alternatively, the
|
||||||
host name and optional port number can be passed to the constructor,
|
host name and optional port number can be passed to the constructor,
|
||||||
|
@ -92,7 +94,7 @@ never blocks.
|
||||||
\begin{methoddesc}{open}{host\optional{, port}}
|
\begin{methoddesc}{open}{host\optional{, port}}
|
||||||
Connect to a host.
|
Connect to a host.
|
||||||
The optional second argument is the port number, which
|
The optional second argument is the port number, which
|
||||||
defaults to the standard telnet port (23).
|
defaults to the standard Telnet port (23).
|
||||||
|
|
||||||
Do not try to reopen an already connected instance.
|
Do not try to reopen an already connected instance.
|
||||||
\end{methoddesc}
|
\end{methoddesc}
|
||||||
|
@ -127,7 +129,7 @@ This can block if the connection is blocked. May raise
|
||||||
\end{methoddesc}
|
\end{methoddesc}
|
||||||
|
|
||||||
\begin{methoddesc}{interact}{}
|
\begin{methoddesc}{interact}{}
|
||||||
Interaction function, emulates a very dumb telnet client.
|
Interaction function, emulates a very dumb Telnet client.
|
||||||
\end{methoddesc}
|
\end{methoddesc}
|
||||||
|
|
||||||
\begin{methoddesc}{mt_interact}{}
|
\begin{methoddesc}{mt_interact}{}
|
||||||
|
@ -151,7 +153,7 @@ If end of file is found and no text was read, raise
|
||||||
\code{(-1, None, \var{text})} where \var{text} is the text received so
|
\code{(-1, None, \var{text})} where \var{text} is the text received so
|
||||||
far (may be the empty string if a timeout happened).
|
far (may be the empty string if a timeout happened).
|
||||||
|
|
||||||
If a regular expression ends with a greedy match (e.g. \regexp{.*})
|
If a regular expression ends with a greedy match (such as \regexp{.*})
|
||||||
or if more than one expression can match the same input, the
|
or if more than one expression can match the same input, the
|
||||||
results are indeterministic, and may depend on the I/O timing.
|
results are indeterministic, and may depend on the I/O timing.
|
||||||
\end{methoddesc}
|
\end{methoddesc}
|
||||||
|
|
Loading…
Reference in New Issue