Yea, sure. But doesn't a new shorthand syntax always have that trait ?-)
And would that not mean that we can never, ever again introduce a
shorthand notation in Groovy for anything, unless it is syntactically
based on an existing/established shorthand notation (which in this case
it kinda is, since it looks like a Javadoc comment - with something
extra. Aka Groovy ;-) ) ?
Learning a language always means learning its syntax. If you encounter
something unexpected, Google is your friend (Not a Google expert, but I
assume "/**@" should be good to find, since it contains no spaces).
Also in this case I think it would not make a lot of difference to the
casual user: He will most likely just assume it is some kind of Javadoc
variety, if he even notices the "@" at the end.
Instead of outright blocking another proposal by Daniel, maybe we can
instead come up with a compromise that everyone can can agree on... ?-)
Cheers,
mg
On 21.10.2018 10:51, Guillaume Laforge wrote:
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 <mg...@arscreat.com
<mailto:mg...@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>