groovy-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Guillaume Laforge <glafo...@gmail.com>
Subject Re: About simplifying the switch for runtime groovydoc
Date Sun, 21 Oct 2018 08:51:09 GMT
Well, /** has been in use for more than 20 years, so we've had time to get
used to it.
/**@ is totally non-obvious. I've no idea what it would have been about
without having read this thread.

On Sun, Oct 21, 2018 at 4:28 AM MG <mgbiz@arscreat.com> wrote:

> I agree with Daniel, I think
> /**@
> would be neither more nor less cryptic than
> /**
> which everyone is just used to from Java (and which seems to have no
> memnonic / self-explanatory characteristics to me...).
>
> Cheers,
> mg
>
>
> On 21.10.2018 03:04, Daniel.Sun wrote:
> > Hi Guillaume,
> >
> >         Javadoc switch `/**` is cryptic too at the beginning, but now I
> > believe few people like the following form ;-)
> >
> > /*
> >    * @Javadoc
> >    * some Javadoc here
> >    */
> >
> > Cheers,
> > Daniel.Sun
> >
> >
> >
> >
> > -----
> > Daniel Sun
> > Apache Groovy committer
> > Blog: http://blog.sunlan.me
> > Twitter: @daniel_sun
> >
> > --
> > Sent from: http://groovy.329449.n5.nabble.com/Groovy-Dev-f372993.html
> >
>
>

-- 
Guillaume Laforge
Apache Groovy committer & PMC Vice-President
Developer Advocate @ Google Cloud Platform

Blog: http://glaforge.appspot.com/
Twitter: @glaforge <http://twitter.com/glaforge>

Mime
View raw message