I've downloaded the latest version of JNA (this is the first time I've looked at it tbh) and I want to generate the javadoc for it. I'm looking to generate the documentation from folder \domino-jna-master\domino-jna\src\main\java\com\mindoo\domino\jna
which is in a parent folder and using command:
javadoc -sourcepath {parent-folder}\domino-jna-master\domino-jna\src\main\java\com\mindoo\domino\jna -d c:\JNA -subpackages .
to put the generated documentation in to the c:\JNA folder.
It's finding the .java files okay but it's generating errors like:
If I use the -Xdoclint:none
and --ignore-source-errors
options to suppress error generation also does not work with the final error being 'no public or protected classes found to document'.
I've also tried this through eclipse but that's just a wizard for the javadoc command.
This is fairly new to me as I find most documentation online so any help you can give me would be appreciated.
added 2022-12-09
I've tried building it. I've had to change the folder location for the lwpd.domino.napi.jar file was located in the \lib\ext folder on my build from:
mvn install:install-file -Dfile="C:\Program Files (x86)\HCL\Notes\osgi\shared\eclipse\plugins\com.ibm.domino.napi_-version-\lwpd.domino.napi.jar" -DgroupId=com.ibm -DartifactId=napi -Dversion=11.0.0 -Dpackaging=jar
to
mvn install:install-file -Dfile="C:\Program Files\HCL\Notes\jvm\lib\ext\lwpd.domino.napi.jar" -DgroupId=com.ibm -DartifactId=napi -Dversion=12.0.2 -Dpackaging=jar
I'm getting one error when running the following command:
mvn -DJVMPARAMS= -DDOMINOOSGIDIR="C:\Program Files\HCL\Notes\osgi" -DDOMINODIR="C:\Program Files\HCL\Notes" -DNOTESINI="C:\Program Files\HCL\Notes\Notes.ini" clean install -Dmaven.test.skip=true
as follows:
[ERROR] Internal error: java.lang.RuntimeException: Could not resolve project dependencies: Missing:
[ERROR] ----------
[ERROR] 1) com.ibm:domino-api-binaries:jar:11.0.0
[ERROR]
[ERROR] Try downloading the file manually from the project website.
[ERROR]
[ERROR] Then, install it using the command:
[ERROR] mvn install:install-file -DgroupId=com.ibm -DartifactId=domino-api-binaries -Dversion=11.0.0 -Dpackaging=jar -Dfile=/path/to/file
This is how I did it in the end:
Get the javadoc.jar from maven
Rename the file extension from .jar to .zip
Extract the HTML, CSS, etc from the zipped file.