/*

  =================== DO NOT EDIT THIS FILE ====================

  Generated by Modello 1.4.1 on 2011-05-02 01:00:32,

  any modifications will be overwritten.

  ==============================================================

  */

 package org.apache.maven.plugin.javadoc.options.io.xpp3;

   //---------------------------------/

  //- Imported classes and packages -/

 //---------------------------------/

 import java.io.IOException;

 import java.io.InputStream;

 import java.io.Reader;

 import java.text.DateFormat;

 import java.util.Locale;

 import org.apache.maven.plugin.javadoc.options.BootclasspathArtifact;

 import org.apache.maven.plugin.javadoc.options.DocletArtifact;

 import org.apache.maven.plugin.javadoc.options.Group;

 import org.apache.maven.plugin.javadoc.options.JavadocOptions;

 import org.apache.maven.plugin.javadoc.options.JavadocPathArtifact;

 import org.apache.maven.plugin.javadoc.options.OfflineLink;

 import org.apache.maven.plugin.javadoc.options.ResourcesArtifact;

 import org.apache.maven.plugin.javadoc.options.Tag;

 import org.apache.maven.plugin.javadoc.options.Taglet;

 import org.apache.maven.plugin.javadoc.options.TagletArtifact;

 import org.codehaus.plexus.util.ReaderFactory;

 import org.codehaus.plexus.util.xml.pull.MXParser;

 import org.codehaus.plexus.util.xml.pull.XmlPullParser;

 import org.codehaus.plexus.util.xml.pull.XmlPullParserException;

 /**

  * Class JavadocOptionsXpp3Reader.

  * 

  * @version $Revision$ $Date$

  */

 @SuppressWarnings( "all" )

 public class JavadocOptionsXpp3Reader

 {

       //--------------------------/

      //- Class/Member Variables -/

     //--------------------------/

     /**

      * If set the parser will be loaded with all single characters

      * from the XHTML specification.

      * The entities used:

      * <ul>

      * <li>http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent</li>

      * <li>http://www.w3.org/TR/xhtml1/DTD/xhtml-special.ent</li>

      * <li>http://www.w3.org/TR/xhtml1/DTD/xhtml-symbol.ent</li>

      * </ul>

      */

     private boolean addDefaultEntities = true;

       //-----------/

      //- Methods -/

     //-----------/

     /**

      * Method checkFieldWithDuplicate.

      * 

      * @param parser

      * @param parsed

      * @param alias

      * @param tagName

      * @throws XmlPullParserException

      * @return boolean

      */

     private boolean checkFieldWithDuplicate( XmlPullParser parser, String tagName, String alias, java.util.Set parsed )

         throws XmlPullParserException

     {

         if ( !( parser.getName().equals( tagName ) || parser.getName().equals( alias ) ) )

         {

             return false;

         }

         if ( !parsed.add( tagName ) )

         {

             throw new XmlPullParserException( "Duplicated tag: '" + tagName + "'", parser, null );

         }

         return true;

     } //-- boolean checkFieldWithDuplicate( XmlPullParser, String, String, java.util.Set )

     /**

      * Method checkUnknownAttribute.

      * 

      * @param parser

      * @param strict

      * @param tagName

      * @param attribute

      * @throws XmlPullParserException

      * @throws IOException

      */

     private void checkUnknownAttribute( XmlPullParser parser, String attribute, String tagName, boolean strict )

         throws XmlPullParserException, IOException

     {

         // strictXmlAttributes = true for model: if strict == true, not only elements are checked but attributes too

         if ( strict )

         {

             throw new XmlPullParserException( "Unknown attribute '" + attribute + "' for tag '" + tagName + "'", parser, null );

         }

     } //-- void checkUnknownAttribute( XmlPullParser, String, String, boolean )

     /**

      * Method checkUnknownElement.

      * 

      * @param parser

      * @param strict

      * @throws XmlPullParserException

      * @throws IOException

      */

     private void checkUnknownElement( XmlPullParser parser, boolean strict )

         throws XmlPullParserException, IOException

     {

         if ( strict )

         {

             throw new XmlPullParserException( "Unrecognised tag: '" + parser.getName() + "'", parser, null );

         }

         for ( int unrecognizedTagCount = 1; unrecognizedTagCount > 0; )

         {

             int eventType = parser.next();

             if ( eventType == XmlPullParser.START_TAG )

             {

                 unrecognizedTagCount++;

             }

             else if ( eventType == XmlPullParser.END_TAG )

             {

                 unrecognizedTagCount--;

             }

         }

     } //-- void checkUnknownElement( XmlPullParser, boolean )

     /**

      * Returns the state of the "add default entities" flag.

      * 

      * @return boolean

      */

     public boolean getAddDefaultEntities()

     {

         return addDefaultEntities;

     } //-- boolean getAddDefaultEntities()

     /**

      * Method getBooleanValue.

      * 

      * @param s

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return boolean

      */

     private boolean getBooleanValue( String s, String attribute, XmlPullParser parser )

         throws XmlPullParserException

     {

         return getBooleanValue( s, attribute, parser, null );

     } //-- boolean getBooleanValue( String, String, XmlPullParser )

     /**

      * Method getBooleanValue.

      * 

      * @param s

      * @param defaultValue

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return boolean

      */

     private boolean getBooleanValue( String s, String attribute, XmlPullParser parser, String defaultValue )

         throws XmlPullParserException

     {

         if ( s != null && s.length() != 0 )

         {

             return Boolean.valueOf( s ).booleanValue();

         }

         if ( defaultValue != null )

         {

             return Boolean.valueOf( defaultValue ).booleanValue();

         }

         return false;

     } //-- boolean getBooleanValue( String, String, XmlPullParser, String )

     /**

      * Method getByteValue.

      * 

      * @param s

      * @param strict

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return byte

      */

     private byte getByteValue( String s, String attribute, XmlPullParser parser, boolean strict )

         throws XmlPullParserException

     {

         if ( s != null )

         {

             try

             {

                 return Byte.valueOf( s ).byteValue();

             }

             catch ( NumberFormatException nfe )

             {

                 if ( strict )

                 {

                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a byte", parser, nfe );

                 }

             }

         }

         return 0;

     } //-- byte getByteValue( String, String, XmlPullParser, boolean )

     /**

      * Method getCharacterValue.

      * 

      * @param s

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return char

      */

     private char getCharacterValue( String s, String attribute, XmlPullParser parser )

         throws XmlPullParserException

     {

         if ( s != null )

         {

             return s.charAt( 0 );

         }

         return 0;

     } //-- char getCharacterValue( String, String, XmlPullParser )

     /**

      * Method getDateValue.

      * 

      * @param s

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return Date

      */

     private java.util.Date getDateValue( String s, String attribute, XmlPullParser parser )

         throws XmlPullParserException

     {

         return getDateValue( s, attribute, null, parser );

     } //-- java.util.Date getDateValue( String, String, XmlPullParser )

     /**

      * Method getDateValue.

      * 

      * @param s

      * @param parser

      * @param dateFormat

      * @param attribute

      * @throws XmlPullParserException

      * @return Date

      */

     private java.util.Date getDateValue( String s, String attribute, String dateFormat, XmlPullParser parser )

         throws XmlPullParserException

     {

         if ( s != null )

         {

             String effectiveDateFormat = dateFormat;

             if ( dateFormat == null )

             {

                 effectiveDateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSS";

             }

             if ( "long".equals( effectiveDateFormat ) )

             {

                 try

                 {

                     return new java.util.Date( Long.parseLong( s ) );

                 }

                 catch ( NumberFormatException e )

                 {

                     throw new XmlPullParserException( e.getMessage(), parser, e );

                 }

             }

             else

             {

                 try

                 {

                     DateFormat dateParser = new java.text.SimpleDateFormat( effectiveDateFormat, Locale.US );

                     return dateParser.parse( s );

                 }

                 catch ( java.text.ParseException e )

                 {

                     throw new XmlPullParserException( e.getMessage(), parser, e );

                 }

             }

         }

         return null;

     } //-- java.util.Date getDateValue( String, String, String, XmlPullParser )

     /**

      * Method getDoubleValue.

      * 

      * @param s

      * @param strict

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return double

      */

     private double getDoubleValue( String s, String attribute, XmlPullParser parser, boolean strict )

         throws XmlPullParserException

     {

         if ( s != null )

         {

             try

             {

                 return Double.valueOf( s ).doubleValue();

             }

             catch ( NumberFormatException nfe )

             {

                 if ( strict )

                 {

                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a floating point number", parser, nfe );

                 }

             }

         }

         return 0;

     } //-- double getDoubleValue( String, String, XmlPullParser, boolean )

     /**

      * Method getFloatValue.

      * 

      * @param s

      * @param strict

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return float

      */

     private float getFloatValue( String s, String attribute, XmlPullParser parser, boolean strict )

         throws XmlPullParserException

     {

         if ( s != null )

         {

             try

             {

                 return Float.valueOf( s ).floatValue();

             }

             catch ( NumberFormatException nfe )

             {

                 if ( strict )

                 {

                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a floating point number", parser, nfe );

                 }

             }

         }

         return 0;

     } //-- float getFloatValue( String, String, XmlPullParser, boolean )

     /**

      * Method getIntegerValue.

      * 

      * @param s

      * @param strict

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return int

      */

     private int getIntegerValue( String s, String attribute, XmlPullParser parser, boolean strict )

         throws XmlPullParserException

     {

         if ( s != null )

         {

             try

             {

                 return Integer.valueOf( s ).intValue();

             }

             catch ( NumberFormatException nfe )

             {

                 if ( strict )

                 {

                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be an integer", parser, nfe );

                 }

             }

         }

         return 0;

     } //-- int getIntegerValue( String, String, XmlPullParser, boolean )

     /**

      * Method getLongValue.

      * 

      * @param s

      * @param strict

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return long

      */

     private long getLongValue( String s, String attribute, XmlPullParser parser, boolean strict )

         throws XmlPullParserException

     {

         if ( s != null )

         {

             try

             {

                 return Long.valueOf( s ).longValue();

             }

             catch ( NumberFormatException nfe )

             {

                 if ( strict )

                 {

                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a long integer", parser, nfe );

                 }

             }

         }

         return 0;

     } //-- long getLongValue( String, String, XmlPullParser, boolean )

     /**

      * Method getRequiredAttributeValue.

      * 

      * @param s

      * @param strict

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return String

      */

     private String getRequiredAttributeValue( String s, String attribute, XmlPullParser parser, boolean strict )

         throws XmlPullParserException

     {

         if ( s == null )

         {

             if ( strict )

             {

                 throw new XmlPullParserException( "Missing required value for attribute '" + attribute + "'", parser, null );

             }

         }

         return s;

     } //-- String getRequiredAttributeValue( String, String, XmlPullParser, boolean )

     /**

      * Method getShortValue.

      * 

      * @param s

      * @param strict

      * @param parser

      * @param attribute

      * @throws XmlPullParserException

      * @return short

      */

     private short getShortValue( String s, String attribute, XmlPullParser parser, boolean strict )

         throws XmlPullParserException

     {

         if ( s != null )

         {

             try

             {

                 return Short.valueOf( s ).shortValue();

             }

             catch ( NumberFormatException nfe )

             {

                 if ( strict )

                 {

                     throw new XmlPullParserException( "Unable to parse element '" + attribute + "', must be a short integer", parser, nfe );

                 }

             }

         }

         return 0;

     } //-- short getShortValue( String, String, XmlPullParser, boolean )

     /**

      * Method getTrimmedValue.

      * 

      * @param s

      * @return String

      */

     private String getTrimmedValue( String s )

     {

         if ( s != null )

         {

             s = s.trim();

         }

         return s;

     } //-- String getTrimmedValue( String )

     /**

      * Method initParser.

      * 

      * @param parser

      * @throws XmlPullParserException

      */

     private void initParser( XmlPullParser parser )

         throws XmlPullParserException

     {

         if ( addDefaultEntities )

         {

             // ----------------------------------------------------------------------

             // Latin 1 entities

             // ----------------------------------------------------------------------

             parser.defineEntityReplacementText( "nbsp", "\u00a0" );

             parser.defineEntityReplacementText( "iexcl", "\u00a1" );

             parser.defineEntityReplacementText( "cent", "\u00a2" );

             parser.defineEntityReplacementText( "pound", "\u00a3" );

             parser.defineEntityReplacementText( "curren", "\u00a4" );

             parser.defineEntityReplacementText( "yen", "\u00a5" );

             parser.defineEntityReplacementText( "brvbar", "\u00a6" );

             parser.defineEntityReplacementText( "sect", "\u00a7" );

             parser.defineEntityReplacementText( "uml", "\u00a8" );

             parser.defineEntityReplacementText( "copy", "\u00a9" );

             parser.defineEntityReplacementText( "ordf", "\u00aa" );

             parser.defineEntityReplacementText( "laquo", "\u00ab" );

             parser.defineEntityReplacementText( "not", "\u00ac" );

             parser.defineEntityReplacementText( "shy", "\u00ad" );

             parser.defineEntityReplacementText( "reg", "\u00ae" );

             parser.defineEntityReplacementText( "macr", "\u00af" );

             parser.defineEntityReplacementText( "deg", "\u00b0" );

             parser.defineEntityReplacementText( "plusmn", "\u00b1" );

             parser.defineEntityReplacementText( "sup2", "\u00b2" );

             parser.defineEntityReplacementText( "sup3", "\u00b3" );

             parser.defineEntityReplacementText( "acute", "\u00b4" );

             parser.defineEntityReplacementText( "micro", "\u00b5" );

             parser.defineEntityReplacementText( "para", "\u00b6" );

             parser.defineEntityReplacementText( "middot", "\u00b7" );

             parser.defineEntityReplacementText( "cedil", "\u00b8" );

             parser.defineEntityReplacementText( "sup1", "\u00b9" );

             parser.defineEntityReplacementText( "ordm", "\u00ba" );

             parser.defineEntityReplacementText( "raquo", "\u00bb" );

             parser.defineEntityReplacementText( "frac14", "\u00bc" );

             parser.defineEntityReplacementText( "frac12", "\u00bd" );

             parser.defineEntityReplacementText( "frac34", "\u00be" );

             parser.defineEntityReplacementText( "iquest", "\u00bf" );

             parser.defineEntityReplacementText( "Agrave", "\u00c0" );

             parser.defineEntityReplacementText( "Aacute", "\u00c1" );

             parser.defineEntityReplacementText( "Acirc", "\u00c2" );

             parser.defineEntityReplacementText( "Atilde", "\u00c3" );

             parser.defineEntityReplacementText( "Auml", "\u00c4" );

             parser.defineEntityReplacementText( "Aring", "\u00c5" );

             parser.defineEntityReplacementText( "AElig", "\u00c6" );

             parser.defineEntityReplacementText( "Ccedil", "\u00c7" );

             parser.defineEntityReplacementText( "Egrave", "\u00c8" );

             parser.defineEntityReplacementText( "Eacute", "\u00c9" );

             parser.defineEntityReplacementText( "Ecirc", "\u00ca" );

             parser.defineEntityReplacementText( "Euml", "\u00cb" );

             parser.defineEntityReplacementText( "Igrave", "\u00cc" );

             parser.defineEntityReplacementText( "Iacute", "\u00cd" );

             parser.defineEntityReplacementText( "Icirc", "\u00ce" );

             parser.defineEntityReplacementText( "Iuml", "\u00cf" );

             parser.defineEntityReplacementText( "ETH", "\u00d0" );

             parser.defineEntityReplacementText( "Ntilde", "\u00d1" );

             parser.defineEntityReplacementText( "Ograve", "\u00d2" );

             parser.defineEntityReplacementText( "Oacute", "\u00d3" );

             parser.defineEntityReplacementText( "Ocirc", "\u00d4" );

             parser.defineEntityReplacementText( "Otilde", "\u00d5" );

             parser.defineEntityReplacementText( "Ouml", "\u00d6" );

             parser.defineEntityReplacementText( "times", "\u00d7" );

             parser.defineEntityReplacementText( "Oslash", "\u00d8" );

             parser.defineEntityReplacementText( "Ugrave", "\u00d9" );

             parser.defineEntityReplacementText( "Uacute", "\u00da" );

             parser.defineEntityReplacementText( "Ucirc", "\u00db" );

             parser.defineEntityReplacementText( "Uuml", "\u00dc" );

             parser.defineEntityReplacementText( "Yacute", "\u00dd" );

             parser.defineEntityReplacementText( "THORN", "\u00de" );

             parser.defineEntityReplacementText( "szlig", "\u00df" );

             parser.defineEntityReplacementText( "agrave", "\u00e0" );

             parser.defineEntityReplacementText( "aacute", "\u00e1" );

             parser.defineEntityReplacementText( "acirc", "\u00e2" );

             parser.defineEntityReplacementText( "atilde", "\u00e3" );

             parser.defineEntityReplacementText( "auml", "\u00e4" );

             parser.defineEntityReplacementText( "aring", "\u00e5" );

             parser.defineEntityReplacementText( "aelig", "\u00e6" );

             parser.defineEntityReplacementText( "ccedil", "\u00e7" );

             parser.defineEntityReplacementText( "egrave", "\u00e8" );

             parser.defineEntityReplacementText( "eacute", "\u00e9" );

             parser.defineEntityReplacementText( "ecirc", "\u00ea" );

             parser.defineEntityReplacementText( "euml", "\u00eb" );

             parser.defineEntityReplacementText( "igrave", "\u00ec" );

             parser.defineEntityReplacementText( "iacute", "\u00ed" );

             parser.defineEntityReplacementText( "icirc", "\u00ee" );

             parser.defineEntityReplacementText( "iuml", "\u00ef" );

             parser.defineEntityReplacementText( "eth", "\u00f0" );

             parser.defineEntityReplacementText( "ntilde", "\u00f1" );

             parser.defineEntityReplacementText( "ograve", "\u00f2" );

             parser.defineEntityReplacementText( "oacute", "\u00f3" );

             parser.defineEntityReplacementText( "ocirc", "\u00f4" );

             parser.defineEntityReplacementText( "otilde", "\u00f5" );

             parser.defineEntityReplacementText( "ouml", "\u00f6" );

             parser.defineEntityReplacementText( "divide", "\u00f7" );

             parser.defineEntityReplacementText( "oslash", "\u00f8" );

             parser.defineEntityReplacementText( "ugrave", "\u00f9" );

             parser.defineEntityReplacementText( "uacute", "\u00fa" );

             parser.defineEntityReplacementText( "ucirc", "\u00fb" );

             parser.defineEntityReplacementText( "uuml", "\u00fc" );

             parser.defineEntityReplacementText( "yacute", "\u00fd" );

             parser.defineEntityReplacementText( "thorn", "\u00fe" );

             parser.defineEntityReplacementText( "yuml", "\u00ff" );

             // ----------------------------------------------------------------------

             // Special entities

             // ----------------------------------------------------------------------

             parser.defineEntityReplacementText( "OElig", "\u0152" );

             parser.defineEntityReplacementText( "oelig", "\u0153" );

             parser.defineEntityReplacementText( "Scaron", "\u0160" );

             parser.defineEntityReplacementText( "scaron", "\u0161" );

             parser.defineEntityReplacementText( "Yuml", "\u0178" );

             parser.defineEntityReplacementText( "circ", "\u02c6" );

             parser.defineEntityReplacementText( "tilde", "\u02dc" );

             parser.defineEntityReplacementText( "ensp", "\u2002" );

             parser.defineEntityReplacementText( "emsp", "\u2003" );

             parser.defineEntityReplacementText( "thinsp", "\u2009" );

             parser.defineEntityReplacementText( "zwnj", "\u200c" );

             parser.defineEntityReplacementText( "zwj", "\u200d" );

             parser.defineEntityReplacementText( "lrm", "\u200e" );

             parser.defineEntityReplacementText( "rlm", "\u200f" );

             parser.defineEntityReplacementText( "ndash", "\u2013" );

             parser.defineEntityReplacementText( "mdash", "\u2014" );

             parser.defineEntityReplacementText( "lsquo", "\u2018" );

             parser.defineEntityReplacementText( "rsquo", "\u2019" );

             parser.defineEntityReplacementText( "sbquo", "\u201a" );

             parser.defineEntityReplacementText( "ldquo", "\u201c" );

             parser.defineEntityReplacementText( "rdquo", "\u201d" );

             parser.defineEntityReplacementText( "bdquo", "\u201e" );

             parser.defineEntityReplacementText( "dagger", "\u2020" );

             parser.defineEntityReplacementText( "Dagger", "\u2021" );

             parser.defineEntityReplacementText( "permil", "\u2030" );

             parser.defineEntityReplacementText( "lsaquo", "\u2039" );

             parser.defineEntityReplacementText( "rsaquo", "\u203a" );

             parser.defineEntityReplacementText( "euro", "\u20ac" );

             // ----------------------------------------------------------------------

             // Symbol entities

             // ----------------------------------------------------------------------

             parser.defineEntityReplacementText( "fnof", "\u0192" );

             parser.defineEntityReplacementText( "Alpha", "\u0391" );

             parser.defineEntityReplacementText( "Beta", "\u0392" );

             parser.defineEntityReplacementText( "Gamma", "\u0393" );

             parser.defineEntityReplacementText( "Delta", "\u0394" );

             parser.defineEntityReplacementText( "Epsilon", "\u0395" );

             parser.defineEntityReplacementText( "Zeta", "\u0396" );

             parser.defineEntityReplacementText( "Eta", "\u0397" );

             parser.defineEntityReplacementText( "Theta", "\u0398" );

             parser.defineEntityReplacementText( "Iota", "\u0399" );

             parser.defineEntityReplacementText( "Kappa", "\u039a" );

             parser.defineEntityReplacementText( "Lambda", "\u039b" );

             parser.defineEntityReplacementText( "Mu", "\u039c" );

             parser.defineEntityReplacementText( "Nu", "\u039d" );

             parser.defineEntityReplacementText( "Xi", "\u039e" );

             parser.defineEntityReplacementText( "Omicron", "\u039f" );

             parser.defineEntityReplacementText( "Pi", "\u03a0" );

             parser.defineEntityReplacementText( "Rho", "\u03a1" );

             parser.defineEntityReplacementText( "Sigma", "\u03a3" );

             parser.defineEntityReplacementText( "Tau", "\u03a4" );

             parser.defineEntityReplacementText( "Upsilon", "\u03a5" );

             parser.defineEntityReplacementText( "Phi", "\u03a6" );

             parser.defineEntityReplacementText( "Chi", "\u03a7" );

             parser.defineEntityReplacementText( "Psi", "\u03a8" );

             parser.defineEntityReplacementText( "Omega", "\u03a9" );

             parser.defineEntityReplacementText( "alpha", "\u03b1" );

             parser.defineEntityReplacementText( "beta", "\u03b2" );

             parser.defineEntityReplacementText( "gamma", "\u03b3" );

             parser.defineEntityReplacementText( "delta", "\u03b4" );

             parser.defineEntityReplacementText( "epsilon", "\u03b5" );

             parser.defineEntityReplacementText( "zeta", "\u03b6" );

             parser.defineEntityReplacementText( "eta", "\u03b7" );

             parser.defineEntityReplacementText( "theta", "\u03b8" );

             parser.defineEntityReplacementText( "iota", "\u03b9" );

             parser.defineEntityReplacementText( "kappa", "\u03ba" );

             parser.defineEntityReplacementText( "lambda", "\u03bb" );

             parser.defineEntityReplacementText( "mu", "\u03bc" );

             parser.defineEntityReplacementText( "nu", "\u03bd" );

             parser.defineEntityReplacementText( "xi", "\u03be" );

             parser.defineEntityReplacementText( "omicron", "\u03bf" );

             parser.defineEntityReplacementText( "pi", "\u03c0" );

             parser.defineEntityReplacementText( "rho", "\u03c1" );

             parser.defineEntityReplacementText( "sigmaf", "\u03c2" );

             parser.defineEntityReplacementText( "sigma", "\u03c3" );

             parser.defineEntityReplacementText( "tau", "\u03c4" );

             parser.defineEntityReplacementText( "upsilon", "\u03c5" );

             parser.defineEntityReplacementText( "phi", "\u03c6" );

             parser.defineEntityReplacementText( "chi", "\u03c7" );

             parser.defineEntityReplacementText( "psi", "\u03c8" );

             parser.defineEntityReplacementText( "omega", "\u03c9" );

             parser.defineEntityReplacementText( "thetasym", "\u03d1" );

             parser.defineEntityReplacementText( "upsih", "\u03d2" );

             parser.defineEntityReplacementText( "piv", "\u03d6" );

             parser.defineEntityReplacementText( "bull", "\u2022" );

             parser.defineEntityReplacementText( "hellip", "\u2026" );

             parser.defineEntityReplacementText( "prime", "\u2032" );

             parser.defineEntityReplacementText( "Prime", "\u2033" );

             parser.defineEntityReplacementText( "oline", "\u203e" );

             parser.defineEntityReplacementText( "frasl", "\u2044" );

             parser.defineEntityReplacementText( "weierp", "\u2118" );

             parser.defineEntityReplacementText( "image", "\u2111" );

             parser.defineEntityReplacementText( "real", "\u211c" );

             parser.defineEntityReplacementText( "trade", "\u2122" );

             parser.defineEntityReplacementText( "alefsym", "\u2135" );

             parser.defineEntityReplacementText( "larr", "\u2190" );

             parser.defineEntityReplacementText( "uarr", "\u2191" );

             parser.defineEntityReplacementText( "rarr", "\u2192" );

             parser.defineEntityReplacementText( "darr", "\u2193" );

             parser.defineEntityReplacementText( "harr", "\u2194" );

             parser.defineEntityReplacementText( "crarr", "\u21b5" );

             parser.defineEntityReplacementText( "lArr", "\u21d0" );

             parser.defineEntityReplacementText( "uArr", "\u21d1" );

             parser.defineEntityReplacementText( "rArr", "\u21d2" );

             parser.defineEntityReplacementText( "dArr", "\u21d3" );

             parser.defineEntityReplacementText( "hArr", "\u21d4" );

             parser.defineEntityReplacementText( "forall", "\u2200" );

             parser.defineEntityReplacementText( "part", "\u2202" );

             parser.defineEntityReplacementText( "exist", "\u2203" );

             parser.defineEntityReplacementText( "empty", "\u2205" );

             parser.defineEntityReplacementText( "nabla", "\u2207" );

             parser.defineEntityReplacementText( "isin", "\u2208" );

             parser.defineEntityReplacementText( "notin", "\u2209" );

             parser.defineEntityReplacementText( "ni", "\u220b" );

             parser.defineEntityReplacementText( "prod", "\u220f" );

             parser.defineEntityReplacementText( "sum", "\u2211" );

             parser.defineEntityReplacementText( "minus", "\u2212" );

             parser.defineEntityReplacementText( "lowast", "\u2217" );

             parser.defineEntityReplacementText( "radic", "\u221a" );

             parser.defineEntityReplacementText( "prop", "\u221d" );

             parser.defineEntityReplacementText( "infin", "\u221e" );

             parser.defineEntityReplacementText( "ang", "\u2220" );

             parser.defineEntityReplacementText( "and", "\u2227" );

             parser.defineEntityReplacementText( "or", "\u2228" );

             parser.defineEntityReplacementText( "cap", "\u2229" );

             parser.defineEntityReplacementText( "cup", "\u222a" );

             parser.defineEntityReplacementText( "int", "\u222b" );

             parser.defineEntityReplacementText( "there4", "\u2234" );

             parser.defineEntityReplacementText( "sim", "\u223c" );

             parser.defineEntityReplacementText( "cong", "\u2245" );

             parser.defineEntityReplacementText( "asymp", "\u2248" );

             parser.defineEntityReplacementText( "ne", "\u2260" );

             parser.defineEntityReplacementText( "equiv", "\u2261" );

             parser.defineEntityReplacementText( "le", "\u2264" );

             parser.defineEntityReplacementText( "ge", "\u2265" );

             parser.defineEntityReplacementText( "sub", "\u2282" );

             parser.defineEntityReplacementText( "sup", "\u2283" );

             parser.defineEntityReplacementText( "nsub", "\u2284" );

             parser.defineEntityReplacementText( "sube", "\u2286" );

             parser.defineEntityReplacementText( "supe", "\u2287" );

             parser.defineEntityReplacementText( "oplus", "\u2295" );

             parser.defineEntityReplacementText( "otimes", "\u2297" );

             parser.defineEntityReplacementText( "perp", "\u22a5" );

             parser.defineEntityReplacementText( "sdot", "\u22c5" );

             parser.defineEntityReplacementText( "lceil", "\u2308" );

             parser.defineEntityReplacementText( "rceil", "\u2309" );

             parser.defineEntityReplacementText( "lfloor", "\u230a" );

             parser.defineEntityReplacementText( "rfloor", "\u230b" );

             parser.defineEntityReplacementText( "lang", "\u2329" );

             parser.defineEntityReplacementText( "rang", "\u232a" );

             parser.defineEntityReplacementText( "loz", "\u25ca" );

             parser.defineEntityReplacementText( "spades", "\u2660" );

             parser.defineEntityReplacementText( "clubs", "\u2663" );

             parser.defineEntityReplacementText( "hearts", "\u2665" );

             parser.defineEntityReplacementText( "diams", "\u2666" );

         }

     } //-- void initParser( XmlPullParser )

     /**

      * Method nextTag.

      * 

      * @param parser

      * @throws IOException

      * @throws XmlPullParserException

      * @return int

      */

     private int nextTag( XmlPullParser parser )

         throws IOException, XmlPullParserException

     {

         int eventType = parser.next();

         if ( eventType == XmlPullParser.TEXT )

         {

             eventType = parser.next();

         }

         if ( eventType != XmlPullParser.START_TAG && eventType != XmlPullParser.END_TAG )

         {

             throw new XmlPullParserException( "expected START_TAG or END_TAG not " + XmlPullParser.TYPES[eventType], parser, null );

         }

         return eventType;

     } //-- int nextTag( XmlPullParser )

     /**

      * Method parseBootclasspathArtifact.

      * 

      * @param parser

      * @param strict

      * @throws IOException

      * @throws XmlPullParserException

      * @return BootclasspathArtifact

      */

     private BootclasspathArtifact parseBootclasspathArtifact( XmlPullParser parser, boolean strict )

         throws IOException, XmlPullParserException

     {

         String tagName = parser.getName();

         BootclasspathArtifact bootclasspathArtifact = new BootclasspathArtifact();

         for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )

         {

             String name = parser.getAttributeName( i );

             String value = parser.getAttributeValue( i );

             if ( name.indexOf( ':' ) >= 0 )

             {

                 // just ignore attributes with non-default namespace (for example: xmlns:xsi)

             }

             else

             {

                 checkUnknownAttribute( parser, name, tagName, strict );

             }

         }

         java.util.Set parsed = new java.util.HashSet();

         while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )

         {

             if ( checkFieldWithDuplicate( parser, "groupId", null, parsed ) )

             {

                 bootclasspathArtifact.setGroupId( getTrimmedValue( parser.nextText() ) );

             }

             else if ( checkFieldWithDuplicate( parser, "artifactId", null, parsed ) )

             {

                 bootclasspathArtifact.setArtifactId( getTrimmedValue( parser.nextText() ) );

             }

             else if ( checkFieldWithDuplicate( parser, "version", null, parsed ) )

             {

                 bootclasspathArtifact.setVersion( getTrimmedValue( parser.nextText() ) );

             }

             else

             {

                 checkUnknownElement( parser, strict );

             }

         }

         return bootclasspathArtifact;

     } //-- BootclasspathArtifact parseBootclasspathArtifact( XmlPullParser, boolean )

     /**

      * Method parseDocletArtifact.

      * 

      * @param parser

      * @param strict

      * @throws IOException

      * @throws XmlPullParserException

      * @return DocletArtifact

      */

     private DocletArtifact parseDocletArtifact( XmlPullParser parser, boolean strict )

         throws IOException, XmlPullParserException

     {

         String tagName = parser.getName();

         DocletArtifact docletArtifact = new DocletArtifact();

         for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )

         {

             String name = parser.getAttributeName( i );

             String value = parser.getAttributeValue( i );

             if ( name.indexOf( ':' ) >= 0 )

             {

                 // just ignore attributes with non-default namespace (for example: xmlns:xsi)

             }

             else

             {

                 checkUnknownAttribute( parser, name, tagName, strict );

             }

         }

         java.util.Set parsed = new java.util.HashSet();

         while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )

         {

             if ( checkFieldWithDuplicate( parser, "groupId", null, parsed ) )

             {

                 docletArtifact.setGroupId( getTrimmedValue( parser.nextText() ) );

             }

             else if ( checkFieldWithDuplicate( parser, "artifactId", null, parsed ) )

             {

                 docletArtifact.setArtifactId( getTrimmedValue( parser.nextText() ) );

             }

             else if ( checkFieldWithDuplicate( parser, "version", null, parsed ) )

             {

                 docletArtifact.setVersion( getTrimmedValue( parser.nextText() ) );

             }

             else

             {

                 checkUnknownElement( parser, strict );

             }

         }

         return docletArtifact;

     } //-- DocletArtifact parseDocletArtifact( XmlPullParser, boolean )

     /**

      * Method parseGroup.

      * 

      * @param parser

      * @param strict

      * @throws IOException

      * @throws XmlPullParserException

      * @return Group

      */

     private Group parseGroup( XmlPullParser parser, boolean strict )

         throws IOException, XmlPullParserException

     {

         String tagName = parser.getName();

         Group group = new Group();

         for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )

         {

             String name = parser.getAttributeName( i );

             String value = parser.getAttributeValue( i );

             if ( name.indexOf( ':' ) >= 0 )

             {

                 // just ignore attributes with non-default namespace (for example: xmlns:xsi)

             }

             else

             {

                 checkUnknownAttribute( parser, name, tagName, strict );

             }

         }

         java.util.Set parsed = new java.util.HashSet();

         while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )

         {

             if ( checkFieldWithDuplicate( parser, "title", null, parsed ) )

             {

                 group.setTitle( getTrimmedValue( parser.nextText() ) );

             }

             else if ( checkFieldWithDuplicate( parser, "packages", null, parsed ) )

             {

                 group.setPackages( getTrimmedValue( parser.nextText() ) );

             }

             else

             {

                 checkUnknownElement( parser, strict );

             }

         }

         return group;

     } //-- Group parseGroup( XmlPullParser, boolean )

     /**

      * Method parseJavadocOptions.

      * 

      * @param parser

      * @param strict

      * @throws IOException

      * @throws XmlPullParserException

      * @return JavadocOptions

      */

     private JavadocOptions parseJavadocOptions( XmlPullParser parser, boolean strict )

         throws IOException, XmlPullParserException

     {

         String tagName = parser.getName();

         JavadocOptions javadocOptions = new JavadocOptions();

         for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )

         {

             String name = parser.getAttributeName( i );

             String value = parser.getAttributeValue( i );

             if ( name.indexOf( ':' ) >= 0 )

             {

                 // just ignore attributes with non-default namespace (for example: xmlns:xsi)

             }

             else if ( "xmlns".equals( name ) )

             {

                 // ignore xmlns attribute in root class, which is a reserved attribute name

             }

             else

             {

                 checkUnknownAttribute( parser, name, tagName, strict );

             }

         }

         java.util.Set parsed = new java.util.HashSet();

         while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )

         {

             if ( checkFieldWithDuplicate( parser, "groups", null, parsed ) )

             {

                 java.util.List groups = new java.util.ArrayList/*<Group>*/();

                 javadocOptions.setGroups( groups );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "group".equals( parser.getName() ) )

                     {

                         groups.add( parseGroup( parser, strict ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "tags", null, parsed ) )

             {

                 java.util.List tags = new java.util.ArrayList/*<Tag>*/();

                 javadocOptions.setTags( tags );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "tag".equals( parser.getName() ) )

                     {

                         tags.add( parseTag( parser, strict ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "docletArtifacts", null, parsed ) )

             {

                 java.util.List docletArtifacts = new java.util.ArrayList/*<DocletArtifact>*/();

                 javadocOptions.setDocletArtifacts( docletArtifacts );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "docletArtifact".equals( parser.getName() ) )

                     {

                         docletArtifacts.add( parseDocletArtifact( parser, strict ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "taglets", null, parsed ) )

             {

                 java.util.List taglets = new java.util.ArrayList/*<Taglet>*/();

                 javadocOptions.setTaglets( taglets );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "taglet".equals( parser.getName() ) )

                     {

                         taglets.add( parseTaglet( parser, strict ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "offlineLinks", null, parsed ) )

             {

                 java.util.List offlineLinks = new java.util.ArrayList/*<OfflineLink>*/();

                 javadocOptions.setOfflineLinks( offlineLinks );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "offlineLink".equals( parser.getName() ) )

                     {

                         offlineLinks.add( parseOfflineLink( parser, strict ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "tagletArtifacts", null, parsed ) )

             {

                 java.util.List tagletArtifacts = new java.util.ArrayList/*<TagletArtifact>*/();

                 javadocOptions.setTagletArtifacts( tagletArtifacts );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "tagletArtifact".equals( parser.getName() ) )

                     {

                         tagletArtifacts.add( parseTagletArtifact( parser, strict ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "resourcesArtifacts", null, parsed ) )

             {

                 java.util.List resourcesArtifacts = new java.util.ArrayList/*<ResourcesArtifact>*/();

                 javadocOptions.setResourcesArtifacts( resourcesArtifacts );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "resourcesArtifact".equals( parser.getName() ) )

                     {

                         resourcesArtifacts.add( parseResourcesArtifact( parser, strict ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "bootclasspathArtifacts", null, parsed ) )

             {

                 java.util.List bootclasspathArtifacts = new java.util.ArrayList/*<BootclasspathArtifact>*/();

                 javadocOptions.setBootclasspathArtifacts( bootclasspathArtifacts );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "bootclasspathArtifact".equals( parser.getName() ) )

                     {

                         bootclasspathArtifacts.add( parseBootclasspathArtifact( parser, strict ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "links", null, parsed ) )

             {

                 java.util.List links = new java.util.ArrayList/*<String>*/();

                 javadocOptions.setLinks( links );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "link".equals( parser.getName() ) )

                     {

                         links.add( getTrimmedValue( parser.nextText() ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "excludePackageNames", null, parsed ) )

             {

                 java.util.List excludePackageNames = new java.util.ArrayList/*<String>*/();

                 javadocOptions.setExcludePackageNames( excludePackageNames );

                 while ( parser.nextTag() == XmlPullParser.START_TAG )

                 {

                     if ( "excludePackageName".equals( parser.getName() ) )

                     {

                         excludePackageNames.add( getTrimmedValue( parser.nextText() ) );

                     }

                     else

                     {

                         checkUnknownElement( parser, strict );

                     }

                 }

             }

             else if ( checkFieldWithDuplicate( parser, "docfilesSubdirsUsed", null, parsed ) )

             {

                 javadocOptions.setDocfilesSubdirsUsed( getBooleanValue( getTrimmedValue( parser.nextText() ), "docfilesSubdirsUsed", parser, "false" ) );

             }

             else if ( checkFieldWithDuplicate( parser, "excludedDocfilesSubdirs", null, parsed ) )

             {

                 javadocOptions.setExcludedDocfilesSubdirs( getTrimmedValue( parser.nextText() ) );

             }

             else if ( checkFieldWithDuplicate( parser, "javadocResourcesDirectory", null, parsed ) )

             {

                 javadocOptions.setJavadocResourcesDirectory( getTrimmedValue( parser.nextText() ) );

             }

             else

             {

                 checkUnknownElement( parser, strict );

             }

         }

         return javadocOptions;

     } //-- JavadocOptions parseJavadocOptions( XmlPullParser, boolean )

     /**

      * Method parseJavadocPathArtifact.

      * 

      * @param parser

      * @param strict

      * @throws IOException

      * @throws XmlPullParserException

      * @return JavadocPathArtifact

      */

     private JavadocPathArtifact parseJavadocPathArtifact( XmlPullParser parser, boolean strict )

         throws IOException, XmlPullParserException

     {

         String tagName = parser.getName();

         JavadocPathArtifact javadocPathArtifact = new JavadocPathArtifact();

         for ( int i = parser.getAttributeCount() - 1; i >= 0; i-- )

         {

             String name = parser.getAttributeName( i );

             String value = parser.getAttributeValue( i );

             if ( name.indexOf( ':' ) >= 0 )

             {

                 // just ignore attributes with non-default namespace (for example: xmlns:xsi)

             }

             else

             {

                 checkUnknownAttribute( parser, name, tagName, strict );

             }

         }

         java.util.Set parsed = new java.util.HashSet();

         while ( ( strict ? parser.nextTag() : nextTag( parser ) ) == XmlPullParser.START_TAG )

         {

             if ( checkFieldWithDuplicate( parser, "groupId", null, parsed ) )

             {

                 javadocPathArtifact.setGroupId( getTrimmedValue( parser.nextText() ) );

             }

             else if ( checkFieldWithDuplicate( parser, "artifactId", null, parsed ) )

             {

                 javadocPathArtifact.setArtifactId( getTrimmedValue( parser.nextText() ) );

             }

             else if ( checkFieldWithDuplicate( parser, "version", null, parsed ) )

             {

                 javadocPathArtifact.setVersion( getTrimmedValue( parser.nextText() ) );

             }

             else

             {

                 checkUnknownElement( parser, strict );

             }

         }

         return javadocPathArtifact;

     } //-- JavadocPathArtifact parseJavadocPathArtifact( XmlPullParser, boolean )

     /**

      * Method parseOfflineLink.

      * 

      * @param parser