Debian Bug report logs - #903428
javadocs generated by javahelper include jquery

Package: javahelper; Maintainer for javahelper is Debian Java Maintainers <[email protected]>; Source for javahelper is src:javatools (PTS, buildd, popcon).

Reported by: Thomas Koch <[email protected]>

Date: Mon, 9 Jul 2018 19:51:02 UTC

Severity: important

Tags: newcomer

Full log

🔗 View this message in rfc822 format

X-Loop: [email protected]
Subject: Bug#903428: javadocs generated by javahelper include jquery
Reply-To: Markus Koschany <[email protected]>, [email protected]
Resent-From: Markus Koschany <[email protected]>
Resent-To: [email protected]
Resent-CC: Debian Java Maintainers <[email protected]>
X-Loop: [email protected]
Resent-Date: Mon, 09 Jul 2018 21:33:01 +0000
Resent-Message-ID: <[email protected]>
Resent-Sender: [email protected]
X-Debian-PR-Message: followup 903428
X-Debian-PR-Package: javahelper
X-Debian-PR-Keywords: newcomer
References: <153116570013.52934.7173586082571911770.reportbug@thk1.roam.corp.google.com> <153116570013.52934.7173586082571911770.reportbug@thk1.roam.corp.google.com> <[email protected]> <153116570013.52934.7173586082571911770.reportbug@thk1.roam.corp.google.com> <[email protected]> <[email protected]> <[email protected]> <153116570013.52934.7173586082571911770.reportbug@thk1.roam.corp.google.com>
X-Debian-PR-Source: javatools
Received: via spool by [email protected] id=B903428.15311717995841
          (code B ref 903428); Mon, 09 Jul 2018 21:33:01 +0000
Received: (at 903428) by bugs.debian.org; 9 Jul 2018 21:29:59 +0000
X-Spam-Checker-Version: SpamAssassin 3.4.1-bugs.debian.org_2005_01_02
	(2015-04-28) on buxtehude.debian.org
X-Spam-Level: 
X-Spam-Status: No, score=-21.4 required=4.0 tests=BAYES_00,FROMDEVELOPER,
	HAS_BUG_NUMBER,MURPHY_DRUGS_REL8,PGPSIGNATURE,RCVD_IN_DNSWL_NONE,TXREP
	autolearn=ham autolearn_force=no version=3.4.1-bugs.debian.org_2005_01_02
X-Spam-Bayes: score:0.0000 Tokens: new, 16; hammy, 149; neutral, 52; spammy,
	1. spammytokens:0.950-+--our hammytokens:0.000-+--H*c:pgp-sha512,
	0.000-+--H*F:U*apo, 0.000-+--H*rp:U*apo, 0.000-+--H*c:pgp-signature,
	0.000-+--H*c:protocol
Received: from koschany.net ([176.28.11.243])
	by buxtehude.debian.org with esmtp (Exim 4.89)
	(envelope-from <[email protected]>)
	id 1fcdjL-0001W3-Fk
	for [email protected]; Mon, 09 Jul 2018 21:29:59 +0000
Received: from localhost (localhost [127.0.0.1])
	by koschany.net (Postfix) with ESMTP id A1296225BB;
	Mon,  9 Jul 2018 23:29:58 +0200 (CEST)
Received: from koschany.net ([127.0.0.1])
	by localhost (koschany.net [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id NNI9OAKXhdjX; Mon,  9 Jul 2018 23:29:57 +0200 (CEST)
Received: from [192.168.0.101] (ip-178-203-234-103.hsi10.unitymediagroup.de [178.203.234.103])
	by koschany.net (Postfix) with ESMTPSA id DB56C225A8;
	Mon,  9 Jul 2018 23:29:57 +0200 (CEST)
To: Emmanuel Bourg <[email protected]>
Cc: [email protected], Christoph Berg <[email protected]>,
 Thomas Koch <[email protected]>
From: Markus Koschany <[email protected]>
Organization: debian.org
Message-ID: <[email protected]>
Date: Mon, 9 Jul 2018 23:29:57 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101
 Thunderbird/52.8.0
MIME-Version: 1.0
In-Reply-To: <[email protected]>
Content-Type: multipart/signed; micalg=pgp-sha512;
 protocol="application/pgp-signature";
 boundary="0OTl8hlVvdloqKIrlYbF2ad1YY23i42Y0"

[Message part 1 (text/plain, inline)]
Am 09.07.2018 um 23:26 schrieb Emmanuel Bourg:
> Le 09/07/2018 à 23:14, Markus Koschany a écrit :
> 
>> I believe the use case of viewing javadoc outside of a Debian
>> system is negligible and we should just symlink jquery.
> 
> Viewing an API documentation from a lib*-java-doc package outside of a
> Debian system is indeed a negligible use case. But if the javadoc tool
> was to be patched to link any javadoc generated with the system jquery,
> this would render our openjdk package unfit for many development scenarios.
> 
> If the jquery substitution is implemented directly in the javadoc tool
> it must be limited to documentation aimed at lib*-java-doc packages
> (either with an extra parameter passed by the helpers, or by detecting a
> debian specific environment variable, like DEB_BUILD_ARCH).

We should really aim for the simplest solution. Actually I don't see any
need to patch the javadoc tool because we could easily solve this at the
packaging level. Just replace the embedded jquery library with symlinks
to Debian's system library and let openjdk depend on jquery. Problem solved.

Regards,

Markus


[signature.asc (application/pgp-signature, attachment)]

Send a report that this bug log contains spam.

Debian bug tracking system administrator <[email protected]>. Last modified: Tue May 13 14:20:32 2025; Machine Name: buxtehude

Debian Bug tracking system

Debbugs is free software and licensed under the terms of the GNU General Public License version 2. The current version can be obtained from https://bugs.debian.org/debbugs-source/.

Copyright © 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson, 2005-2017 Don Armstrong, and many other contributors.