mass changes; fix titles; add examples; correct typos; clarifications;
unified style; etc.
diff --git a/Doc/libsun.tex b/Doc/libsun.tex
index 9624b9c..d297b9c 100644
--- a/Doc/libsun.tex
+++ b/Doc/libsun.tex
@@ -4,7 +4,7 @@
that are unique to the SunOS operating system (versions 4 and 5; the
latter is also known as SOLARIS version 2).
-\section{Built-in module \sectcode{sunaudiodev}}
+\section{Built-in Module \sectcode{sunaudiodev}}
\bimodindex{sunaudiodev}
This module allows you to access the sun audio interface. The sun
@@ -30,7 +30,7 @@
only for the activity needed. See the audio manpage for details.
\end{funcdesc}
-\subsection{Audio device object methods}
+\subsection{Audio Device Objects}
The audio device objects are returned by \code{open} define the
following methods (except \code{control} objects which only provide
@@ -108,6 +108,5 @@
\file{<sun/audioio.h>}, with the leading string \samp{AUDIO_} stripped.
Useability of the control device is limited at the moment, since there
-is no way to use the 'wait for something to happen' feature the device
-provides. This is because that feature makes heavy use of signals, and
-these do not map too well onto Python.
+is no way to use the ``wait for something to happen'' feature the
+device provides.