mass changes; fix titles; add examples; correct typos; clarifications;
unified style; etc.
diff --git a/Doc/libarray.tex b/Doc/libarray.tex
index ea68fb1..9e37d55 100644
--- a/Doc/libarray.tex
+++ b/Doc/libarray.tex
@@ -1,4 +1,4 @@
-\section{Built-in module \sectcode{array}}
+\section{Built-in Module \sectcode{array}}
\bimodindex{array}
\index{arrays}
@@ -21,7 +21,7 @@
The actual representation of values is determined by the machine
architecture (strictly speaking, by the C implementation). The actual
-size can be accessed through the \var{typecode} attribute.
+size can be accessed through the \var{itemsize} attribute.
The module defines the following function:
@@ -59,7 +59,9 @@
Read \var{n} items (as machine values) from the file object \var{f}
and append them to the end of the array. If less than \var{n} items
are available, \code{EOFError} is raised, but the items that were
-available are still inserted into the array.
+available are still inserted into the array. \var{f} must be a real
+built-in file object; something else with a \code{read()} method won't
+do.
\end{funcdesc}
\begin{funcdesc}{fromlist}{list}