Public bug reported:

clang-doc is a tool in clang-tools-extra that requires asset files like
HTML templates to generate documentation. They should be located in
share/clang-doc but they aren't packaged there.

The directory is also missing in Debian and has been reported:
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1128986

> lsb_release -rd
Description:    Ubuntu 25.10
Release:        25.10

> apt-cache policy clang-tools
clang-tools:
  Installed: 1:20.0-63ubuntu1
  Candidate: 1:20.0-63ubuntu1
  Version table:
 *** 1:20.0-63ubuntu1 500
        500 http://archive.ubuntu.com/ubuntu questing/universe amd64 Packages
        100 /var/lib/dpkg/status

Expected: clang-doc generates HTML documentation on invocation.

❯ ~/code/llvm-project/build/bin/clang-doc --format=html --executor=standalone 
main.cpp 
Emiting docs in html format.
Mapping decls...
Collecting infos...
Reducing 1 infos...
Generating docs...
Generating assets for docs...

Actual:
$ /bin/clang-doc-20 --format=html --executor=standalone main.cpp 
Error while trying to load a compilation database:
Could not auto-detect compilation database for file "main.cpp"
No compilation database found in /home/ubuntu or any parent directory
fixed-compilation-database: Error while opening fixed database: No such file or 
directory
json-compilation-database: Error while opening JSON database: No such file or 
directory
Running without flags.
Emiting docs in html format.
default index.js file missing at 
/usr/lib/llvm-20/bin/../share/clang-doc/index.js

Note that the errors for the compilation data are irrelevant. It is the
missing file error that is the problem.

** Affects: llvm-defaults (Ubuntu)
     Importance: Undecided
         Status: New

** Attachment added: "screenshot of failed clang-doc invocation"
   
https://bugs.launchpad.net/bugs/2143595/+attachment/5950537/+files/Screenshot%20From%202026-03-06%2015-11-50.png

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

Title:
  The assets for clang-doc are not packaged from share/clang-doc

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/llvm-defaults/+bug/2143595/+subscriptions


-- 
ubuntu-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to