#1123978 doxygen: Please make jquery use optional

Package:
src:doxygen
Source:
src:doxygen
Submitter:
John Paul Adrian Glaubitz
Date:
2026-10-22 00:07:01 UTC
Severity:
normal
Tags:
#1123978#5
Date:
2025-12-25 11:40:17 UTC
From:
To:
Hello,

doxygen currently only builds on a handful of architectures due to its build dependency
on "uglifyjs" which has a transitive runtime dependency on nodejs [1].

Since the doxygen package is widely used by many other packages, it should not limit
it's buildability due to the use of jquery and it's transitive dependency on nodejs.

It seems that doxygen itself builds fine without jquery, so I'm not 100% sure what it's
for.

Can you elaborate on this? If it's necessary, can it be moved to the arch-all package?

Thanks,
Adrian

#1123978#12
Date:
2025-12-26 09:51:18 UTC
From:
To:
Hi Adrian, and thanks for raising this good point!

Indeed doxygen builds fine, and it even apparently runs fine without jQuery.
The problem is that when directed to generate docs in HTML format, the
output uses jQuery. If jQuery is not bundled at package build time, the
resulting HTML docs are broken.

To see a sample HTML output from doxygen, have a look at its own online
docs (these files were produced with doxygen itself):
https://www.doxygen.nl/manual/index.html
.... here JQuery for example makes the left panel list items collapse /
expand.

The JQuery JavaScript library and its ecosystem are obsolete so phasing
it out is a good idea and one that I strongly support. But it is not
something that as a maintainer I can do; the refactor would take
upstream a lot of effort, and that is tracked in the forwarded issue.

If you just want to address the buildability of doxygen and its reverse
build-dependencies on archs such as sparc64 where nodejs is not
available, in the short term I see the following two options:

1. Since the idea is not really to port Debian on sparc64 to build
documentation, and doxygen is used in Debian to build docs, we could on
make doxygen less blocking, by making as many as possible (or at least
the most direly required) of its reverse build-dependencies be able to
build without it in the nodoc build profile. Not sure if this is enough
though.

2. Along the lines of what Helmut Grohne proposed yesterday in the
related thread here: https://bugs.debian.org/736432
"adding a pkg.doxygen.prebuiltjs build profile that would drop the
uglifyjs dependency in favor of using the minified JQuery in the source
tarball without rebuilding it", I can propose a slightly modified
workaround, "adding a pkg.doxygen.nonuglifiedjs build profile that would
drop the uglifyjs dependency in favor of using the non-uglified version
of JQuery". I did a quick proof-of-concept here:
https://salsa.debian.org/debian/doxygen/-/tree/wip/paolog/nonuglifiedjs
I tested the so modified doxygen package and it seems to produce
functioning HTML output. Of course we don't want to do this for all
archs so we still need to create the build profile and enable it on
sparc64, which I am clueless about. Feel free to push commits to that
git branch if you know how to do that!

Hope this helps.

Paolo

#1123978#23
Date:
2026-06-12 18:07:30 UTC
From:
To:
owner 1123978 Paolo Greppi <paolo.greppi@libpf.com>
tag 1123978 pending
thanks

I am working to upload version 1.17, recently released by upstream,
which should close this one.
The WIP will appear here: https://salsa.debian.org/debian/doxygen

Paolo

#1123978#28
Date:
2026-10-08 05:14:47 UTC
From:
To:
Hi,

This should be fixed in Doxygen 1.18.0 [1]. Can you please update the package?

Thanks,
Adrian

#1123978#33
Date:
2026-10-22 00:05:38 UTC
From:
To:
We believe that the bug you reported is fixed in the latest version of
doxygen, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 1123978@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Paolo Greppi <paolo.greppi@libpf.com> (supplier of updated doxygen package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)
Format: 1.8
Date: Wed, 21 Oct 2026 23:09:46 +0200
Source: doxygen
Architecture: source
Version: 1.17.0+ds-1
Distribution: unstable
Urgency: medium
Maintainer: Paolo Greppi <paolo.greppi@libpf.com>
Changed-By: Paolo Greppi <paolo.greppi@libpf.com>
Closes: 736432 1123978 1135301
Changes:
 doxygen (1.17.0+ds-1) unstable; urgency=medium
 .
   * New upstream version. Closes: #1135301, #1123978, #736432.
   * Fix lintian W: superfluous-file-pattern.
   * Update standards version to 4.7.4, dropped Priority from control file.
   * d/watch:
     + set dversionmangle=auto
Checksums-Sha1:
 5c9d127ca620a84f00d96bec98a47fccb3f758c3 2825 doxygen_1.17.0+ds-1.dsc
 9e7f572ff38080627c2bc3aa4ad47aa1326b1e67 4070508 doxygen_1.17.0+ds.orig.tar.xz
 1ef42e3b2111c0296138c3b7cd6d4b6804a4f8cb 21080 doxygen_1.17.0+ds-1.debian.tar.xz
 ef925036a93e8c59a2d69c225235f7b88ec34d5b 12742 doxygen_1.17.0+ds-1_source.buildinfo
Checksums-Sha256:
 03b18d6f4b4707d4d78db1c96539545142b064cf33cb4043ff122846a74496c5 2825 doxygen_1.17.0+ds-1.dsc
 4ce4d76f95b4068ef61dfbfa6dfb909eb651e62a042902c9f90c731bcfe94034 4070508 doxygen_1.17.0+ds.orig.tar.xz
 fe35c5d5099b8cefaf4d59ed4433886abe82b24648f2c7840c20ddf4a432b330 21080 doxygen_1.17.0+ds-1.debian.tar.xz
 bd31e147fa59c0b53efb5fde6fd045eb9da5ac9e6729f38c25689d32a53eef02 12742 doxygen_1.17.0+ds-1_source.buildinfo
Files:
 dc62ff25e08c0bd6b253c504a8db75b3 2825 devel optional doxygen_1.17.0+ds-1.dsc
 f41261b2229dfb67812672bf235a09d8 4070508 devel optional doxygen_1.17.0+ds.orig.tar.xz
 a0e8578d56b629529ac0e70e4e1f989a 21080 devel optional doxygen_1.17.0+ds-1.debian.tar.xz
 20db56e92c3eb382e91ad52e7abb6daf 12742 devel optional doxygen_1.17.0+ds-1_source.buildinfo
-----BEGIN PGP SIGNATURE-----

iQJLBAEBCgA1FiEEyTpTRBhTUv5T0mHqIjkMJVxGBPQFAmrZKroXHHBhb2xvLmdy
ZXBwaUBsaWJwZi5jb20ACgkQIjkMJVxGBPQHDhAA4tPb1EA/GywkAyXQjNLJedSR
d5eETO6zFPEO4C3ZohaJY1SDkh0YCgXCAIuxWLIA9tj+0IkAwInmXgIOearB/18v
n66aKCLL3Nz4vGG7Z1pj9rnHz4Gi/Rr6aDeCm75K7CipYDoAtgDzPFAyD/n6gGoT
yT6gj2SfNIMNZ69Hr3OZNFY2yMO4aULna9mIhyJCaTvgGa+oURnNiEzvFSK/jO7w
xd3FepkoUWlvg0CzXPpjU2esd5cjdGPcige9A0M6riI7jkv8hjxPtSpo/OqXs+Nb
EBUKbR6z8SsWUbwVYuVBAaV9HWJKmmkU015AwI6r5GCBU7pZLMSDk9IfXzK1x9kt
Qgc+wvEPObKHegYPnqOfzzluBFMIRURbiIFYzJURwrkWfZK/KCSJL+hkEduWDgok
iWhu7UVpU2VSGi5GNaufg35Aye9aGWMq8Ufpryn+GI0K7smx9u/ZIU6bl4agzHV8
5BDn+hH2eVS22gS/3JZD7E01XQsd98Ir84HXjbDkKg+ISaFU+2kPYsQGt9dVZIoy
vc8ZSot5ughZazV74gbvin7/nrev4U2haXPxwQUqxfAUQinMan+yE5zhpfRYbwyp
NXhdCpj12Is5rn4QHpjV6yWB2kDXXWieKjmPsveGdVFk+PbWFb8S9afVGcEffDRk
eJPX0x8wHJ2rHHmadKw=
=MTOy
-----END PGP SIGNATURE-----