Mailing-List: contact dev-help@groovy.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@groovy.apache.org
MIME-Version: 1.0
In-Reply-To: 
 <CANBeYQSgVTjpgL6u1Lqad_jJzonX6puHXipiTvjgp9iG+4G7rg@mail.gmail.com>
References: 
 <CANBeYQQs9Tn9ONK5cfGxrWYqa6YZXxjFEgOcfH8o9fdSrEbzFw@mail.gmail.com>
	<CAAsy7bGMKyNpsAMpRQweF83JrVJ0BBCtfuVTqHTq6CF2w_pE9w@mail.gmail.com>
	<CANBeYQTeGwam24O3jxU80z6Hz5ru++GxH6Nqtxjq2XjV9pM3Xg@mail.gmail.com>
	<CAJ2HCd8zxZjj5DVYLihiQpkr5-U06L=azrUPU2jNuUJCpcdtEw@mail.gmail.com>
	<CAAsy7bH+z0AUhqr1U_TxTCHv2qnj_Uv3wukYqqED9BgMRcmgaw@mail.gmail.com>
	<CANBeYQSgVTjpgL6u1Lqad_jJzonX6puHXipiTvjgp9iG+4G7rg@mail.gmail.com>
Date: Mon, 1 Feb 2016 09:55:21 +0100
Message-ID: 
 <CAAsy7bG8A_Wyc9aEbp=vWukLNfMjaC0icdxTqo2LQtXffm1giw@mail.gmail.com>
Subject: Re: API document generation
From: Andres Almiray <aalmiray@gmail.com>
To: dev@groovy.apache.org
Content-Type: multipart/alternative; boundary=001a113f99b285f1ce052ab18b70

--001a113f99b285f1ce052ab18b70
Content-Type: text/plain; charset=UTF-8

Well, Groovydoc is a parallel API inspired by Javadoc, so retrofitting
would entail grabbing the real Javadoc tooling API and adding extension
points that can handle Groovy syntax such as understanding properties,
closures and other stuff (such as default values in method parameters IIRC).

-------------------------------------------
Java Champion; Groovy Enthusiast
http://jroller.com/aalmiray
http://www.linkedin.com/in/aalmiray
--
What goes up, must come down. Ask any system administrator.
There are 10 types of people in the world: Those who understand binary, and
those who don't.
To understand recursion, we must first understand recursion.

On Mon, Feb 1, 2016 at 9:51 AM, Peter Ledbrook <peter@cacoethes.co.uk>
wrote:

> I'm afraid not. Javadoc is a very specific tool that looks exclusively
>> into Java sources.
>> My experience in the past extending Groovydoc tells me the only way to
>> integrate with Javadoc tooling and doclets is to embrace and extend the
>> Javadoc API.
>>
>
> How feasible is it to retrofit Groovydoc to the Javadoc API do you think?
> I assume that's what you're saying, if not necessarily recommending.
>
> Peter
>

--001a113f99b285f1ce052ab18b70
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">Well, Groovydoc is a parallel API inspired by Javadoc, so =
retrofitting would entail grabbing the real Javadoc tooling API and adding =
extension points that can handle Groovy syntax such as understanding proper=
ties, closures and other stuff (such as default values in method parameters=
 IIRC).<br></div><div class=3D"gmail_extra"><br clear=3D"all"><div><div cla=
ss=3D"gmail_signature">-------------------------------------------<br>Java =
Champion; Groovy Enthusiast<br><a href=3D"http://jroller.com/aalmiray" targ=
et=3D"_blank">http://jroller.com/aalmiray</a><br><a href=3D"http://www.link=
edin.com/in/aalmiray" target=3D"_blank">http://www.linkedin.com/in/aalmiray=
</a><br>--<br>What goes up, must come down. Ask any system administrator.<b=
r>There are 10 types of people in the world: Those who understand binary, a=
nd those who don&#39;t.<br>To understand recursion, we must first understan=
d recursion.</div></div>
<br><div class=3D"gmail_quote">On Mon, Feb 1, 2016 at 9:51 AM, Peter Ledbro=
ok <span dir=3D"ltr">&lt;<a href=3D"mailto:peter@cacoethes.co.uk" target=3D=
"_blank">peter@cacoethes.co.uk</a>&gt;</span> wrote:<br><blockquote class=
=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padd=
ing-left:1ex"><div dir=3D"ltr"><div class=3D"gmail_quote"><span class=3D"">=
<blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p=
x #ccc solid;padding-left:1ex"><div dir=3D"ltr"><div>I&#39;m afraid not. Ja=
vadoc is a very specific tool that looks exclusively into Java sources.<br>=
</div>My experience in the past extending Groovydoc tells me the only way t=
o integrate with Javadoc tooling and doclets is to embrace and extend the J=
avadoc API.</div></blockquote><div><br></div></span><div>How feasible is it=
 to retrofit Groovydoc to the Javadoc API do you think? I assume that&#39;s=
 what you&#39;re saying, if not necessarily recommending.</div><span class=
=3D"HOEnZb"><font color=3D"#888888"><div><br></div><div>Peter=C2=A0</div></=
font></span></div></div>
</blockquote></div><br></div>

--001a113f99b285f1ce052ab18b70--