CVS Update: xmlpull-api-v1/src/java/api/org/xmlpull/v1

aslom       02/07/18 14:36:31

  Modified:    src/java/api/org/xmlpull/v1 XmlPullParserFactory.java
  Log:
  more explanation on how parser and serializer are created
  and how factory features are used (for parser) or not (for serializer)
  
  Revision  Changes    Path
  1.16      +9 -4      xmlpull-api-v1/src/java/api/org/xmlpull/v1/XmlPullParserFactory.java
  
  Index: XmlPullParserFactory.java
  ===================================================================
  RCS file: /l/extreme/cvspub/xmlpull-api-v1/src/java/api/org/xmlpull/v1/XmlPullParserFactory.java,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -b -t -w -r1.15 -r1.16
  --- XmlPullParserFactory.java	2002/07/15 18:02:49	1.15
  +++ XmlPullParserFactory.java	2002/07/18 19:36:31	1.16
  @@ -75,6 +75,7 @@
   
       /**
        * Set the features to be set when XML Pull Parser is created by this factory.
  +     * <p><b>NOTE:</b> factory features are not used for XML Serializer.
        *
        * @param name string with URI identifying feature
        * @param state if true feature will be set; if false will be ignored
  @@ -89,6 +90,7 @@
   
       /**
        * Return the current value of the feature with given name.
  +     * <p><b>NOTE:</b> factory features are not used for XML Serializer.
        *
        * @param name The name of feature to be retrieved.
        * @return The value of named feature.
  @@ -115,7 +117,8 @@
   
       /**
        * Indicates whether or not the factory is configured to produce
  -     * parsers which are namespace aware.
  +     * parsers which are namespace aware
  +     * (it simply set feature XmlPullParser.FEATURE_PROCESS_NAMESPACES to true or false).
        *
        * @return  true if the factory is configured to produce parsers
        *    which are namespace aware; false otherwise.
  @@ -128,6 +131,7 @@
   
       /**
        * Specifies that the parser produced by this factory will be validating
  +     * (it simply set feature XmlPullParser.FEATURE_VALIDATION to true or false).
        *
        * By default the value of this is set to false.
        *
  @@ -152,7 +156,7 @@
   
       /**
        * Creates a new instance of a XML Pull Parser
  -     * using the currently configured factory parameters.
  +     * using the currently configured factory features.
        *
        * @return A new instance of a XML Pull Parser.
        * @throws XmlPullParserException if a parser cannot be created which satisfies the
  @@ -196,8 +200,9 @@
   
   
       /**
  -     * Creates a new instance of a XML Serializer
  -     * using the currently configured factory parameters.
  +     * Creates a new instance of a XML Serializer.
  +     *
  +     * <p><b>NOTE:</b> factory features are not used for XML Serializer.
        *
        * @return A new instance of a XML Serializer.
        * @throws XmlPullParserException if a parser cannot be created which satisfies the