You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@netbeans.apache.org by Eric Barboni <sk...@apache.org> on 2022/09/08 09:05:07 UTC
RE: Bringing apidoc back
Hi
A PR https://github.com/apache/netbeans/pull/4450 with almost all the link break fixes is there.
I would like to merge ASAP so we can keep future version as clean as possible according to missing link.
I will have to patch build system / json to have a second jdk for javadoc.
Two PR to have former links via webarchive on our website.
https://github.com/apache/netbeans-website/pull/608
https://github.com/apache/netbeans-website/pull/607
Best Regards
Eric
-----Message d'origine-----
De : Jaroslav Tulach <ja...@gmail.com>
Envoyé : samedi 13 août 2022 12:57
À : dev <de...@netbeans.apache.org>
Objet : Re: Bringing apidoc back
Amazing! Thank you for fixing the broken links.
-jt
Dne po 8. 8. 2022 19:51 uživatel Eric Barboni <sk...@apache.org> napsal:
> Hi folks,
>
> I started a PR to clean up the api doc. The main goal is that we need
> javadoc to success with failonerror set to true. Because if it fails
> only architecture and api change are generated but not the javadoc.
>
>
> The most important issue is the following :
> On the master it’s currently not possible to build using jdk 11
> because java.source.base need a classpath with nbjavac (jdk 18) (they
> may be other modules involved). I’m not sure if providing a javadoc
> for nbjavac could help as Neil comment.
> For being able to fix javadoc issue in source
> - I use a jdk 18 to be consitent with the jdk nb-javac use.
> - I changed the javadoc checker to check all the html file to remove
> maximum issue
>
> And there is a lots of issues 😃
>
> fixed the apichanges,arch.xml
> fixed typos on doc ( like < < ; )
> removed links that were using private/protected reference. (we expose
> only org.netbeans.api.*, org.netbeans.spi.*) using our new
> netbeans.apache.org url as much as possible. And also coherent url
> pattern.
>
>
> So 1000 modifications later it compile on master with only a few bad
> links remaining
>
> Here is a list of the faulty links
>
> https://cwiki.apache.org/confluence/display/NETBEANS/NetBeans+apidoc+r
> eferenced+url That the second issue: the missing page from fomer
> netbeans website and blogs. Web.archive.org get them all.
>
> So I need your advise what to do with that.
> 1) Change the links to web.archiva.org
> 2) Remove the links
> 3) Copy from webarchive to our site but I'm unsure of the copyright here.
> 4) other idea
>
> In the case of 3) could we have.
> netbeans.apache.org/projects/autoupdate,
> netbeans.apache.org/projects/ui
>
> Best regards
> Eric
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
RE: Bringing apidoc back
Posted by Eric Barboni <sk...@apache.org>.
Hi,
Private and friend module will still be there.
But the javadoc is limited to public signature and package.
If there is a private field/method in a class from a published javadoc it twill not be accessible. I guess this like that since a long time.
Best Regards,
Eric
-----Message d'origine-----
De : Jean-Marc Borer <jm...@gmail.com>
Envoyé : jeudi 22 septembre 2022 11:57
À : dev@netbeans.apache.org
Objet : Re: Bringing apidoc back
Hi Eric,
Thank you for the job.
There is one thing that I am unsure to have properly understood. As a NBP advanced user, I often refer and use the Javadoc of private and friend modules.
Will the new site still provide it for the DEV version (currently on bits.netbeans.org it is broken)?
This is something really important for me.
Best Regards,
JM
On Thu, Sep 8, 2022 at 9:05 AM Eric Barboni <sk...@apache.org> wrote:
> Hi
>
> A PR https://github.com/apache/netbeans/pull/4450 with almost all the
> link break fixes is there.
>
>
> I would like to merge ASAP so we can keep future version as clean as
> possible according to missing link.
> I will have to patch build system / json to have a second jdk for javadoc.
>
> Two PR to have former links via webarchive on our website.
> https://github.com/apache/netbeans-website/pull/608
> https://github.com/apache/netbeans-website/pull/607
>
>
> Best Regards
> Eric
>
> -----Message d'origine-----
> De : Jaroslav Tulach <ja...@gmail.com> Envoyé : samedi 13
> août 2022 12:57 À : dev <de...@netbeans.apache.org> Objet : Re: Bringing
> apidoc back
>
> Amazing! Thank you for fixing the broken links.
> -jt
>
>
> Dne po 8. 8. 2022 19:51 uživatel Eric Barboni <sk...@apache.org> napsal:
>
> > Hi folks,
> >
> > I started a PR to clean up the api doc. The main goal is that we
> > need javadoc to success with failonerror set to true. Because if it
> > fails only architecture and api change are generated but not the javadoc.
> >
> >
> > The most important issue is the following :
> > On the master it’s currently not possible to build using jdk 11
> > because java.source.base need a classpath with nbjavac (jdk 18)
> > (they may be other modules involved). I’m not sure if providing a
> > javadoc for nbjavac could help as Neil comment.
> > For being able to fix javadoc issue in source
> > - I use a jdk 18 to be consitent with the jdk nb-javac use.
> > - I changed the javadoc checker to check all the html file to remove
> > maximum issue
> >
> > And there is a lots of issues 😃
> >
> > fixed the apichanges,arch.xml
> > fixed typos on doc ( like < < ; ) removed links that were using
> > private/protected reference. (we expose only org.netbeans.api.*,
> > org.netbeans.spi.*) using our new netbeans.apache.org url as much as
> > possible. And also coherent url pattern.
> >
> >
> > So 1000 modifications later it compile on master with only a few bad
> > links remaining
> >
> > Here is a list of the faulty links
> >
> > https://cwiki.apache.org/confluence/display/NETBEANS/NetBeans+apidoc
> > +r
> > eferenced+url That the second issue: the missing page from fomer
> > netbeans website and blogs. Web.archive.org get them all.
> >
> > So I need your advise what to do with that.
> > 1) Change the links to web.archiva.org
> > 2) Remove the links
> > 3) Copy from webarchive to our site but I'm unsure of the copyright here.
> > 4) other idea
> >
> > In the case of 3) could we have.
> > netbeans.apache.org/projects/autoupdate,
> > netbeans.apache.org/projects/ui
> >
> > Best regards
> > Eric
> >
> >
> >
> > --------------------------------------------------------------------
> > - To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: dev-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> >
> >
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Bringing apidoc back
Posted by Jean-Marc Borer <jm...@gmail.com>.
Hi Eric,
Thank you for the job.
There is one thing that I am unsure to have properly understood. As a NBP
advanced user, I often refer and use the Javadoc of private and friend
modules.
Will the new site still provide it for the DEV version (currently on
bits.netbeans.org it is broken)?
This is something really important for me.
Best Regards,
JM
On Thu, Sep 8, 2022 at 9:05 AM Eric Barboni <sk...@apache.org> wrote:
> Hi
>
> A PR https://github.com/apache/netbeans/pull/4450 with almost all the
> link break fixes is there.
>
>
> I would like to merge ASAP so we can keep future version as clean as
> possible according to missing link.
> I will have to patch build system / json to have a second jdk for javadoc.
>
> Two PR to have former links via webarchive on our website.
> https://github.com/apache/netbeans-website/pull/608
> https://github.com/apache/netbeans-website/pull/607
>
>
> Best Regards
> Eric
>
> -----Message d'origine-----
> De : Jaroslav Tulach <ja...@gmail.com>
> Envoyé : samedi 13 août 2022 12:57
> À : dev <de...@netbeans.apache.org>
> Objet : Re: Bringing apidoc back
>
> Amazing! Thank you for fixing the broken links.
> -jt
>
>
> Dne po 8. 8. 2022 19:51 uživatel Eric Barboni <sk...@apache.org> napsal:
>
> > Hi folks,
> >
> > I started a PR to clean up the api doc. The main goal is that we need
> > javadoc to success with failonerror set to true. Because if it fails
> > only architecture and api change are generated but not the javadoc.
> >
> >
> > The most important issue is the following :
> > On the master it’s currently not possible to build using jdk 11
> > because java.source.base need a classpath with nbjavac (jdk 18) (they
> > may be other modules involved). I’m not sure if providing a javadoc
> > for nbjavac could help as Neil comment.
> > For being able to fix javadoc issue in source
> > - I use a jdk 18 to be consitent with the jdk nb-javac use.
> > - I changed the javadoc checker to check all the html file to remove
> > maximum issue
> >
> > And there is a lots of issues 😃
> >
> > fixed the apichanges,arch.xml
> > fixed typos on doc ( like < < ; )
> > removed links that were using private/protected reference. (we expose
> > only org.netbeans.api.*, org.netbeans.spi.*) using our new
> > netbeans.apache.org url as much as possible. And also coherent url
> > pattern.
> >
> >
> > So 1000 modifications later it compile on master with only a few bad
> > links remaining
> >
> > Here is a list of the faulty links
> >
> > https://cwiki.apache.org/confluence/display/NETBEANS/NetBeans+apidoc+r
> > eferenced+url That the second issue: the missing page from fomer
> > netbeans website and blogs. Web.archive.org get them all.
> >
> > So I need your advise what to do with that.
> > 1) Change the links to web.archiva.org
> > 2) Remove the links
> > 3) Copy from webarchive to our site but I'm unsure of the copyright here.
> > 4) other idea
> >
> > In the case of 3) could we have.
> > netbeans.apache.org/projects/autoupdate,
> > netbeans.apache.org/projects/ui
> >
> > Best regards
> > Eric
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: dev-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> >
> >
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
>