Re: [RNG] How to write Javadoc (Was: ... commit: Fixed the javadoc errors with Java 8)

2016-09-29 Thread Gilles
On Thu, 29 Sep 2016 10:55:07 +0200, Emmanuel Bourg wrote: Le 29/09/2016 à 01:37, Gilles a écrit : The more so that the issue was encountered by several people in different components, and IIRC now, the consensus (or workaround) had been to indeed disable "doclint". This is a wise workaround,

Re: [RNG] How to write Javadoc (Was: ... commit: Fixed the javadoc errors with Java 8)

2016-09-29 Thread Emmanuel Bourg
Le 29/09/2016 à 01:37, Gilles a écrit : > The more so that the issue was encountered by several people > in different components, and IIRC now, the consensus (or > workaround) had been to indeed disable "doclint". This is a wise workaround, fixing old Javadocs is a waste of time, but it isn't for

Re: [RNG] How to write Javadoc (Was: ... commit: Fixed the javadoc errors with Java 8)

2016-09-28 Thread Emmanuel Bourg
Le 29/09/2016 à 02:07, Gary Gregory a écrit : > > I agree that paragraphs should be written like this. > Personally for paragraphs I prefer this more compact form: Blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah And

Re: [RNG] How to write Javadoc (Was: ... commit: Fixed the javadoc errors with Java 8)

2016-09-28 Thread Gary Gregory
I agree that paragraphs should be written like this. Gary On Wed, Sep 28, 2016 at 4:37 PM, Gilles wrote: > > Thanks for the non-trivial details that make the change > understandable. > > It would have been nice to post this information on the ML, > before applying the changes. > The more so

[RNG] How to write Javadoc (Was: ... commit: Fixed the javadoc errors with Java 8)

2016-09-28 Thread Gilles
Thanks for the non-trivial details that make the change understandable. It would have been nice to post this information on the ML, before applying the changes. The more so that the issue was encountered by several people in different components, and IIRC now, the consensus (or workaround) had b