src/java.xml/share/classes/org/xml/sax/ext/LexicalHandler.java

*** 1,7 ****
  /*
!  * Copyright (c) 2000, 2019, 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
--- 1,7 ----
  /*
!  * Copyright (c) 2000, 2020, 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
*** 87,97 ****
       *        external DTD subset, or null if none was declared.
       * @param systemId The declared system identifier for the
       *        external DTD subset, or null if none was declared.
       *        (Note that this is not resolved against the document
       *        base URI.)
!      * @exception SAXException The application may raise an
       *            exception.
       * @see #endDTD
       * @see #startEntity
       */
      public abstract void startDTD (String name, String publicId,
--- 87,97 ----
       *        external DTD subset, or null if none was declared.
       * @param systemId The declared system identifier for the
       *        external DTD subset, or null if none was declared.
       *        (Note that this is not resolved against the document
       *        base URI.)
!      * @throws SAXException The application may raise an
       *            exception.
       * @see #endDTD
       * @see #startEntity
       */
      public abstract void startDTD (String name, String publicId,
*** 104,114 ****
       *
       * <p>This method is intended to report the end of the
       * DOCTYPE declaration; if the document has no DOCTYPE declaration,
       * this method will not be invoked.</p>
       *
!      * @exception SAXException The application may raise an exception.
       * @see #startDTD
       */
      public abstract void endDTD ()
          throws SAXException;
  
--- 104,114 ----
       *
       * <p>This method is intended to report the end of the
       * DOCTYPE declaration; if the document has no DOCTYPE declaration,
       * this method will not be invoked.</p>
       *
!      * @throws SAXException The application may raise an exception.
       * @see #startDTD
       */
      public abstract void endDTD ()
          throws SAXException;
  
*** 155,165 ****
       * <p>All start/endEntity events must be properly nested.
       *
       * @param name The name of the entity.  If it is a parameter
       *        entity, the name will begin with '%', and if it is the
       *        external DTD subset, it will be "[dtd]".
!      * @exception SAXException The application may raise an exception.
       * @see #endEntity
       * @see org.xml.sax.ext.DeclHandler#internalEntityDecl
       * @see org.xml.sax.ext.DeclHandler#externalEntityDecl
       */
      public abstract void startEntity (String name)
--- 155,165 ----
       * <p>All start/endEntity events must be properly nested.
       *
       * @param name The name of the entity.  If it is a parameter
       *        entity, the name will begin with '%', and if it is the
       *        external DTD subset, it will be "[dtd]".
!      * @throws SAXException The application may raise an exception.
       * @see #endEntity
       * @see org.xml.sax.ext.DeclHandler#internalEntityDecl
       * @see org.xml.sax.ext.DeclHandler#externalEntityDecl
       */
      public abstract void startEntity (String name)
*** 168,178 ****
  
      /**
       * Report the end of an entity.
       *
       * @param name The name of the entity that is ending.
!      * @exception SAXException The application may raise an exception.
       * @see #startEntity
       */
      public abstract void endEntity (String name)
          throws SAXException;
  
--- 168,178 ----
  
      /**
       * Report the end of an entity.
       *
       * @param name The name of the entity that is ending.
!      * @throws SAXException The application may raise an exception.
       * @see #startEntity
       */
      public abstract void endEntity (String name)
          throws SAXException;
  
*** 183,203 ****
       * <p>The contents of the CDATA section will be reported through
       * the regular {@link org.xml.sax.ContentHandler#characters
       * characters} event; this event is intended only to report
       * the boundary.</p>
       *
!      * @exception SAXException The application may raise an exception.
       * @see #endCDATA
       */
      public abstract void startCDATA ()
          throws SAXException;
  
  
      /**
       * Report the end of a CDATA section.
       *
!      * @exception SAXException The application may raise an exception.
       * @see #startCDATA
       */
      public abstract void endCDATA ()
          throws SAXException;
  
--- 183,203 ----
       * <p>The contents of the CDATA section will be reported through
       * the regular {@link org.xml.sax.ContentHandler#characters
       * characters} event; this event is intended only to report
       * the boundary.</p>
       *
!      * @throws SAXException The application may raise an exception.
       * @see #endCDATA
       */
      public abstract void startCDATA ()
          throws SAXException;
  
  
      /**
       * Report the end of a CDATA section.
       *
!      * @throws SAXException The application may raise an exception.
       * @see #startCDATA
       */
      public abstract void endCDATA ()
          throws SAXException;
  
*** 212,222 ****
       * used).</p>
       *
       * @param ch An array holding the characters in the comment.
       * @param start The starting position in the array.
       * @param length The number of characters to use from the array.
!      * @exception SAXException The application may raise an exception.
       */
      public abstract void comment (char ch[], int start, int length)
          throws SAXException;
  
  }
--- 212,222 ----
       * used).</p>
       *
       * @param ch An array holding the characters in the comment.
       * @param start The starting position in the array.
       * @param length The number of characters to use from the array.
!      * @throws SAXException The application may raise an exception.
       */
      public abstract void comment (char ch[], int start, int length)
          throws SAXException;
  
  }