Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


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

Re: Java 11: Inherit javadoc from base java classes

From Stanimir Stamenkov <s7an10@netscape.net>
Newsgroups comp.lang.java.programmer
Subject Re: Java 11: Inherit javadoc from base java classes
Date 2021-10-03 14:45 +0300
Organization A noiseless patient Spider
Message-ID <sjc55e$df3$1@dont-email.me> (permalink)
References <sjab9p$f4b$1@dont-email.me> <sjat3f$1gri$1@gioia.aioe.org> <sjbjb0$pc3$1@dont-email.me> <sjc0p0$fcq$1@dont-email.me>

Show all headers | View raw


Sun, 3 Oct 2021 13:30:55 +0300, /Stanimir Stamenkov/:

>    src-modules/
>      net.nexample/
>        module-info.java
>        net/example/
>          FooOp.java
> 
> then having javadoc @options:
> 
> --module
> net.example
> -d
> doc
> --module-source-path
> src-module;C:\java\jdk-11\src
   ^
src-modules (same outcome, anyway)

> -link
> https://docs.oracle.com/en/java/javase/11/docs/api
> 
> but I'm getting lots of errors related to java.base classes:
> 
> Constructing Javadoc information...
> C:\java\jdk-11\src\java.base\jdk\internal\access\SharedSecrets.java:28: 
> error: package javax.crypto does not exist
> import javax.crypto.SealedObject;
>                     ^
> C:\java\jdk-11\src\java.base\jdk\internal\access\JavaxCryptoSealedObjectAccess.java:27: 
> error: package javax.crypto does not exist
> import javax.crypto.BadPaddingException;
>                     ^
> ...
> 
> and finally no doc produced.
> 
> Has anyone successfully generated javadoc with inherited doc from base 
> Java 11 classes?

O.k.  I've been able to generate the desired result by linking 
C:\java\jdk-11\src\java.desktop as src-modules\java.desktop, and javadoc 
options:

--module
net.example
-d
doc
--module-source-path
src-modules
-link
https://docs.oracle.com/en/java/javase/11/docs/api

It would be nice if one could just use the complete jdk sources.

Now I'm wondering if I could achieve similar result but for unnamed 
module sources (without associating them to another module).

-- 
Stanimir

Back to comp.lang.java.programmer | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread


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