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.
2,857
questions
0
votes
1
answer
26
views
Insert the javaDoc parameters and print them
I have a problem that is probably simple, but if I'm starting to program in java language, I'm having great difficulty in this part.
In the java document (JavaDoc) I want to pass the 2 parameters (@...
0
votes
1
answer
17
views
_private directory doesn't get included in GitHub pages build for javadoc
The directory _private and its contents don't get included in the GitHub pages build.
The java doc for the project has a _private directory, whose content don't end up in the GitHub pages build.
When ...
0
votes
0
answers
7
views
Cant run JavaDoc in Android Studio
When I try to run JavaDoc in android studio I am getting several similar errors. 18 in total. One of these I have pasted below. Can someone please help me fix this?
3: error: package android does not ...
1
vote
0
answers
24
views
JavaDoc: specify compatibility up to a specific version?
Similarly to how I can specify the minimum compatible Java version using the @since tag, I'd like to specify in my JavaDoc the maximum compatible version (e.i. indicate that my class is only ...
0
votes
2
answers
24
views
Intellij: Javadoc I can't see description of the methods, class in java documentation after ctrl+b
I can't see description of the methods, class in java documentation after clicking ctrl+b in Intellij. How can I turn it on or should i update my doc?
Screenshots:
Without description
I would like to ...
0
votes
0
answers
17
views
Keycloak Java API: managing client resources
I can’t figure out how to retrieve the resources under the "Authorization” section within the oidc confidential clients.
I need them because I have to delete them and insert them from the code, ...
0
votes
0
answers
7
views
viewing Javadoc.jar as a site in Nexus3
Is there a way to view a -javadoc.jar deployed artifact using Nexus3?
I can successfully generate and upload the .jar file to nexus using maven, but I cannot find a good way for Nexus to "host&...
1
vote
2
answers
71
views
Can I javadoc a whole Java project from the command line without explicitly naming packages?
I have a java codebase with many packages which I'm not that familiar with.
I just want to get an overview by javadoc-ing the while thing. Without having to specify the names of which packages I want ...
0
votes
0
answers
19
views
Maven javadoc plugin doesn't generate files for whole project
Here my pom.xml:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-...
0
votes
1
answer
18
views
How to document runtime of a function with Javadoc
I'm want to document the asymptotic runtime of a function, as it will be used for algorithm-engineering for graph problems.
What's the most idiomatic way to do this? Is there a way to create new tags ...
0
votes
0
answers
29
views
Android AAR depending on AAR fails with javadoc generation
I have an android gradle project structure that looks like this
module1-aar
module2-aar
testapp-apk
Key facts
module2-aar depends on module1-aar
testapp-apk depends on module2-aar
JDK11
Gradle 7.4....
0
votes
1
answer
21
views
How to get process endpoints from CampaignResponse in AWS Pinpoint API
Here from the below screen, after creating a campaign in AWS Pinpoint, we get the Endpoints Targeted and Endpoints Delivered. I am similarly creating the campaign though the Pinpoint API but I am not ...
0
votes
1
answer
28
views
maven-javadoc-plugin generates warning about generating every file. Why/what is it?
Having default maven-javadoc-plugin configuration:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<...
0
votes
0
answers
28
views
javadoc generation command variable substitution
I am trying to generate javadoc in a bash script
COPYRIGHT='xxxx © 2021, 2022, XXXXXX'
DOC_DIR='docs'
javadoc --frames --no-module-directories -sourcepath ./ -d ./${DOC_DIR} -bottom ${COPYRIGHT} -...
0
votes
1
answer
104
views
How to JavaDoc a record without warnings from -Xdoclint?
I have been trying to familiarize myself with records, but I ran into something that really looks like a bug in Java's tool for linting JavaDoc -Xdoclint.
I tried to use this command...
javac -...
1
vote
1
answer
107
views
Android Studio fails to generate Javadocs due to packages not existing
When I try to generate Javadocs for my projects using the Android Studio tool I get a series of errors that say a bunch of packages I am using do not exist.
C:\Users\Jadon\AndroidStudioProjects\...
0
votes
0
answers
14
views
Can I refer to a field's javadoc in a parameter documentation?
When I write a class like that small demo:
/**
* A decorative item on the shelf.
*/
public static class ItemOnShelf {
/**
* The name of the item in the language of its owner.
*/
...
0
votes
0
answers
28
views
JavaDocs for SpringBoot REST API or other known Architectures/Frameworks? Necessary?
After creating a SpringBootApp to supply REST Services, all according to official Spring Documentation but adding a Service Layer (who knows why Spring Docs ignores this), I've consider creating ...
0
votes
0
answers
12
views
Configure Tycho Document Bundle in Pomless
The Tycho Document Bundle Plugin creates the javadoc documentation by calling the javadoc application from the command line. In addition it creates a ready to include toc-xml file for the Eclipse Help ...
0
votes
0
answers
20
views
Configuring Javadoc with SBT (-overview tag unrecognized)
Trying to manage a Java project with SBT. The SBT documentation says to set javadoc options like this:
Compile / doc / javacOptions ++= Seq("-notimestamp", "-linksource")
The ...
1
vote
3
answers
59
views
Attach external javadoc to vscode
Is there a way to attach an external javadoc in vscode using a link to it? For example, intellij idea allows you to do this.
1
vote
0
answers
25
views
Javadocs on android studio cant resolve packages used by android source
I want to generate a technical documentation using java docs but there seems to be a problem. Although the classpaths are already referenced correctly
-classpath
"C:/Users/ASTI/AppData/Local/...
0
votes
0
answers
34
views
Javadoc with shadow jar
I'm trying to create a Javadoc task in Gradle 7.2/android Gradle plugin 7.1.2 to document android libraries. One of the libraries creates a shadow jar at build time. The problem I'm having is defining ...
0
votes
0
answers
46
views
javadoc with android studio bumblebe patch 2
i try for 2 days to generate a documentation on android studio Bumblebee, i have try multiples possibility, generate documentation with -sourcepath /path/android.jar, command line in shell javadoc ...
0
votes
1
answer
24
views
What determines a minor/major version in a javadoc? [duplicate]
I'm having some doubts regarding my code version.
/**
* Classe que contém um único teste que executa na mesma incidência quanto o número de parâmetros definidos. <u>Teste parametrizado</u>
...
0
votes
2
answers
88
views
Javadoc not showing on hover in VSCode
I'm currently working on a java project using VSCode and when I hover an object, type or method name, documentation isn't showing anymore. I do not know why or what I did to change that.
In the ...
1
vote
0
answers
51
views
Gradle withSourcesJar as library not working
I have a current Gradle, Java 11, project that I intent to use as a library with a set of general purpose functions for another apps.
I'm using the Gradle function:
java{
withSourcesJar()
}
To ...
0
votes
0
answers
54
views
IntelliJ giving "Identifier Expected:" error in javadoc despite turning off inspections for that
Intellij is giving me a bunch of squiggly red lines:
All of these lines are in javadoc, for situations like the following:
/**
* field representing column xyz from table some_table_name in the ...
0
votes
1
answer
34
views
Create a single jar containing dependencies and Javadoc with Maven
I'm trying to create a jar file with both Javadoc and dependencies that I can use in another project.
I can use mvn package with the following pom.xml plugins:
<plugins>
<...
4
votes
1
answer
1k
views
GitHub Actions: Required property is missing: shell
Introduction
I am currently to crate a composite GitHub Actions that build a JavaDoc from Java project and publish it automatically to a static page with GitHub Page.
Problematic
But I got this error ...
-1
votes
1
answer
72
views
<pre> tag doesn't work anymore in VSCode with JDK 17
Up until recently, I always used the <pre> tag in javadoc to format code and it always worked, but since I switched to JDK 17 a few days ago, anything inside <pre> tags seems to be ignored ...
2
votes
0
answers
47
views
Convert Maven javadoc command to Gradle javadoc command
Introduction
I am currently work on a GitHub action that generate a JavaDoc and publish-it to GitHub, without need to configure JavaDoc insade the project.
Affected code:
mvn org.apache.maven.plugins:...
2
votes
1
answer
170
views
Publish automatically JavaDoc: with GitHub Actions
Introduction
I am currently working on a Java Maven project in GitHub, and I'm building a JavaDoc and posting it to a GitHub page.
Question
And I was wondering if it would be possible to automate this ...
1
vote
0
answers
40
views
maven-javadoc-plugin not showing private methods
I have a multi-module maven project and I am wanting to aggregate a javadoc that combines all the methods (public and private) into a whole javadoc. It seems simple, I am following the instructions ...
0
votes
0
answers
117
views
How to exclude a particular class in javadoc with (Kdoc Dokka tool)
In the regular Javadoc generation process, we can simply exclude a class or package by adding the below lines.
exclude '**/SampleClass.java'
exclude '**/com/example/java**'
Question: How to exclude/...
1
vote
1
answer
592
views
Android - failed to generate Javadoc with Android Studio Bumblebee
I'm trying to generate Javadoc using latest Android Studio via built in tool:
Tools=>Generate Javadoc...
Whatever I choose from a tool's parameters window there are a lot of errors thrown, ...
1
vote
0
answers
78
views
Javadoc failOnError not working with Java 11
I’m working in an Android library where its Javadoc documentation is part of its requirement. In this Javadoc I don’t want to show all classes since most of them are obfuscated and for that reason I ...
2
votes
1
answer
373
views
Javadoc warning: no @param for type when using Lombok @Builder
when generating javadoc from sources (delomboked) I receive following warnings for the builder classes generated by the Lombok's @Builder
[ERROR] Error while creating javadoc report:
Exit code: 1 - /...
0
votes
0
answers
12
views
Javadoc for fields of composite data type
I have a class which is being used for a composite data type with 4 fields in it, named "angle", 'x', 'y', 'z'. I have written a javadoc description for the class however, I am unsure how to ...
0
votes
0
answers
33
views
How should I document a bean that's only supposed to be managed by CDI?
Here is my class:
@Stateless
@Transactional
public class PostService {
@Inject private PostRepository postRepo;
@Inject private UserRepository userRepo;
@Inject private SectionRepository ...
1
vote
1
answer
55
views
Javadoc not rendering custom tag in intellij
I have a custom Javadoc tag @date in my code, and I can see it in the regular view like this:
/**
* @author kira
* @date 2022/1/19
*/
but after I render Javadocs, it becomes like this:
Author: ...
0
votes
0
answers
35
views
How to stop javadoc output going to standard error instead of stdout?; Eclipse 4.22 / 2021-12
Removed as much of pre-existing Eclipse stuff as I could (for example moving .metadata aside) and did a clean install of Eclipse Version: 2021-12 (4.22.0) Build id: 20211202-1639.
Now the Generate ...
0
votes
0
answers
98
views
Eclipse doesn't open JavaDoc in the browser
In Eclipse 2021-12 (4.22.0), I have a maven project that uses assertJ, among others. When the mouse hovers over a method or a class from this library, Eclipse shows the appropriate Javadoc in the ...
0
votes
0
answers
52
views
Javadocs are not included in the SDK
I'm developing a SDK for Android platform, using Android Studio Arctic Fox. There is some JavaDocs included in the code, for each method, class, etc.
The problem is after building the project (using ...
0
votes
0
answers
88
views
Android Studio error in generating Javadoc finish with exit code 1
When generating javadoc documentation in android studio, it shows error.
It dont even recognizing android library functions.
error: cannot find symbol
EditText uEdtName, uEdtDescription, ...
0
votes
0
answers
37
views
How to generate javadocs via Android Studio headlessly?
I need to run the Javadoc generation tool provided by Android Studio headlessly in a GitHub Actions runner (I can't do this using Java's javadoc tool or with Gradle). Currently on my machine, I can ...
0
votes
1
answer
28
views
Controlling Package Level Javadoc Generation
When Javadoc processed a package-info.java file in Java 8, the output placed the Javadoc comments (except for the summary sentence) after the generated class and other summary tables. Here is a Java ...
0
votes
0
answers
128
views
Generated javadoc for Android project is empty
Generating the javadoc worked perfectly fine with Java 8 but does not work with the newly bundled Java 11 in Android Studio.
I get errors like error: package ... does not exist or error: cannot find ...
1
vote
0
answers
29
views
Including source files / javadoc comments in compiled JAR file using Bash scripting
Here is my current bash script that lets you compile java sources to class files in the bin directory and then to copy it to a dedicated directory so imports won't be import bin.library.Class but just ...
-1
votes
1
answer
35
views
IntelliJ validation support for javadocs
Eclipse offers the ability to customize it in order to show missing and malformed javadocs comments and tags besides other related javadoc problems as well as the visibility of each class aspect to be ...