Groups > comp.lang.java.programmer > #39707

Re: Java 11: Inherit javadoc from base java classes

Path	csiph.com!newsfeed.xs4all.nl!newsfeed8.news.xs4all.nl!news.uzoreto.com!aioe.org!LeVffQP25j5GAigzc2gaQA.user.46.165.242.75.POSTED!not-for-mail
From	Arne Vajhøj <arne@vajhoej.dk>
Newsgroups	comp.lang.java.programmer
Subject	Re: Java 11: Inherit javadoc from base java classes
Date	Sat, 2 Oct 2021 20:22:04 -0400
Organization	Aioe.org NNTP Server
Message-ID	<sjat3f$1gri$1@gioia.aioe.org> (permalink)
References	<sjab9p$f4b$1@dont-email.me>
Mime-Version	1.0
Content-Type	text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding	8bit
Injection-Info	gioia.aioe.org; logging-data="50034"; posting-host="LeVffQP25j5GAigzc2gaQA.user.gioia.aioe.org"; mail-complaints-to="abuse@aioe.org";
User-Agent	Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.14.0
Content-Language	en-US
X-Notice	Filtered by postfilter v. 0.9.2
Xref	csiph.com comp.lang.java.programmer:39707

Show key headers only | View raw

On 10/2/2021 3:18 PM, Stanimir Stamenkov wrote:
> I'm trying to generate javadoc for the given source while inheriting 
> apidoc from the base class/interface which happens to be from the 
> standard Java library.
> 
> I have the following "options" file (I'm on Windows for what is worth):
> 
> net.example
> -d
> doc
> -sourcepath
> src;C:\java\jdk-11\src
> -link
> https://docs.oracle.com/en/java/javase/11/docs/api
> 
> I have extracted the "src.zip" in the "C:\java\jdk-11" installation to a 
> "src" subdirectory just for that purpose.
> 
> I'm executing:
> 
>  > javadoc @options
> 
> but I'm not getting the generated javadoc inheriting apidoc from the jdk 
> sources.
> 
> The same example using Java 8 javadoc, and options:
> 
> net.example
> -d
> doc
> -sourcepath
> src;C:\java\jdk1.8.0\src
> -link
> https://docs.oracle.com/javase/8/docs/api
> 
> works as expected.  What configuration I need to use to make the same 
> working with Java 11's javadoc?

I suspect that you may need to add the module name to the source
path for Java 11:

-sourcepath
src;C:\java\jdk-11\src\java.desktop

Arne

Thread

Java 11: Inherit javadoc from base java classes Stanimir Stamenkov <s7an10@netscape.net> - 2021-10-02 22:18 +0300
  Re: Java 11: Inherit javadoc from base java classes Arne Vajhøj <arne@vajhoej.dk> - 2021-10-02 20:22 -0400
    Re: Java 11: Inherit javadoc from base java classes Stanimir Stamenkov <s7an10@netscape.net> - 2021-10-03 09:41 +0300
      Re: Java 11: Inherit javadoc from base java classes Stanimir Stamenkov <s7an10@netscape.net> - 2021-10-03 13:30 +0300
        Re: Java 11: Inherit javadoc from base java classes Stanimir Stamenkov <s7an10@netscape.net> - 2021-10-03 14:45 +0300
          Re: Java 11: Inherit javadoc from base java classes Stanimir Stamenkov <s7an10@netscape.net> - 2021-10-03 15:54 +0300

csiph-web