maven-javadoc-plugin

maven-javadoc-plugin error javadoc: error - cannot read Input length = 1 with non-ASCII characters in directory name

╄→гoц情女王★ 提交于 2019-12-05 07:16:43
I'm using OpenJDK 11 on Windows 10. I have a very simple POM, for a single Java file, that generates Javadocs. Here is an extract: <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.compiler.source>11</maven.compiler.source> <maven.compiler.target>11</maven.compiler.target> </properties> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>3.0.1</version> <executions> <execution> <goals> <goal>jar</goal> </goals> </execution> </executions> </plugin> </plugins> </build> Strangely just

How do I make javadoc inheritance work for external APIs? (with Maven2)

给你一囗甜甜゛ 提交于 2019-12-05 04:51:06
When a class overrides a concrete method or implements and abstract method, the Javadoc is automatically inherited unless explicitly overwritten. Or, at least the tool tries to do this. It seems it does not work for linked external APIs. For instance, when I in my code implement java.util.Map , or something else from the JRE, the javadocs are not inherited/copied from the JRE javadocs/apidocs. In my specific case, I am trying to configure this in the Maven2 Javadoc plugin, but it is the same when I run the javadoc CLI tool directly. My Maven2 Javadoc plugin configuration currently looks like

Using Eclipse compiler instead of javac results in javadoc crash

只谈情不闲聊 提交于 2019-12-05 00:41:07
Summary: I've run into an interesting problem, and I'm not quite sure how to sleuth it: Our project has been building fine for months I changed the maven-compiler-plugin to use the eclipse compiler instead of javac Now when I run mvn site , maven-javadoc-plugin fails According to the stack trace, it appears the Javadoc tool is crashing on a class file created by the Eclipse compiler Is there any way to fix this? If not, is there at least any way to debug it further? Full details: I'm using Java 1.6.0_27 and Maven 3.0.2. I've been using the javac compiler to build our codebase, but I'm

How to disable Javadoc warnings in Maven Javadoc Plugin?

拜拜、爱过 提交于 2019-12-04 22:37:46
I'm using the Maven Javadoc Plugin. It outputs warnings as follows: [ERROR] /home/monperrus/spoon/src/main/java/spoon/visitor/CtVisitor.java:144: warning: no @param for <T> How to display those warnings as [WARNING] (and not the confusing [ERROR] )? Gray How to display those warnings as [WARNING] (and not the confusing [ERROR])? How to completely disable Javadoc warnings in Maven? If you are talking about the javadoc lint warnings introduced in Java 8 then you should be able to do the following. There are multiple ways of specifying the parameters depending on which version of the javadoc

Maven 3: Generate Javadoc for defined artifacts

China☆狼群 提交于 2019-12-04 13:44:28
问题 I want to generate javadocs only for certain artifacts of my project from within a dedicated docs-project. That means that I would like to have an independent project called "docs" for example. In the docs/pom.xml I would like to define the artifacts that should be included in the generated javadocs. So far I learned that I have to generate a separate sources.jar for the projects I want to include. But I can't figure out how to go on from there. For now I can only imagine two approaches: Get

Maven site (Maven 3) generates empty site folder

徘徊边缘 提交于 2019-12-04 01:44:00
I'm attempting to create a basic maven site using the maven site plugin. So I added this to my pom: <reporting> <plugins> <!--JavaDoc setup--> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.7</version> <configuration> <defaultAuthor>Leon Blakey</defaultAuthor> <defaultVersion>${project.version}</defaultVersion> <links> <link>http://download.oracle.com/javase/6/docs/api</link> </links> </configuration> </plugin> </plugins> </reporting> And ran mvn site --errors [INFO] Error stacktraces are turned on. [INFO] Scanning for projects...

Maven 3: Generate Javadoc for defined artifacts

亡梦爱人 提交于 2019-12-03 08:25:57
I want to generate javadocs only for certain artifacts of my project from within a dedicated docs-project. That means that I would like to have an independent project called "docs" for example. In the docs/pom.xml I would like to define the artifacts that should be included in the generated javadocs. So far I learned that I have to generate a separate sources.jar for the projects I want to include. But I can't figure out how to go on from there. For now I can only imagine two approaches: Get the artifacts (sources.jar) I want to include, unpack them and somehow point the Javadoc plugin to the

Can't link to JDK10 in Javadoc comments

故事扮演 提交于 2019-12-03 04:54:00
问题 After upgrading from Java 9 to 10, links to the JDK no longer work when generating documentation with the Javadoc tool (e.g., for a file importing java.util.Optional , {@link Optional} renders as Optional instead of as Optional; same issue with @see , @param , @return , and anywhere else you normally see Javadoc links). I have a simple modularized project, and I'm using Maven with the Javadoc plugin ( source and target options set to 10 in the configuration section for the compiler plugin).

JDK8 - Error “class file for javax.interceptor.InterceptorBinding not found” when trying to generate javadoc using Maven javadoc plugin

对着背影说爱祢 提交于 2019-12-02 17:14:06
I am using JDK8 (tried it on my Eclipse workspace with Win x64 u25 JDK + on Linux launched by Jenkins - jdk-8u20-linux-x64, same problem for both). I have multi-module Maven project (I am launching Maven goal "javadoc:aggregate" from a main module with packaging type "pom"). Pom build section looks like this: <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin<

Maven, javadoc : No source files for package

十年热恋 提交于 2019-12-02 04:55:45
问题 I'm writing a maven package with directory structure frtex pom.xml frtex/src/main/java/some-files.java frtex/src/main/java/utils/some-other-files.java Making mvn test works fine. My problem is mvn javadoc:javadoc that produces the right documentation for the files contained in frtex/src/main/java but issuing [WARNING] javadoc: warning - No source files for package utils Here is the relevant(?) part of my pom.xml : <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc