Questions tagged [javadoc]

Javadoc is an extensible documentation generation system which reads specially formatted comments in Java source code and generates compiled documentation. It is typically used to produce API documentation in the form of HTML web pages.

Filter by
Sorted by
Tagged with
0 votes
2 answers
66 views

Javadoc API as part of larger documentation

One of the nice things about sphinx and python is the relatively simple coupling between API documentation and explanatory documentation in markdown using chapters and sections that give the ...
Eli S's user avatar
  • 1,411
0 votes
1 answer
21 views

Can't build javadoc anymore after upgrading from JDK 1.6, "path may not be null or empty string"

I used to use the following Gradle task in build.gradle to build Javadocs for my Android app: task javadoc(type: Javadoc) { title = "My Docs v${android.defaultConfig.versionName}" ...
slhck's user avatar
  • 37k
0 votes
1 answer
23 views

What HTML attributes are allowed in Javadoc?

I tried to use the lang attribute on an element in a documentation comment. Doclint (as part of the javadoc command) rejects that. I know I could suppress HTML errors in general, but I want to be told ...
Bolpat's user avatar
  • 1,462
0 votes
0 answers
47 views

After changing the patrykandpatrick/vico library version to 1.13.0 the application compiling FAILED

For my application I am using a chart library patrykandpatrick/vico. Version 1.12.0 works great. But when I upgrade the version to 1.13.0, an error occurs during compilation: > Task :app:...
Андрей Ананьев's user avatar
0 votes
0 answers
16 views

How to understand notation in the Java docs?

Given, I know that <T> or <T, V extends Number> is the formal type parameter section. This is a declaration of the formal type parameter T ( type variables ). A type variable is an ...
Squared's user avatar
  • 71
1 vote
1 answer
39 views

SpringDoc / OpenAPI: How do deal with JavaDoc vs. @Schema?

I'm working on a Spring Boot project which uses SpringDoc to generate an OpenAPI schema. I'm struggling with the documentation because on the one hand this: /** Description of the class */ public ...
Martin Häusler's user avatar
2 votes
0 answers
72 views

Suppressing Javadoc 21 DocLint warnings specifically for "no main description"

I just upgraded my build from Java 17 to Java 21. In Maven I have Javadoc set to DocLint everything using the Maven Compiler Plugin -Xlint:all compiler option. As is typical with Java classes, I have ...
Garret Wilson's user avatar
1 vote
0 answers
28 views

With the new Javadoc API, is it possible to update the javadoc comment by a custom doclet?

In the new Javadoc api jdk.javadoc.doclet.*, I cannot find a way to change the Javadoc comment. I want to change only few things in the comment and parameter method through a custom doclet. I do not ...
RTAGLIA's user avatar
  • 11
0 votes
0 answers
32 views

What is a JavaDoc component for Anylogic?

I am trying to export my component in Anylogic and I need to export also a help file for it. Anylogic automatically creates a jar component but it doesn't create a Help for it. When I look at the ...
Юрий Литвин's user avatar
0 votes
1 answer
52 views

Android custom Javadoc task throws "Path may not be null or empty string"

When running my Javadoc task (see config below), an error is thrown with this message: Cause: path may not be null or empty string. path = ''. This error only started occuring after I updated the ...
es97's user avatar
  • 73
0 votes
0 answers
21 views

Maven site include generated code folder for javadoc

In our project, we are generating some Java classes into target\generated folder. Those classes have javadoc. When I run mvn site there are no apidocs generated (as expected) from these **/target/...
Dmitry Aleksandrov's user avatar
0 votes
2 answers
70 views

How should the JavaDoc for Class and Main method differ?

Simple example: Suppose I have a class that contains a minValue method, a maxValue method, and an averageValue method which each take a double array, and also the Main method. Suppose also in the main ...
Gabi23's user avatar
  • 115
0 votes
0 answers
21 views

javadoc.exe fails with "error: cannot find symbol NonNull" even though it finds and reads androidAnnotations.jar

I've read a zillion threads on that topic, but still can't find a solution. I'm trying to generate documentation using javadoc.exe on Windows from a bunch of .java files that use the @NonNull ...
sba923's user avatar
  • 545
0 votes
0 answers
25 views

Maven JavaDoc plugin won't include the JavaDocs from an external local dependency on its final JavaDocs

I have a Maven project (let's call it A) that generates JavaDocs to itself through the JavaDoc plugin. I would like to also include the full JavaDocs of an external project (let's call it B), which I'...
CristalDurman's user avatar
1 vote
1 answer
51 views

Suppress Javadoc Warnings in Android project with Gradle

I got some troubles with javadoc warnings. When I push my commits and create a pull request in my GitHub repository a Lint Code Base test runs and then shows in the console that a lot of methods and ...
Alfito69420's user avatar
0 votes
2 answers
53 views

What regex would I use to add javadocs to a java program in vscode?

My current attempt: Find: (^$\n[\s]*.*\{|^$\n[\s]*.*@.*$) Replace: /***/$1 Problem: works well except for the fact that the javadoc boilerplate is not indented. What change would I implement to indent ...
kesarling He-Him's user avatar
0 votes
1 answer
37 views

Font tag not supported in javadoc

Im using Java 16 and build my project with gradle. I want to use gradle javadoc to generate a javadoc from my comments. But when i executed the command, I got following error: error: tag not ...
Zonko's user avatar
  • 133
0 votes
0 answers
41 views

How to generate changes between two javadoc versions

I have java source code for which generated a javadocs using below javadoc -d old_javadoc -sourcepath /path/to/old_source_folder -subpackages my.package.name Then made some changes to code, like: ...
Bharath's user avatar
  • 81
1 vote
1 answer
175 views

Eclipse 2023-09 crashes whenever Javadocs begin loading

Eclipse is instant-crashing with no errors, no warnings whenever Javadocs are loaded. This happens during: content-assist with CTRL+SPACE (the content-assist part is working fine, however, when ...
JonathanDavidArndt's user avatar
-1 votes
1 answer
42 views

When trying to generate a Javadoc for my program I get the error message 'use of default constructor, which does not provide a comment' What is wrong?

The issue seems to be with the tester class, though I don't understand what exactly the issue is or what to change. It doesn't interfere with how the program runs or functions, but i need the Javadoc ...
Milo Vibes's user avatar
0 votes
0 answers
26 views

Can an IntelliJ plugin fold one-line javadoc comments?

I am writing an IntelliJ Plugin to help with coding standards and conventions at my company. We have some requirements concerning where Javadoc should be used, and I'm creating code inspections and ...
Nic Estrada's user avatar
0 votes
0 answers
27 views

Maven-javadoc-plugin ClassNotFound while trying to register Taglet

In a multi-module maven project, I have the javadoc configuration set up in the parent pom.xml, including pointing to the jarfile for my taglet. This is working fine in one of the sub-modules, but not ...
keshlam's user avatar
  • 7,981
0 votes
0 answers
25 views

Suppress specific kind of warning in Javadoc with Gradle

I am using Gradle 8.1.1 to generate Javadocs. We know that passing -Xdoclint:none to the task can completely suppress warnings, but I just want to ignore a few rules (e.g. no @param for <T>). ...
Plus's user avatar
  • 85
1 vote
1 answer
48 views

Maven command mvn javadoc:jar downloads log4j-1.2.12

When executing the Maven command mvn javadoc:jar, it downloads log4j-1.2.12.jar, which contains vulnerabilities. The projects in scope do not have any dependency on log4j, nor do we have a plugin to ...
user1610446's user avatar
0 votes
1 answer
73 views

javadoc fails in presence of imports in module-info.java

I am sometimes generating my own javadoc of OpenJDK modules to adjust the javadoc command with my favorite options. Recently I tried to do this for OpenJDK 20 but got strange module-not-found-errors ...
stewori's user avatar
  • 586
-1 votes
1 answer
56 views

How to make JavaDoc work with line comments?

Can JavaDoc be configured so that it works on /// … comments instead of /** … */? I really don’t like block comments (especially non-nesting ones) and I’d rather jump through 100 hoops and hurdles ...
Bolpat's user avatar
  • 1,462
0 votes
0 answers
43 views

How to see the Javadoc after generating it in NetBeans

I am able to generate the Javadoc on NetBeans by right clicking my project ad putting generate javadoc. This gives me a BUILD SUCCESS in the output. However, I can't see the html file. All the answers ...
helpme82628's user avatar
0 votes
0 answers
13 views

Will hover suggestions for java (any IDE) work if source code is not there but JavaDocs are shipped with the JAR?

Will hover suggestions for java (any IDE) work if source code is not there but JavaDocs are shipped with the JAR? I tried few things on VsCode: Code refering to class from JAR with "source code&...
jaimal singh's user avatar
1 vote
1 answer
33 views

JavaDoc for AbstractQueuedSynchronizer is unclear

Two sentences in the JavaDoc for AbstractQueuedSynchronizer are in my opinion unclear/misleading, and therefore I would like to clarify such issues. The first sentence states: Even though this class ...
Ciaccia's user avatar
  • 392
0 votes
1 answer
31 views

Subclasses are not visible in javadocs

I try to make javadocs for an abstract class that extends another class.but in the javadoc tree, the subclass is not visible.I used intellij-idea for done this and I got generate javadoc using src&...
yukthi's user avatar
  • 21
1 vote
0 answers
23 views

Looking for a way to shade and relocate javadocs in my api module using maven (preferably)

I have a minigame that depends on a minigame engine, I am relocating the minigame engine in a sub package of the minigame called engine and also relocating the API part of the engine inside the ...
Fr33styler's user avatar
0 votes
0 answers
47 views

Is it possible to find the imported classes with the current JavaDoc APIs?

I've been working on a custom Javadoc doclet using the current doclet APIs. Having encountered a ReferenceTree for a link, let's say jdk.javadoc.doclet.Doclet#init(Locale, Reporter), I need to work ...
Norm's user avatar
  • 896
0 votes
1 answer
52 views

Is there a way in Java or IntelliJ 2022.2 to suppress MissingJavadoc warnings with an annotation?

I know it's possible to purposefully suppress unused method warnings in Java/IntelliJ 2022.2 by creating a custom annotation, then using the context menu to suppress the unused warning if annotated ...
jsrc..programmer's user avatar
0 votes
1 answer
50 views

Apache poi, Docx file XWPFRun, XWPFParagraph

If anyone has a similar example or if someone can do it, please help me write it I couldn't place the two images on the right and left sides of the word file. The word file was created. but I could ...
Azizjon Malikov's user avatar
0 votes
0 answers
98 views

Why can't Gradle find the javadoc executable?

I am attempting to build this project: https://github.com/opensearch-project/opensearch-hadoop#writing-2 Here is the Gradle configuration: =========================================== OpenSearch-...
vp158's user avatar
  • 1
0 votes
1 answer
32 views

IntelliJ Javadoc -link option grayed out

Based on the accepted answer here, in order to make Javadocs that don't include fully qualified @links, like this: then one needs to add the -link option to the call to the javadoc executable. In my ...
Jason's user avatar
  • 2,678
-4 votes
2 answers
101 views

What does Matcher.find() really do? [duplicate]

The JavaDoc for java.util.regex.Matcher.find() says: Attempts to find the next subsequence of the input sequence that matches the pattern. This method starts at the beginning of this matcher's region,...
Todd O'Bryan's user avatar
  • 2,232
0 votes
1 answer
177 views

Javadocs on push with Gitlab Pages with Maven Pipeline in jdk22

I have a Maven project running on jdk22 for which I try to generate JavaDocs on Gitlab with CI/CD. This is my .gitlab-ci.yml image: maven:latest pages: stage: deploy script: - mvn javadoc:...
xtay2's user avatar
  • 447
0 votes
1 answer
174 views

Oracle JDBC Driver 11 Javadoc or Source JAR

I have downloaded the latest version of JAR files for Oracle JDBC, including the source files and javadoc files. The Maven repository is here: https://repo1.maven.org/maven2/com/oracle/database/jdbc/...
Alan Garnium's user avatar
0 votes
0 answers
93 views

Azure Logic App Workflow Definition Language to document (markdown) like javadoc

It seems everything‘s already in place. Any logic app has a json code following the Azure Worfklow Definition Language schema (https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/logic-apps/...
FrankM-DE's user avatar
2 votes
1 answer
39 views

@value tag reference to another class

I am generating some javadoc comments for a few utility methods that I created. How can I use the @value tag to reference the actual value of a constant that is defined in another class? For example: ...
user1154644's user avatar
  • 4,521
1 vote
1 answer
47 views

How to merge method and description columns

I'm new to javadoc. I've tried to generate javadoc with Maven plugin. It works well, however, it generates 2 columns Method and Description instead 1 column Method and Description. I can't find option ...
Ngu Duong's user avatar
1 vote
2 answers
94 views

JavaDoc for Method with Multiple Signatures

Suppose I have a method with multiple signatures (just a silly example). The method with all parameters is the actuall workhorse and all other methods are convenience shortcuts. I have documented the ...
petermeissner's user avatar
7 votes
2 answers
265 views

Avoiding Javadoc duplication in Java records

The new Java record is supposed to cut down on boilerplate. I can quickly create an immutable FooBar class with foo and bar components without worrying about local variables, constructor value copying,...
Garret Wilson's user avatar
0 votes
0 answers
111 views

How to generate javadoc for multi flavor android project in Azure DevOps pipelines?

Android App Generate JavaDocs with Gradle 7.4 using Azure DevOps task Hello all, I'm trying to implement a task in Azure DevOps to generate a JavaDoc with the task as below: - task: Gradle@2 ...
Ravichandra V's user avatar
0 votes
0 answers
16 views

How has the conceptual diagram in javadoc changed from Java 8 to Java 20?

Noticed the Java Conceptual Diagram is not available for later/latest version than Java 8. Any changes in Java Docs ? Explored latest version of Java 20 - Docs. Need to know what all differences in ...
user983549's user avatar
2 votes
2 answers
253 views

How to add a Javadoc JAR file to a Maven project in IntelliJ IDEA?

I am making a local Java utility library and building it into a JAR file. I am also building a JAR file for the Javadocs. These are the JAR files generated by Maven: Now, I am trying to use the ...
Francis Rubio's user avatar
2 votes
1 answer
150 views

How to distribute javadoc along with my jar library artifact using maven repository?

I have a Kotlin JVM library, which I distribute using as a .jar artifact via maven repository. I would like to provide some Kdocs for it, so that it can be used via IntelliJ Idea's quick docs tool (...
David Zhubrev's user avatar
-1 votes
1 answer
219 views

Javadoc not found - jakarta.servlet (Tomcat 10.0.23, Apache Netbeans 13, JDK 1.8.0_321)

By default, Netbeans 13 template using javax, which is not included in Jarkata EE platform equipped by Tomcat 10. So I replace all javax by Jakarta package. But I can't see or perform show javadoc. ...
DuyDuc's user avatar
  • 1
0 votes
1 answer
97 views

maven-site-plugin to skip Generating "Test Javadoc" report --- maven-javadoc-plugin

What I am trying to achieve: Generate project website from maven site plugin, without the javadoc for tests (but with javadoc for the classes) What did I try: <build> <plugins> ...
PatPanda's user avatar
  • 3,894

1
2 3 4 5
60