lib/sax/ext/ext.nit

   1 # This file is part of NIT ( http://www.nitlanguage.org ).
   2 #
   3 # This file is free software, which comes along with NIT. This software is
   4 # distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
   5 # without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
   6 # PARTICULAR PURPOSE. You can modify it is you want, provided this header
   7 # is kept unaltered, and a notification of the changes is added.
   8 # You are allowed to redistribute it and sell it, alone or is a part of
   9 # another product.
  10
  11 # Interfaces to optional SAX2 handlers.
  12 #
  13 # See [http://www.saxproject.org](http://www.saxproject.org)
  14 # for more information about SAX.
  15 #
  16 # The package is independent of the SAX2 core, though the functionality
  17 # exposed generally needs to be implemented within a parser.
  18 # That independence has several consequences:
  19 #
  20 # * SAX2 drivers are *not* required to recognize these handlers,
  21 # and you cannot assume that the class files will be present in every SAX2
  22 # installation.
  23 #
  24 # * This package may be updated independently of SAX2 (i.e. new
  25 # handlers may be added without updating SAX2 itself).
  26 #
  27 # * The handlers are not implemented by the SAX2
  28 # `org.xml.sax.helpers.XMLFilterImpl` class.
  29 # You can subclass these if you need such behaviour.
  30 #
  31 # * The handlers need to be registered differently than regular SAX2
  32 # handlers.
  33 #
  34 # This package, SAX2-ext, is a standardized extension to SAX2. It is
  35 # designed both to allow SAX parsers to pass certain types of information
  36 # to applications, and to serve as a simple model for other SAX2 parser
  37 # extension packages. Not all such extension packages should need to
  38 # be recognized directly by parsers, however.
  39 # As an example, most schema systems can be cleanly layered on top
  40 # of parsers supporting the standardized SAX2 interfaces.
  41 #
  42 # Note: this package alone does add any
  43 # functionality; it simply provides optional interfaces for SAX2 drivers
  44 # to use. You must use a SAX2 driver that recognizes these interfaces if
  45 # you actually want to have access to lexical and declaration
  46 # information.
  47 #
  48 # Note: The original documentation comes from [SAX 2.0](http://www.saxproject.org).
  49 module sax::ext
  50
  51 import sax
  52 import decl_handler
  53 import lexical_handler