[
https://issues.apache.org/jira/browse/COLLECTIONS-859?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17863424#comment-17863424
]
Gary D. Gregory commented on COLLECTIONS-859:
---------------------------------------------
Hello [~ferra]
Thank you for your report.
Would you be willing to provide a PR on GitHub to improve the Javadoc?
TY
> Ambiguity in the javadoc
> ------------------------
>
> Key: COLLECTIONS-859
> URL: https://issues.apache.org/jira/browse/COLLECTIONS-859
> Project: Commons Collections
> Issue Type: Bug
> Reporter: Daniele
> Priority: Minor
>
> I found some ambiguities in the javadoc regarding the behavior of some
> methods:
> {*}PredicateUtils.nullIsExceptionPredicate(Predicate<? super T>):{*}{*}{*}
> When it says "return the predicate" doesn't mean return the predicate
> parameter (args[0]), but return a new predicate that checks if the input is
> null and, if so, throws an exception, otherwise, delegates the evaluation to
> predicate (args[0]).
> *PredicateUtils.nullIsFalsePredicate(Predicate<? super T>):*
> When it says "return the predicate" doesn't mean return the predicate
> parameter (args[0]), but return a new predicate that checks if the input is
> null and, if so, return false, otherwise, delegates the evaluation to
> predicate (args[0]).
> *PredicateUtils.nullIsTruePredicate(Predicate<? super T>):*
> W{*}{*}hen it says "return the predicate" doesn't mean return the predicate
> parameter (args[0]), but return a new predicate that checks if the input is
> null and, if so, return true, otherwise, delegates the evaluation to
> predicate (args[0]).
> *PredicateUtils.transformedPredicate(Transformer<? super T, ? extends T>,
> Predicate<? super T>):*
> When it says "return the predicate" doesn't mean return the predicate
> parameter (args[0]), but return a new predicate that create a predicate that
> transforms the input object before passing it to the predicate
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
