• Bug#1103982: libglm-doc: API documentation is missing files

    From =?utf-8?q?IOhannes_m_zm=C3=B6lnig_=@21:1/5 to All on Wed Apr 23 15:20:01 2025
    Package: libglm-doc
    Version: 0.9.9.8+ds-9
    Severity: normal

    Dear Maintainer,

    i just installed libglm-doc to read on GLM, but unfortunately the
    doxygen generated page seems to be missing the interesting parts...

    Opening up `/usr/share/doc/libglm-doc/api/index.html` I see (besides
    some JS artifacts about "loading" and "searching"), three relevant
    links:
    - Website: https://glm.g-truc.net/
    - GLM API documentation: file:///usr/share/doc/libglm-doc/api/modules.html
    - GLM Manual: https://github.com/g-truc/glm/blob/master/manual.md

    so two of these links go to the external upstream homepage, which is
    fine, but I want to read the documentation locally.
    the 3rd link points to file:///usr/share/doc/libglm-doc/api/modules.html which... does not exist.


    the nice thing about doxygen generated docs is, that they give you a
    navigable structure.
    this is not the case here, as the entry point to the API documentation does not work.

    there's a total of 738 files in /usr/share/doc/libglm-doc/api/, which
    makes it a bit... hard to find relevant information (if there's no entry
    point)


    thanks for fixing this :-)

    -- System Information:
    Debian Release: trixie/sid
    APT prefers unstable-debug
    APT policy: (500, 'unstable-debug'), (500, 'testing-debug'), (500, 'stable-updates'), (500, 'stable-security'), (500, 'unstable'), (500, 'testing'), (500, 'stable'), (1, 'experimental')
    Architecture: amd64 (x86_64)
    Foreign Architectures: i386

    Kernel: Linux 6.12.21-amd64 (SMP w/24 CPU threads; PREEMPT)
    Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_OOT_MODULE
    Locale: LANG=C.UTF-8, LC_CTYPE=C.UTF-8 (charmap=UTF-8), LANGUAGE not set
    Shell: /bin/sh linked to /usr/bin/dash
    Init: systemd (via /run/systemd/system)
    LSM: AppArmor: enabled

    libglm-doc depends on no packages.

    Versions of packages libglm-doc recommends:
    ii libjs-highlight.js 9.18.5+dfsg1-2
    ii libjs-jquery 3.6.1+dfsg+~3.5.14-1

    libglm-doc suggests no packages.

    -- no debconf information

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)