[ 
https://issues.apache.org/jira/browse/CSV-161?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15106169#comment-15106169
 ] 

Gary Gregory commented on CSV-161:
----------------------------------

I've renamed this ticket to {{Fix Javadoc to say CSVFormat with() methods 
return a new CSVFormat}} and updated the Javadoc to make it crystal clear that 
a new {{CSVFormat}} is always returned from {{with()}} methods.

For example:

{code:java}
    /**
     * Returns a new {@code CSVFormat} with the output quote policy of the 
format set to the specified value.
     *
     * @param quoteModePolicy
     *            the quote policy to use for output.
     *
     * @return A new CSVFormat that is equal to this but with the specified 
quote policy
     */
{code}

Note that the {{@return tag}} was already explicit but the main comment was not.

> Fix Javadoc to say CSVFormat with() methods return a new CSVFormat
> ------------------------------------------------------------------
>
>                 Key: CSV-161
>                 URL: https://issues.apache.org/jira/browse/CSV-161
>             Project: Commons CSV
>          Issue Type: Bug
>    Affects Versions: 1.2
>         Environment: JDK 1.8
>            Reporter: Kristof Meixner
>         Attachments: VariousLibraryTests.java
>
>
> The quoting mode depends on the order of format declaration.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to