[Bug 2097520] Re: when using apt-get installed java, maven goal is behaving differently than when using tar.gz java

[Vladimir Petko]

The patch debian/patches/disable-doclint-by-default.diff was originally
introduced to build Java packages within the Debian archive. By removing
doclintOpts.add(DocLint.XMSGS_OPTION);, the patch prevents javadoc from
failing when encountering unknown tags as it was deemed at the time that
it would be a simpler option than fixing a large number of Java
packages.

For OpenJDK 11, this patch must be retained. OpenJDK 11 remains the
default for Focal (20.04) and Jammy (22.04), where it is still required
to build archive packages for Stable Release Updates (SRU).

It was removed in openjdk-17.

commit 52f32ef15105cc71f44845cebea909e6fc43e765 (tag: 17-9-1)
Author: Matthias Klose <doko at ubuntu.com>
Date:   Thu Feb 11 10:14:32 2021 +0000

      * OpenJDK 17 snapshot, build 9.
      * Enable running the tests.
      * Remove the disable-doclint-by-default patch. Was not applied anymore
        in 17.  Closes: #982521.


** Changed in: openjdk-lts (Ubuntu)
       Status: New => Won't Fix

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to openjdk-lts in Ubuntu.
https://bugs.launchpad.net/bugs/2097520

Title:
  when using apt-get installed java, maven goal is behaving differently
  than when using tar.gz java

Status in openjdk-lts package in Ubuntu:
  Won't Fix

Bug description:
  We are running:
  ```mvn clean install org.apache.maven.plugins:maven-javadoc-plugin:3.5.0:jar -DskipTests=true```
  on a pipeline but also locally on Ubuntu machines. The result is different when on the machine, we have used ```apt-get install openjdk-11-jdk``` for JAVA installation and when downloading jdk 11 tar.gz file and installing it manually. 

  The errors we see are:
  [ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.5.0:jar (default-cli) on project ccmd-codelists-service: MavenReportException: Error while generating Javadoc: 
  [ERROR] Exit code: 1

  For:
  error: unknown tag: @desc
  error: type arguments not allowed here

  We tested with docker maven images and different jdks like:
  3.9.9-eclipse-temurin-11
  3.9.9-ibm-semeru-11-focal
  3.9.9-amazoncorretto-11
  3.9.9-sapmachine-11
  3.8.6-openjdk-11
  3.8.3-jdk-11-openj9
  3.8-openjdk-11
  3.8-jdk-11

  and all fail with the same error.

  If we use Ubuntu machine with ```apt-get install openjdk-11-jdk``` or
  docker with the same command, the maven command is successful.

  ProblemType: Bug
  DistroRelease: Ubuntu 24.04
  Package: openjdk-11-jdk 11.0.26+4-1ubuntu1~24.04
  Uname: Linux 5.15.167.4-microsoft-standard-WSL2 x86_64
  ApportVersion: 2.28.1-0ubuntu3.3
  Architecture: amd64
  CasperMD5CheckResult: unknown
  Date: Thu Feb  6 11:30:24 2025
  ProcEnviron:
   LANG=C.UTF-8
   PATH=(custom, no user)
   SHELL=/bin/bash
   TERM=xterm-256color
   XDG_RUNTIME_DIR=<set>
  SourcePackage: openjdk-lts
  UpgradeStatus: No upgrade log present (probably fresh install)

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/openjdk-lts/+bug/2097520/+subscriptions