From f1a7fc1453676af318ce11fed9616cbb090b83ae Mon Sep 17 00:00:00 2001 From: Jesse Wilson Date: Thu, 10 May 2012 15:48:12 -0400 Subject: Use weasel words to cover changed behavior around END_DOCUMENT. We used to have 2 different implementations of XmlPullParser and each of them behaved differently if you called next() after receiving the END_DOCUMENT token: - Parsers returned from XmlPullParserFactory didn't throw - Parsers returned from android.util.Xml did throw When we went to a single implementation the behavior changed for android.util.Xml users. Unfortunately the change went from being consistent-with-the-docs to not. Rather than changing the behavior I'm being a weasel and changing the docs! That way we aren't promising something we cannot deliver. Bug: http://code.google.com/p/android/issues/detail?id=29931 Change-Id: I0e72e79270b92ecc0fdb5bf64c97fa50d2bdb81c --- xml/src/main/java/org/xmlpull/v1/XmlPullParser.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'xml/src/main/java/org/xmlpull') diff --git a/xml/src/main/java/org/xmlpull/v1/XmlPullParser.java b/xml/src/main/java/org/xmlpull/v1/XmlPullParser.java index 271137d..e042eb8 100644 --- a/xml/src/main/java/org/xmlpull/v1/XmlPullParser.java +++ b/xml/src/main/java/org/xmlpull/v1/XmlPullParser.java @@ -161,9 +161,9 @@ public interface XmlPullParser { * Logical end of the xml document. Returned from getEventType, next() * and nextToken() * when the end of the input document has been reached. - *

NOTE: calling again + *

NOTE: subsequent calls to * next() or nextToken() - * will result in exception being thrown. + * may result in exception being thrown. * * @see #next * @see #nextToken -- cgit v1.1