mass changes; fix titles; add examples; correct typos; clarifications;
unified style; etc.
diff --git a/Doc/libregex.tex b/Doc/libregex.tex
index dae6666..1b18679 100644
--- a/Doc/libregex.tex
+++ b/Doc/libregex.tex
@@ -44,12 +44,13 @@
\begin{funcdesc}{compile}{pattern\optional{\, translate}}
Compile a regular expression pattern into a regular expression
object, which can be used for matching using its \code{match} and
- \code{search} methods, described below. The optional
+ \code{search} methods, described below. The optional argument
\var{translate}, if present, must be a 256-character string
indicating how characters (both of the pattern and of the strings to
be matched) are translated before comparing them; the \code{i}-th
element of the string gives the translation for the character with
- ASCII code \code{i}.
+ \ASCII{} code \code{i}. This can be used to implement
+ case-insensitive matching; see the \code{casefold} data item below.
The sequence