If, when coding a module for general use, you need a locale
independent version of an operation that is affected by the locale
-(e.g. \function{string.lower()}, or certain formats used with
-\function{time.strftime()})), you will have to find a way to do it
+(such as \function{string.lower()}, or certain formats used with
+\function{time.strftime()}), you will have to find a way to do it
without using the standard library routine. Even better is convincing
yourself that using locale settings is okay. Only as a last resort
should you document that your module is not compatible with
\begin{methoddesc}{getparam}{name}
Return the \var{value} of the first parameter (as returned by
-\method{getplist()} of the form \samp{\var{name}=\var{value}} for the
+\method{getplist()}) of the form \samp{\var{name}=\var{value}} for the
given \var{name}. If \var{value} is surrounded by quotes of the form
`\code{<}...\code{>}' or `\code{"}...\code{"}', these are removed.
\end{methoddesc}
\begin{datadescni}{XML_ERROR_BAD_CHAR_REF}
A character reference referred to a character which is illegal in XML
-(for example, character \code{0}, or `\code{\&\#0;}'.
+(for example, character \code{0}, or `\code{\&\#0;}').
\end{datadescni}
\begin{datadescni}{XML_ERROR_BINARY_ENTITY_REF}
Formatting methods for specific types are implemented as methods
with a name based on the type name. In the method name, \var{type}
is replaced by
- \code{string.join(string.split(type(\var{obj}).__name__, '_')}.
+ \code{string.join(string.split(type(\var{obj}).__name__, '_'))}.
Dispatch to these methods is handled by \method{repr1()}.
Type-specific methods which need to recursively format a value
should call \samp{self.repr1(\var{subobj}, \var{level} - 1)}.