Bug#994884: libcairomm-1.0-doc doesn't work in devhelp: dangling refs and bad escaping

[Stefano Marsili]

Package: libcairomm-1.0-doc
Version: 1.12.2-4.1
Severity: normal

Dear Maintainer,

   * What led up to the situation?
     After installing libcairomm-1.0-doc, devhelp search stopped working
     for the std namespace (cppreference package).
   * What exactly did you do (or not do) that was effective (or
     ineffective)?
     I removed dangling references to non existing html files in
     cairomm-1.0.devhelp2 (see patch at the end of this text)
   * What was the outcome of this action?
     I could search cppreference classes but still couldn't search
     libcairomm classes. devhelp couldn't load html pages because
     of doxygen not escaping RefPtr<> to RefPtr<> correctly
     (I guess)
   * What outcome did you expect instead?
     To browse the libcairomm documentation.

I escaped the relevant RefPtr<> to RefPtr\<\> in the offending refptr.h file
but I'm not familiar with autotools and couldn't regenerate the documentation,
which isn't rebuilt when running "debuild -us -uc" anyway

-- System Information:
Debian Release: bookworm/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.10.0-8-amd64 (SMP w/8 CPU threads)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE=en_US:en
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

libcairomm-1.0-doc depends on no packages.

libcairomm-1.0-doc recommends no packages.

Versions of packages libcairomm-1.0-doc suggests:
ii  firefox-esr [www-browser]  78.14.0esr-1
ii  w3m [www-browser]          0.5.3+git20210102-6


Index: cairomm-1.12.2/docs/reference/cairomm-1.0.devhelp2
===================================================================
--- cairomm-1.12.2.orig/docs/reference/cairomm-1.0.devhelp2
+++ cairomm-1.12.2/docs/reference/cairomm-1.0.devhelp2
@@ -104,24 +104,6 @@
       <sub name="__gnu_sequential" link="a01613.html"/>
       <sub name="sigc" link="namespacesigc.html"/>
       <sub name="sigc::internal" link="namespacesigc_1_1internal.html"/>
-      <sub name="std" link="a01616.html"/>
-      <sub name="std::chrono" link="a01623.html"/>
-      <sub name="std::chrono::_V2" link="a00650.html"/>
-      <sub name="std::__debug" link="a01617.html"/>
-      <sub name="std::decimal" link="a01625.html"/>
-      <sub name="std::__detail" link="a01618.html"/>
-      <sub name="std::__exception_ptr" link="a00529.html"/>
-      <sub name="std::__parallel" link="a01620.html"/>
-      <sub name="std::placeholders" link="a01626.html"/>
-      <sub name="std::__profile" link="a01621.html"/>
-      <sub name="std::regex_constants" link="a01627.html"/>
-      <sub name="std::rel_ops" link="a01628.html"/>
-      <sub name="std::this_thread" link="a01629.html"/>
-      <sub name="std::tr1" link="a01630.html"/>
-      <sub name="std::tr1::__detail" link="a01631.html"/>
-      <sub name="std::tr2" link="a01632.html"/>
-      <sub name="std::tr2::__detail" link="a01633.html"/>
-      <sub name="std::_V2" link="a00584.html"/>
     </sub>
     <sub name="Classes" link="classes.html">
       <sub name="abi" link="a01614.html"/>
@@ -180,24 +162,6 @@
       <sub name="RefPtr< Cairo::Device >" link="classCairo_1_1RefPtr.html"/>
       <sub name="sigc" link="namespacesigc.html"/>
       <sub name="sigc::internal" link="namespacesigc_1_1internal.html"/>
-      <sub name="std" link="a01616.html"/>
-      <sub name="std::chrono" link="a01623.html"/>
-      <sub name="std::chrono::_V2" link="a00650.html"/>
-      <sub name="std::__debug" link="a01617.html"/>
-      <sub name="std::decimal" link="a01625.html"/>
-      <sub name="std::__detail" link="a01618.html"/>
-      <sub name="std::__exception_ptr" link="a00529.html"/>
-      <sub name="std::__parallel" link="a01620.html"/>
-      <sub name="std::placeholders" link="a01626.html"/>
-      <sub name="std::__profile" link="a01621.html"/>
-      <sub name="std::regex_constants" link="a01627.html"/>
-      <sub name="std::rel_ops" link="a01628.html"/>
-      <sub name="std::this_thread" link="a01629.html"/>
-      <sub name="std::tr1" link="a01630.html"/>
-      <sub name="std::tr1::__detail" link="a01631.html"/>
-      <sub name="std::tr2" link="a01632.html"/>
-      <sub name="std::tr2::__detail" link="a01633.html"/>
-      <sub name="std::_V2" link="a00584.html"/>
     </sub>
   </chapters>
   <functions>