mass changes; fix titles; add examples; correct typos; clarifications;
unified style; etc.
diff --git a/Doc/libstdwin.tex b/Doc/libstdwin.tex
index df37707..29b047a 100644
--- a/Doc/libstdwin.tex
+++ b/Doc/libstdwin.tex
@@ -8,9 +8,10 @@
Interface, STDWIN [CWI report CR-R8817].
It is available on systems to which STDWIN has been ported (which is
most systems).
-It is only available if the \code{DISPLAY} environment variable is set
-or an explicit \samp{-display \var{displayname}} argument is passed to
-the interpreter.
+
+On Unix running X11, it can only be used if the \code{DISPLAY}
+environment variable is set or an explicit \samp{-display
+\var{displayname}} argument is passed to the Python interpreter.
Functions have names that usually resemble their C STDWIN counterparts
with the initial `w' dropped.
@@ -63,6 +64,7 @@
in resource definitions), i.e. the wildcard character \code{'*'}
matches any sequence of characters (including none) and \code{'?'}
matches any single character.
+On the Macintosh this function currently returns an empty list.
\end{funcdesc}
\begin{funcdesc}{setdefscrollbars}{hflag\, vflag}
@@ -164,6 +166,7 @@
\begin{funcdesc}{newbitmap}{width\, height}
Create a new bitmap object of the given dimensions.
Methods of bitmap objects are described below.
+Not available on the Macintosh.
\end{funcdesc}
\begin{funcdesc}{fleep}{}
@@ -294,7 +297,7 @@
\ttindex{select}
\end{funcdesc}
-\subsection{Window Object Methods}
+\subsection{Window Objects}
Window objects are created by \code{stdwin.open()}. They are closed
by their \code{close()} method or when they are garbage-collected.
@@ -440,7 +443,7 @@
Discard the window object. It should not be used again.
\end{funcdesc}
-\subsection{Drawing Object Methods}
+\subsection{Drawing Objects}
Drawing objects are created exclusively by the window method
\code{begindrawing()}.
@@ -560,6 +563,7 @@
in the bitmap, in the foreground color, or \code{None}, to draw all
bits (ones are drawn in the foreground color, zeros in the background
color).
+Not available on the Macintosh.
\end{funcdesc}
\begin{funcdesc}{cliprect}{rect}
@@ -582,7 +586,7 @@
Discard the drawing object. It should not be used again.
\end{funcdesc}
-\subsection{Menu Object Methods}
+\subsection{Menu Objects}
A menu object represents a menu.
The menu is destroyed when the menu object is deleted.
@@ -617,11 +621,13 @@
Discard the menu object. It should not be used again.
\end{funcdesc}
-\subsection{Bitmap Object Methods}
+\subsection{Bitmap Objects}
A bitmap represents a rectangular array of bits.
The top left bit has coordinate (0, 0).
A bitmap can be drawn with the \code{bitmap} method of a drawing object.
+Bitmaps are currently not available on the Macintosh.
+
The following methods are defined:
\renewcommand{\indexsubitem}{(bitmap method)}
@@ -644,7 +650,7 @@
Discard the bitmap object. It should not be used again.
\end{funcdesc}
-\subsection{Text-edit Object Methods}
+\subsection{Text-edit Objects}
A text-edit object represents a text-edit block.
For semantics, see the STDWIN documentation for C programmers.