Changes to XMLPULL V1 API

changed features URI to point to actual documentation on www.xmlpull.org
automatic JUnit tests now covers whole API
clarified isWhitespace() can only be checked on TEXT, IGNORABLE_WHITESPACES, CDSECT
clarified what is attribute namespace for xmlns:ns='...' when FEATURE_REPORT_NAMESPACE_ATTRIBUTES is set
changed defineCharacterEntity() to defineEntityReplacementText() and described semantics of this function and its motivation in J2ME environments
clarified how nextToken() works: return un-normalized (no end-of-line normalization) parts of XML input
if additional feature i set then XML text of START_TAG and END_TAG token is available allowing to do full XML document roundtrip: reproduce on output exactly what was in input. However this works on level of UNICODE characters (UTF16 char in Java) and output will need to be converted into required encoding (like UTF8 or UTF16).
getNamespacesCount changed to getNamespaceCount for consistency
getAttributesCount changed to getAttributeCount for consistency

added FEATURE_ prefix to all feature constants
changed function name getType() to getEventType()
clarified that getNamespacesCount() does not include default namespaces declarations (xmlns='...')
specified that attributes if has no namespace declared will have "" namespace (empty string)
clarified that when getTextCharacters returns null then holder MUST contain start and length will be set to -1]
added more comprehensive JUnit tests for API conformance

changed getTextCharacters to use pass by reference two int parameters (char[] getTextCharacters (int [] holderForStartAndLength)
nextToken() is required to return actual input data with getText() (no end-of-line normalization) - this will allow to reconstruct input XML