Re: Enhancing SystemML JavaDocs

2016-10-02 Thread Niketan Pansare
mail: npansar At us.ibm.com http://researcher.watson.ibm.com/researcher/view.php?person=us-npansar From: Frederick R Reiss/Almaden/IBM@IBMUS To: dev@systemml.incubator.apache.org Date: 09/30/2016 04:33 PM Subject:Re: Enhancing SystemML JavaDocs Wow, I was not aware that t

Re: Enhancing SystemML JavaDocs

2016-09-30 Thread Frederick R Reiss
Subject:Re: Enhancing SystemML JavaDocs On Fri, Sep 30, 2016 at 1:42 PM, Deron Eriksson wrote: > I do not see how these automatically generated javadocs are useful. For > instance: > > /** > * > * @param pb > * @param ec > * @return > * @throws DMLRuntimeException

Re: Enhancing SystemML JavaDocs

2016-09-30 Thread Luciano Resende
On Fri, Sep 30, 2016 at 1:42 PM, Deron Eriksson wrote: > I do not see how these automatically generated javadocs are useful. For > instance: > > /** > * > * @param pb > * @param ec > * @return > * @throws DMLRuntimeException > */ > public static double getTimeEstimate(ProgramBlock pb, ExecutionCo

Re: Enhancing SystemML JavaDocs

2016-09-30 Thread Deron Eriksson
o, I am definitely in favor of fixing these javad]Deron > Eriksson ---09/30/2016 12:35:30 PM---Hi Luciano, I am definitely in favor > of fixing these javadocs. I created > > From: Deron Eriksson > To: dev@systemml.incubator.apache.org > Date: 09/30/2

Re: Enhancing SystemML JavaDocs

2016-09-30 Thread Matthias Boehm
:Re: Enhancing SystemML JavaDocs Hi Luciano, I am definitely in favor of fixing these javadocs. I created https://issues.apache.org/jira/browse/SYSTEMML-842 two months ago to address this issue. However, there are so many problems with the javadocs that I think addressing this should

Re: Enhancing SystemML JavaDocs

2016-09-30 Thread Deron Eriksson
Hi Luciano, I am definitely in favor of fixing these javadocs. I created https://issues.apache.org/jira/browse/SYSTEMML-842 two months ago to address this issue. However, there are so many problems with the javadocs that I think addressing this should probably be broken down into separate java pa

Enhancing SystemML JavaDocs

2016-09-30 Thread Luciano Resende
Currently we have a bunch of wrong, incomplete or obsolete javadocs on our APIs, and this continue o grow because we have the following configuration in our build: ignore-doclint-warnings-for-javadocs-on-java-8 [1.8,)