diff options
author | Fred Drake <fdrake@acm.org> | 2001-10-26 03:04:23 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2001-10-26 03:04:23 (GMT) |
commit | 7f10cce4c144fe47575eda395b6e4691ba0cfa21 (patch) | |
tree | 858192bd5089ec0718a90fe5ed4cc816c7e8f72a /Doc | |
parent | 3a2c462436bd03e43dd632058a074ac7e6c448ab (diff) | |
download | cpython-7f10cce4c144fe47575eda395b6e4691ba0cfa21.zip cpython-7f10cce4c144fe47575eda395b6e4691ba0cfa21.tar.gz cpython-7f10cce4c144fe47575eda395b6e4691ba0cfa21.tar.bz2 |
Enforce a bit of markup consistency.
When describing a Boolean return value, use "true" and "false" instead of
"1" and "0".
Style-guide conformance: no "iff" -- to obscure for many readers. ;-(
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/lib/libdifflib.tex | 25 |
1 files changed, 12 insertions, 13 deletions
diff --git a/Doc/lib/libdifflib.tex b/Doc/lib/libdifflib.tex index a669435..15e8c69 100644 --- a/Doc/lib/libdifflib.tex +++ b/Doc/lib/libdifflib.tex @@ -146,21 +146,19 @@ emu \end{funcdesc} -\begin{funcdesc}{IS_LINE_JUNK}{line}: - - Return 1 for ignorable line: iff \var{line} is blank or contains a - single \character{\#}. Used as a default for parameter +\begin{funcdesc}{IS_LINE_JUNK}{line} + Return true for ignorable lines. The line \var{line} is ignorable + if \var{line} is blank or contains a single \character{\#}, + otherwise it is not ignorable. Used as a default for parameter \var{linejunk} in \function{ndiff()}. - \end{funcdesc} -\begin{funcdesc}{IS_CHARACTER_JUNK}{ch}: - - Return 1 for ignorable character: iff \var{ch} is a space or tab. - Used as a default for parameter \var{charjunk} in +\begin{funcdesc}{IS_CHARACTER_JUNK}{ch} + Return true for ignorable characters. The character \var{ch} is + ignorable if \var{ch} is a space or tab, otherwise it is not + ignorable. Used as a default for parameter \var{charjunk} in \function{ndiff()}. - \end{funcdesc} @@ -182,8 +180,9 @@ The \class{SequenceMatcher} class has this constructor: Optional argument \var{isjunk} must be \code{None} (the default) or a one-argument function that takes a sequence element and returns true if and only if the element is ``junk'' and should be ignored. - \code{None} is equivalent to passing \code{lambda x: 0}, i.e.\ no - elements are ignored. For example, pass + Passing \code{None} for \var{b} is equivalent to passing + \code{lambda x: 0}; in other words, no elements are ignored. For + example, pass: \begin{verbatim} lambda x: x in " \t" @@ -445,7 +444,7 @@ The \class{Differ} class has this constructor: for filter functions (or \code{None}): \var{linejunk}: A function that should accept a single string - argument, and return true iff the string is junk. The default is + argument, and return true if the string is junk. The default is module-level function \function{IS_LINE_JUNK()}, which filters out lines without visible characters, except for at most one pound character (\character{\#}). |