summaryrefslogtreecommitdiffstats
path: root/Doc/mac
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1995-04-10 11:34:00 (GMT)
committerGuido van Rossum <guido@python.org>1995-04-10 11:34:00 (GMT)
commit96628a90c47f15f357b31d665a4222d175e17b27 (patch)
tree74d6ef8384b587b2526d7c24adbf2f7d4e77bc93 /Doc/mac
parenteae3f73b1c86fecfcb3d2b5599a5efd5ddf87306 (diff)
downloadcpython-96628a90c47f15f357b31d665a4222d175e17b27.zip
cpython-96628a90c47f15f357b31d665a4222d175e17b27.tar.gz
cpython-96628a90c47f15f357b31d665a4222d175e17b27.tar.bz2
typos, layout and other small things
Diffstat (limited to 'Doc/mac')
-rw-r--r--Doc/mac/libctb.tex2
-rw-r--r--Doc/mac/libmacdnr.tex39
-rw-r--r--Doc/mac/libmacspeech.tex3
-rw-r--r--Doc/mac/libmactcp.tex3
4 files changed, 25 insertions, 22 deletions
diff --git a/Doc/mac/libctb.tex b/Doc/mac/libctb.tex
index 1cda336..a5aab71 100644
--- a/Doc/mac/libctb.tex
+++ b/Doc/mac/libctb.tex
@@ -4,7 +4,7 @@
This module provides a partial interface to the Macintosh
Communications Toolbox. Currently, only Connection Manager tools are
-supported.
+supported. It may not be available in all Mac Python versions.
\begin{datadesc}{error}
The exception raised on errors.
diff --git a/Doc/mac/libmacdnr.tex b/Doc/mac/libmacdnr.tex
index cd3625c..ab45788 100644
--- a/Doc/mac/libmacdnr.tex
+++ b/Doc/mac/libmacdnr.tex
@@ -3,57 +3,58 @@
\bimodindex{macdnr}
This module provides an interface to the Macintosh Domain Name
-Resolver. It is usually used in conjunction with the \var{mactcp} module, to
-map hostnames to IP-addresses.
+Resolver. It is usually used in conjunction with the \var{mactcp}
+module, to map hostnames to IP-addresses. It may not be available in
+all Mac Python versions.
The \code{macdnr} module defines the following functions:
\renewcommand{\indexsubitem}{(in module macdnr)}
\begin{funcdesc}{Open}{\optional{filename}}
-Open the domain name resolver extension. If \var{filename} is given it
+Open the domain name resolver extension. If \var{filename} is given it
should be the pathname of the extension, otherwise a default is
-used. Normally, this call is not needed since the other calls will
+used. Normally, this call is not needed since the other calls will
open the extension automatically.
\end{funcdesc}
\begin{funcdesc}{Close}{}
-Close the resolver extension. Again, not needed for normal use.
+Close the resolver extension. Again, not needed for normal use.
\end{funcdesc}
\begin{funcdesc}{StrToAddr}{hostname}
-Look up the IP address for \var{hostname}. This call returns a dnr
+Look up the IP address for \var{hostname}. This call returns a dnr
result object of the ``address'' variation.
\end{funcdesc}
\begin{funcdesc}{AddrToName}{addr}
Do a reverse lookup on the 32-bit integer IP-address
-\var{addr}. Returns a dnr result object of the ``address'' variation.
+\var{addr}. Returns a dnr result object of the ``address'' variation.
\end{funcdesc}
\begin{funcdesc}{AddrToStr}{addr}
Convert the 32-bit integer IP-address \var{addr} to a dotted-decimal
-string. Returns the string.
+string. Returns the string.
\end{funcdesc}
\begin{funcdesc}{HInfo}{hostname}
Query the nameservers for a \code{HInfo} record for host
-\var{hostname}. These records contain hardware and software
+\var{hostname}. These records contain hardware and software
information about the machine in question (if they are available in
-the first place). Returns a dnr result object of the ``hinfo''
+the first place). Returns a dnr result object of the ``hinfo''
variety.
\end{funcdesc}
\begin{funcdesc}{MXInfo}{domain}
-Query the nameservers for a mail exchanger for \var{domain}. This is
+Query the nameservers for a mail exchanger for \var{domain}. This is
the hostname of a host willing to accept SMTP mail for the given
-domain. Returns a dnr result object of the ``mx'' variety.
+domain. Returns a dnr result object of the ``mx'' variety.
\end{funcdesc}
\subsection{dnr result object}
Since the DNR calls all execute asynchronously you do not get the
-results back immedeately. In stead, you get a dnr result object. You
+results back immediately. Instead, you get a dnr result object. You
can check this object to see whether the query is complete, and access
its attributes to obtain the information when it is.
@@ -89,23 +90,23 @@ The canonical name of the host that was queried.
\dataline{ip1}
\dataline{ip2}
\dataline{ip3}
-At most four integer IP addresses for this host. Unused entries are
-zero. Valid only for address queries.
+At most four integer IP addresses for this host. Unused entries are
+zero. Valid only for address queries.
\end{datadesc}
\begin{datadesc}{cpuType}
\dataline{osType}
-Textual strings giving the machine type an OS name. Valid for hinfo
+Textual strings giving the machine type an OS name. Valid for hinfo
queries.
\end{datadesc}
\begin{datadesc}{exchange}
-The name of a mail-exchanger host. Valid for mx queries.
+The name of a mail-exchanger host. Valid for mx queries.
\end{datadesc}
\begin{datadesc}{preference}
-The preference of this mx record. Not too useful, since the Macintosh
-will only return a single mx record. Mx queries only.
+The preference of this mx record. Not too useful, since the Macintosh
+will only return a single mx record. Mx queries only.
\end{datadesc}
The simplest way to use the module to convert names to dotted-decimal
diff --git a/Doc/mac/libmacspeech.tex b/Doc/mac/libmacspeech.tex
index 7480482..fc35520 100644
--- a/Doc/mac/libmacspeech.tex
+++ b/Doc/mac/libmacspeech.tex
@@ -7,7 +7,8 @@ This module provides an interface to the Macintosh Speech Manager,
allowing you to let the Macintosh utter phrases. You need a version of
the speech manager extension (version 1 and 2 have been tested) in
your \code{Extensions} folder for this to work. The module does not
-provide full access to all features of the Speech Manager yet.
+provide full access to all features of the Speech Manager yet. It may
+not be available in all Mac Python versions.
\begin{funcdesc}{Available}{}
Test availability of the Speech Manager extension (and, on the
diff --git a/Doc/mac/libmactcp.tex b/Doc/mac/libmactcp.tex
index 561284b..6c5a78b 100644
--- a/Doc/mac/libmactcp.tex
+++ b/Doc/mac/libmactcp.tex
@@ -8,7 +8,8 @@ MacTCP\@. There is an accompanying module \code{macdnr} which provides an
interface to the name-server (allowing you to translate hostnames to
ip-addresses), a module \code{MACTCP} which has symbolic names for
constants constants used by MacTCP and a wrapper module \code{socket}
-which mimics the \UNIX{} socket interface (as far as possible).
+which mimics the \UNIX{} socket interface (as far as possible). It may
+not be available in all Mac Python versions.
A complete description of the MacTCP interface can be found in the
Apple MacTCP API documentation.