jdk-sandbox: comparison jaxws/src/jdk.xml.bind/share/classes/com/sun/xml/internal/dtdparser/DTDEventListener.java

equal deleted inserted replaced

-:d131f4b8433a
+:e4c76ac38b12
 /*
-* 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
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 throws SAXException;
 /**
 * Receive notification of an external parsed general entity
 * declaration event.
-* <p/>
+* <p>
 * <p>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.</p>
 *
 * @param name     The entity name.
 throws SAXException;
 /**
 * Receive notification of an external parameter entity declaration
 * event.
-* <p/>
+* <p>
 * <p>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.</p>
 *
 * @param name     The parameter entity name.
 public void endDTD()
 throws SAXException;
 /**
 * Receive notification that a comment has been read.
-* <p/>
+* <p>
 * <P> 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
 * found in processing instructions; this is not true of comments, which
 * are typically discarded.
 public void comment(String text)
 throws SAXException;
 /**
 * Receive notification of character data.
-* <p/>
+* <p>
 * <p>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.</p>
-* <p/>
+* <p>
 * <p>The application must not attempt to read from the array
 * outside of the specified range.</p>
-* <p/>
+* <p>
 * <p>Note that some parsers will report whitespace using the
 * ignorableWhitespace() method rather than this one (validating
 * parsers must do so).</p>
 *
 * @param ch     The characters from the DTD.
 throws SAXException;
 /**
 * Receive notification of ignorable whitespace in element content.
-* <p/>
+* <p>
 * <p>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.</p>
-* <p/>
+* <p>
 * <p>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.</p>
-* <p/>
+* <p>
 * <p>The application must not attempt to read from the array
 * outside of the specified range.</p>
 *
 * @param ch     The characters from the DTD.
 * @param start  The start position in the array.
 *                         each child element will be reported by mixedElement method.
 *                         {@link #CONTENT_MODEL_CHILDREN}
 *                         this elemen has child content model. The actual content model will
 *                         be reported by childElement, startModelGroup, endModelGroup, and
 *                         connector methods. Possible call sequences are:
-*                         <p/>
+*                         <p>
 *                         START := MODEL_GROUP
 *                         MODEL_GROUP := startModelGroup TOKEN (connector TOKEN)* endModelGroup
 *                         TOKEN := childElement
 *                         | MODEL_GROUP
 */
 public final short USE_REQUIRED = 3;
 /**
 * For each entry in an ATTLIST declaration,
 * this event will be fired.
-* <p/>
+* <p>
-* <p/>
+* <p>
 * 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,
 * but I need to check.
 */
 public final short CHOICE = 0;
 public final short SEQUENCE = 1;
 /**
 * Connectors in one model group is guaranteed to be the same.
-* <p/>
+* <p>
-* <p/>
+* <p>
 * 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;
 public final short OCCURENCE_ZERO_OR_MORE = 0;
 public final short OCCURENCE_ONE_OR_MORE = 1;

changeset 33547	e4c76ac38b12
parent 25871	b80b84e87032