summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>1998-02-23 14:42:00 (GMT)
committerFred Drake <fdrake@acm.org>1998-02-23 14:42:00 (GMT)
commita705da7aa01fb8bc4fa5b6582079bd226e972acc (patch)
treebc25a1984624e381876530b52ed395bd191b4942
parent71f894ad563544fe81105d69e8a2a09256b44bb5 (diff)
downloadcpython-a705da7aa01fb8bc4fa5b6582079bd226e972acc.zip
cpython-a705da7aa01fb8bc4fa5b6582079bd226e972acc.tar.gz
cpython-a705da7aa01fb8bc4fa5b6582079bd226e972acc.tar.bz2
Marked the unmarked AttributeError. (AMK)
"Protect the class instance" --> "Protect the object" It works for anything with attributes to look up! (AMK) Logical markup.
-rw-r--r--Doc/lib/libbastion.tex17
-rw-r--r--Doc/libbastion.tex17
2 files changed, 18 insertions, 16 deletions
diff --git a/Doc/lib/libbastion.tex b/Doc/lib/libbastion.tex
index e9bcc1f..7b7cba6 100644
--- a/Doc/lib/libbastion.tex
+++ b/Doc/lib/libbastion.tex
@@ -11,28 +11,29 @@ According to the dictionary, a bastion is ``a fortified area or
position'', or ``something that is considered a stronghold.'' It's a
suitable name for this module, which provides a way to forbid access
to certain attributes of an object. It must always be used with the
-\code{rexec} module, in order to allow restricted-mode programs access
+\module{rexec} module, in order to allow restricted-mode programs access
to certain safe attributes of an object, while denying access to
other, unsafe attributes.
% I've punted on the issue of documenting keyword arguments for now.
\begin{funcdesc}{Bastion}{object\optional{\, filter\, name\, class}}
-Protect the class instance \var{object}, returning a bastion for the
+Protect the object \var{object}, returning a bastion for the
object. Any attempt to access one of the object's attributes will
have to be approved by the \var{filter} function; if the access is
-denied an AttributeError exception will be raised.
+denied an \exception{AttributeError} exception will be raised.
If present, \var{filter} must be a function that accepts a string
containing an attribute name, and returns true if access to that
attribute will be permitted; if \var{filter} returns false, the access
is denied. The default filter denies access to any function beginning
-with an underscore (\code{_}). The bastion's string representation
-will be \code{<Bastion for \var{name}>} if a value for
-\var{name} is provided; otherwise, \code{repr(\var{object})} will be used.
+with an underscore (\samp{_}). The bastion's string representation
+will be \samp{<Bastion for \var{name}>} if a value for
+\var{name} is provided; otherwise, \samp{repr(\var{object})} will be
+used.
-\var{class}, if present, would be a subclass of \code{BastionClass};
+\var{class}, if present, would be a subclass of \class{BastionClass};
see the code in \file{bastion.py} for the details. Overriding the
-default \code{BastionClass} will rarely be required.
+default \class{BastionClass} will rarely be required.
\end{funcdesc}
diff --git a/Doc/libbastion.tex b/Doc/libbastion.tex
index e9bcc1f..7b7cba6 100644
--- a/Doc/libbastion.tex
+++ b/Doc/libbastion.tex
@@ -11,28 +11,29 @@ According to the dictionary, a bastion is ``a fortified area or
position'', or ``something that is considered a stronghold.'' It's a
suitable name for this module, which provides a way to forbid access
to certain attributes of an object. It must always be used with the
-\code{rexec} module, in order to allow restricted-mode programs access
+\module{rexec} module, in order to allow restricted-mode programs access
to certain safe attributes of an object, while denying access to
other, unsafe attributes.
% I've punted on the issue of documenting keyword arguments for now.
\begin{funcdesc}{Bastion}{object\optional{\, filter\, name\, class}}
-Protect the class instance \var{object}, returning a bastion for the
+Protect the object \var{object}, returning a bastion for the
object. Any attempt to access one of the object's attributes will
have to be approved by the \var{filter} function; if the access is
-denied an AttributeError exception will be raised.
+denied an \exception{AttributeError} exception will be raised.
If present, \var{filter} must be a function that accepts a string
containing an attribute name, and returns true if access to that
attribute will be permitted; if \var{filter} returns false, the access
is denied. The default filter denies access to any function beginning
-with an underscore (\code{_}). The bastion's string representation
-will be \code{<Bastion for \var{name}>} if a value for
-\var{name} is provided; otherwise, \code{repr(\var{object})} will be used.
+with an underscore (\samp{_}). The bastion's string representation
+will be \samp{<Bastion for \var{name}>} if a value for
+\var{name} is provided; otherwise, \samp{repr(\var{object})} will be
+used.
-\var{class}, if present, would be a subclass of \code{BastionClass};
+\var{class}, if present, would be a subclass of \class{BastionClass};
see the code in \file{bastion.py} for the details. Overriding the
-default \code{BastionClass} will rarely be required.
+default \class{BastionClass} will rarely be required.
\end{funcdesc}