Finish a sentence that was left half-written!

Doc/lib/xmlsax.tex

@@ -43,25 +43,29 @@ The convenience functions are:
 \end{funcdesc}
 
 A typical SAX application uses three kinds of objects: readers,
-handlers and input sources. ``Reader'' in this context is another term
+handlers and input sources.  ``Reader'' in this context is another
-for parser, ie. some piece of code that reads the bytes or characters
+term for parser, i.e.\ some piece of code that reads the bytes or
-from the input source, and produces a sequence of events. The events
+characters from the input source, and produces a sequence of events.
-then get distributed to the handler objects, ie. the reader invokes a
+The events then get distributed to the handler objects, i.e.\ the
-method on the handler. A SAX application must therefore obtain a
+reader invokes a method on the handler.  A SAX application must
-handler object, create or open the input sources, create the handlers,
+therefore obtain a reader object, create or open the input sources,
-and connect these objects all together. As the final step, parsing is
+create the handlers, and connect these objects all together.  As the
-invoked. During parsing
+final step of preparation, the reader is called to parse the input.
+During parsing, methods on the handler objects are called based on
+structural and syntactic events from the input data.
 
 For these objects, only the interfaces are relevant; they are normally
 not instantiated by the application itself.  Since Python does not have
 an explicit notion of interface, they are formally introduced as
-classes. The \class{InputSource}, \class{Locator},
+classes, but applications may use implementations which do not inherit
-\class{AttributesImpl}, and \class{XMLReader} interfaces are defined
+from the provided classes.  The \class{InputSource}, \class{Locator},
-in the module \refmodule{xml.sax.xmlreader}. The handler interfaces
+\class{AttributesImpl}, \class{AttributesNSImpl}, and
-are defined in \refmodule{xml.sax.handler}. For convenience,
+\class{XMLReader} interfaces are defined in the module
-\class{InputSource} (which is often instantiated directly) and the
+\refmodule{xml.sax.xmlreader}.  The handler interfaces are defined in
-handler classes are also available from \module{xml.sax}.  These
+\refmodule{xml.sax.handler}.  For convenience, \class{InputSource}
-classes are described below.
+(which is often instantiated directly) and the handler classes are
+also available from \module{xml.sax}.  These interfaces are described
+below.
 
 In addition to these classes, \module{xml.sax} provides the following
 exception classes.