From a705da7aa01fb8bc4fa5b6582079bd226e972acc Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Mon, 23 Feb 1998 14:42:00 +0000 Subject: [PATCH] Marked the unmarked AttributeError. (AMK) "Protect the class instance" --> "Protect the object" It works for anything with attributes to look up! (AMK) Logical markup. --- Doc/lib/libbastion.tex | 17 +++++++++-------- Doc/libbastion.tex | 17 +++++++++-------- 2 files changed, 18 insertions(+), 16 deletions(-) diff --git a/Doc/lib/libbastion.tex b/Doc/lib/libbastion.tex index e9bcc1f716..7b7cba6871 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{} 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{} 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 e9bcc1f716..7b7cba6871 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{} 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{} 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} -- 2.40.0