diff -r 33de7752835c -r 94bb65cb37d3 src/java.base/share/classes/java/io/PushbackReader.java --- a/src/java.base/share/classes/java/io/PushbackReader.java Fri Sep 20 11:33:30 2019 +0800 +++ b/src/java.base/share/classes/java/io/PushbackReader.java Fri Sep 20 11:07:52 2019 +0100 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1996, 2015, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1996, 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 @@ -47,7 +47,7 @@ * * @param in The reader from which characters will be read * @param size The size of the pushback buffer - * @exception IllegalArgumentException if {@code size <= 0} + * @throws IllegalArgumentException if {@code size <= 0} */ public PushbackReader(Reader in, int size) { super(in); @@ -79,7 +79,7 @@ * @return The character read, or -1 if the end of the stream has been * reached * - * @exception IOException If an I/O error occurs + * @throws IOException If an I/O error occurs */ public int read() throws IOException { synchronized (lock) { @@ -101,8 +101,8 @@ * @return The number of characters read, or -1 if the end of the * stream has been reached * - * @exception IOException If an I/O error occurs - * @exception IndexOutOfBoundsException {@inheritDoc} + * @throws IOException If an I/O error occurs + * @throws IndexOutOfBoundsException {@inheritDoc} */ public int read(char cbuf[], int off, int len) throws IOException { synchronized (lock) { @@ -146,8 +146,8 @@ * * @param c The int value representing a character to be pushed back * - * @exception IOException If the pushback buffer is full, - * or if some other I/O error occurs + * @throws IOException If the pushback buffer is full, + * or if some other I/O error occurs */ public void unread(int c) throws IOException { synchronized (lock) { @@ -165,11 +165,11 @@ * character after that will have the value cbuf[off+1], and * so forth. * - * @param cbuf Character array - * @param off Offset of first character to push back - * @param len Number of characters to push back + * @param cbuf Character array + * @param off Offset of first character to push back + * @param len Number of characters to push back * - * @exception IOException If there is insufficient room in the pushback + * @throws IOException If there is insufficient room in the pushback * buffer, or if some other I/O error occurs */ public void unread(char cbuf[], int off, int len) throws IOException { @@ -188,9 +188,9 @@ * read will have the value cbuf[0], the character after that * will have the value cbuf[1], and so forth. * - * @param cbuf Character array to push back + * @param cbuf Character array to push back * - * @exception IOException If there is insufficient room in the pushback + * @throws IOException If there is insufficient room in the pushback * buffer, or if some other I/O error occurs */ public void unread(char cbuf[]) throws IOException { @@ -200,7 +200,7 @@ /** * Tells whether this stream is ready to be read. * - * @exception IOException If an I/O error occurs + * @throws IOException If an I/O error occurs */ public boolean ready() throws IOException { synchronized (lock) { @@ -213,7 +213,7 @@ * Marks the present position in the stream. The mark * for class PushbackReader always throws an exception. * - * @exception IOException Always, since mark is not supported + * @throws IOException Always, since mark is not supported */ public void mark(int readAheadLimit) throws IOException { throw new IOException("mark/reset not supported"); @@ -223,7 +223,7 @@ * Resets the stream. The reset method of * PushbackReader always throws an exception. * - * @exception IOException Always, since reset is not supported + * @throws IOException Always, since reset is not supported */ public void reset() throws IOException { throw new IOException("mark/reset not supported"); @@ -244,7 +244,7 @@ * Closing a previously closed stream has no effect. This method will block * while there is another thread blocking on the reader. * - * @exception IOException If an I/O error occurs + * @throws IOException If an I/O error occurs */ public void close() throws IOException { synchronized (lock) { @@ -257,12 +257,12 @@ * Skips characters. This method will block until some characters are * available, an I/O error occurs, or the end of the stream is reached. * - * @param n The number of characters to skip + * @param n The number of characters to skip * * @return The number of characters actually skipped * - * @exception IllegalArgumentException If n is negative. - * @exception IOException If an I/O error occurs + * @throws IllegalArgumentException If n is negative. + * @throws IOException If an I/O error occurs */ public long skip(long n) throws IOException { if (n < 0L)