--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/dtdparser/DTDEventListener.java 2015-10-22 23:51:06.000000000 +0200 +++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/dtdparser/DTDEventListener.java 2015-10-22 23:51:06.000000000 +0200 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -94,7 +94,7 @@ /** * Receive notification of an external parsed general entity * declaration event. - *

+ *

*

If a system identifier is present, and it is a relative URL, the * parser will have resolved it fully before passing it through this * method to a listener.

@@ -127,7 +127,7 @@ /** * Receive notification of an external parameter entity declaration * event. - *

+ *

*

If a system identifier is present, and it is a relative URL, the * parser will have resolved it fully before passing it through this * method to a listener.

@@ -164,7 +164,7 @@ /** * Receive notification that a comment has been read. - *

+ *

*

Note that processing instructions are the mechanism designed * to hold information for consumption by applications, not comments. * XML systems may rely on applications being able to access information @@ -179,17 +179,17 @@ /** * Receive notification of character data. - *

+ *

*

The Parser will call this method to report each chunk of * character data. SAX parsers may return all contiguous character * data in a single chunk, or they may split it into several * chunks; however, all of the characters in any single event * must come from the same external entity, so that the Locator * provides useful information.

- *

+ *

*

The application must not attempt to read from the array * outside of the specified range.

- *

+ *

*

Note that some parsers will report whitespace using the * ignorableWhitespace() method rather than this one (validating * parsers must do so).

@@ -206,18 +206,18 @@ /** * Receive notification of ignorable whitespace in element content. - *

+ *

*

Validating Parsers must use this method to report each chunk * of ignorable whitespace (see the W3C XML 1.0 recommendation, * section 2.10): non-validating parsers may also use this method * if they are capable of parsing and using content models.

- *

+ *

*

SAX parsers may return all contiguous whitespace in a single * chunk, or they may split it into several chunks; however, all of * the characters in any single event must come from the same * external entity, so that the Locator provides useful * information.

- *

+ *

*

The application must not attempt to read from the array * outside of the specified range.

* @@ -279,7 +279,7 @@ * this elemen has child content model. The actual content model will * be reported by childElement, startModelGroup, endModelGroup, and * connector methods. Possible call sequences are: - *

+ *

* START := MODEL_GROUP * MODEL_GROUP := startModelGroup TOKEN (connector TOKEN)* endModelGroup * TOKEN := childElement @@ -300,8 +300,8 @@ /** * For each entry in an ATTLIST declaration, * this event will be fired. - *

- *

+ *

+ *

* DTD allows the same attributes to be declared more than * once, and in that case the first one wins. I think * this method will be only fired for the first one, @@ -329,11 +329,9 @@ /** * Connectors in one model group is guaranteed to be the same. - *

- *

+ *

+ *

* IOW, you'll never see an event sequence like (a|b,c) - * - * @return {@link #CHOICE} or {@link #SEQUENCE}. */ public void connector(short connectorType) throws SAXException;