[Python-checkins] CVS: python/dist/src/Doc/lib xmlsax.tex,1.2,1.3

Fred L. Drake python-dev@python.org
Wed, 13 Dec 2000 14:36:04 -0800


Update of /cvsroot/python/python/dist/src/Doc/lib
In directory slayer.i.sourceforge.net:/tmp/cvs-serv23015/lib

Modified Files:
	xmlsax.tex 
Log Message:

Finish a sentence that was left half-written!


Index: xmlsax.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/xmlsax.tex,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -r1.2 -r1.3
*** xmlsax.tex	2000/10/12 20:05:09	1.2
--- xmlsax.tex	2000/12/13 22:36:02	1.3
***************
*** 44,66 ****
  
  A typical SAX application uses three kinds of objects: readers,
! handlers and input sources. ``Reader'' in this context is another term
! for parser, ie. some piece of code that reads the bytes or characters
! from the input source, and produces a sequence of events. The events
! then get distributed to the handler objects, ie. the reader invokes a
! method on the handler. A SAX application must therefore obtain a
! handler object, create or open the input sources, create the handlers,
! and connect these objects all together. As the final step, parsing is
! invoked. During parsing
  
  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},
! \class{AttributesImpl}, and \class{XMLReader} interfaces are defined
! in the module \refmodule{xml.sax.xmlreader}. The handler interfaces
! are defined in \refmodule{xml.sax.handler}. For convenience,
! \class{InputSource} (which is often instantiated directly) and the
! handler classes are also available from \module{xml.sax}.  These
! classes are described below.
  
  In addition to these classes, \module{xml.sax} provides the following
--- 44,70 ----
  
  A typical SAX application uses three kinds of objects: readers,
! handlers and input sources.  ``Reader'' in this context is another
! term for parser, i.e.\ some piece of code that reads the bytes or
! characters from the input source, and produces a sequence of events.
! The events then get distributed to the handler objects, i.e.\ the
! reader invokes a method on the handler.  A SAX application must
! therefore obtain a reader object, create or open the input sources,
! create the handlers, and connect these objects all together.  As the
! 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, but applications may use implementations which do not inherit
! from the provided classes.  The \class{InputSource}, \class{Locator},
! \class{AttributesImpl}, \class{AttributesNSImpl}, and
! \class{XMLReader} interfaces are defined in the module
! \refmodule{xml.sax.xmlreader}.  The handler interfaces are defined in
! \refmodule{xml.sax.handler}.  For convenience, \class{InputSource}
! (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