--- old/src/java.desktop/share/classes/javax/swing/text/AbstractWriter.java 2015-04-14 15:34:33.859836818 -0700 +++ new/src/java.desktop/share/classes/javax/swing/text/AbstractWriter.java 2015-04-14 15:34:33.711836815 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 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 @@ -186,7 +186,7 @@ /** * Returns the first offset to be output. - * + * @return the first offset to be output * @since 1.3 */ public int getStartOffset() { @@ -195,7 +195,7 @@ /** * Returns the last offset to be output. - * + * @return the last offset to be output * @since 1.3 */ public int getEndOffset() { @@ -213,7 +213,7 @@ /** * Returns the Writer that is used to output the content. - * + * @return the Writer that is used to output the content * @since 1.3 */ protected Writer getWriter() { @@ -257,6 +257,9 @@ * by subclasses. Its responsibility is to * iterate over the elements and use the write() * methods to generate output in the desired format. + * @throws IOException if an I/O problem has occurred + * @throws BadLocationException for an invalid location within + * the document */ abstract protected void write() throws IOException, BadLocationException; @@ -314,7 +317,7 @@ /** * Returns the maximum line length. - * + * @return the maximum line length * @since 1.3 */ protected int getLineLength() { @@ -323,7 +326,7 @@ /** * Sets the current line length. - * + * @param length the new line length * @since 1.3 */ protected void setCurrentLineLength(int length) { @@ -333,7 +336,7 @@ /** * Returns the current line length. - * + * @return the current line length * @since 1.3 */ protected int getCurrentLineLength() { @@ -344,7 +347,7 @@ * Returns true if the current line should be considered empty. This * is true when getCurrentLineLength == 0 || * indent has been invoked on an empty line. - * + * @return true if the current line should be considered empty * @since 1.3 */ protected boolean isLineEmpty() { @@ -355,7 +358,7 @@ * Sets whether or not lines can be wrapped. This can be toggled * during the writing of lines. For example, outputting HTML might * set this to false when outputting a quoted string. - * + * @param newValue new value for line wrapping * @since 1.3 */ protected void setCanWrapLines(boolean newValue) { @@ -365,7 +368,7 @@ /** * Returns whether or not the lines can be wrapped. If this is false * no lineSeparator's will be output. - * + * @return whether or not the lines can be wrapped * @since 1.3 */ protected boolean getCanWrapLines() { @@ -385,7 +388,7 @@ /** * Returns the amount of space to indent. - * + * @return the amount of space to indent * @since 1.3 */ protected int getIndentSpace() { @@ -396,7 +399,7 @@ * Sets the String used to represent newlines. This is initialized * in the constructor from either the Document, or the System property * line.separator. - * + * @param value the new line separator * @since 1.3 */ public void setLineSeparator(String value) { @@ -405,7 +408,7 @@ /** * Returns the string used to represent newlines. - * + * @return the string used to represent newlines * @since 1.3 */ public String getLineSeparator() { @@ -446,7 +449,7 @@ * Returns the current indentation level. That is, the number of times * incrIndent has been invoked minus the number of times * decrIndent has been invoked. - * + * @return the current indentation level * @since 1.3 */ protected int getIndentLevel() { @@ -514,7 +517,7 @@ /** * Writes the line separator. This invokes output directly * as well as setting the lineLength to 0. - * + * @throws IOException on any I/O error * @since 1.3 */ protected void writeLineSeparator() throws IOException { @@ -539,6 +542,10 @@ * and won't fit in which case the line length will exceed * getLineLength. * + * @param chars characters to output + * @param startIndex starting index + * @param length length of output + * @throws IOException on any I/O error * @since 1.3 */ protected void write(char[] chars, int startIndex, int length) @@ -686,6 +693,10 @@ * writeLineSeparator to write out a newline, which will * property update the current line length. * + * @param content characters to output + * @param start starting index + * @param length length of output + * @throws IOException on any I/O error * @since 1.3 */ protected void output(char[] content, int start, int length)