Updated test comments for print tests targeting IOUtils.

Author: aherbert

src/test/java/org/apache/commons/csv/CSVPrinterTest.java

@@ -1471,11 +1471,18 @@ private String[] toFirstRecordValues(final String expected, final CSVFormat form
         return CSVParser.parse(expected, format).getRecords().get(0).values();
     }
 
+    /**
+     * Test to target the use of {@link IOUtils#copyLarge(java.io.Reader, Writer)} which directly
+     * buffers the value from the Reader to the Writer.
+     *
+     * <p>Requires the format to have no quote or escape character, value to be a
+     * {@link java.io.Reader Reader} and the output <i>MUST</i> be a
+     * {@link java.io.Writer Writer}.</p>
+     *
+     * @throws IOException Not expected to happen
+     */
     @Test
     public void testPrintReaderWithoutQuoteToWriter() throws IOException {
-        // Test to target the use of IOUtils::copyLarge.
-        // Requires the format to have no quote or escape character,
-        // value to be a java.io.Reader and the output to be a java.io.Writer.
         final StringWriter sw = new StringWriter();
         final String content = "testValue";
         try (final CSVPrinter printer = new CSVPrinter(sw, CSVFormat.DEFAULT.withQuote(null))) {
@@ -1485,11 +1492,18 @@ public void testPrintReaderWithoutQuoteToWriter() throws IOException {
         assertEquals(content, sw.toString());
     }
 
+    /**
+     * Test to target the use of {@link IOUtils#copy(java.io.Reader, Appendable)} which directly
+     * buffers the value from the Reader to the Appendable.
+     *
+     * <p>Requires the format to have no quote or escape character, value to be a
+     * {@link java.io.Reader Reader} and the output <i>MUST NOT</i> be a
+     * {@link java.io.Writer Writer} but some other Appendable.</p>
+     *
+     * @throws IOException Not expected to happen
+     */
     @Test
     public void testPrintReaderWithoutQuoteToAppendable() throws IOException {
-        // Test to target the use of IOUtils::copy.
-        // Requires the format to have no quote or escape character,
-        // value to be a java.io.Reader and the output to not be a java.io.Writer.
         final StringBuilder sb = new StringBuilder();
         final String content = "testValue";
         try (final CSVPrinter printer = new CSVPrinter(sb, CSVFormat.DEFAULT.withQuote(null))) {