--- old/src/java.xml/share/classes/javax/xml/stream/util/XMLEventAllocator.java	2020-08-24 17:28:58.784414093 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/util/XMLEventAllocator.java	2020-08-24 17:28:58.499399552 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 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
@@ -47,6 +47,7 @@
   /**
    * This method creates an instance of the XMLEventAllocator. This
    * allows the XMLInputFactory to allocate a new instance per reader.
+   * @return an instance of the {@code XMLEventAllocator}
    */
   public XMLEventAllocator newInstance();
 
@@ -58,6 +59,7 @@
    * must not modify the state of the XMLStreamReader.
    * @param reader The XMLStreamReader to allocate from
    * @return the event corresponding to the current reader state
+   * @throws XMLStreamException if an error occurs
    */
   public XMLEvent allocate(XMLStreamReader reader)
     throws XMLStreamException;
@@ -72,6 +74,7 @@
    * This method may modify the state of the XMLStreamReader.
    * @param reader The XMLStreamReader to allocate from
    * @param consumer The XMLEventConsumer to add to.
+   * @throws XMLStreamException if an error occurs
    */
   public void allocate(XMLStreamReader reader, XMLEventConsumer consumer)
     throws XMLStreamException;