#922707 qtbase5-doc-html: please consider packaging doxygen .tags files with -dev package, not -doc

Package:
qtbase5-doc-html
Source:
qtbase-opensource-src
Submitter:
Jiri Palecek
Date:
2019-10-20 19:09:03 UTC
Severity:
normal
#922707#5
Date:
2019-02-19 17:08:00 UTC
From:
To:
Dear Maintainer,

qtbase5-doc-html ships the qtcore.tags and other doxygen tags
files. These files are only needed for building documentation of
Qt-depending software, not for reading the documentation. When these
files are not present, documentation of such software still builds, but
may be suboptimal since the links to qt library docs won't work. This
happens silently and can be seen in the logs having lines like:

  No such target Qt5Network_QCH defined when calling ecm_add_qch(),
  ignored.

For an example, see
https://buildd.debian.org/status/fetch.php?pkg=kdnssd-kf5&arch=i386&ver=5.54.0-1&stamp=1547782120&raw=0

I think it would be much more convenient if those files were shipped in
-dev packages, not -doc packages (in this case qtbase5-dev). Software
depending on qt naturally build-depends on qtbase5-dev, not on -doc
which would be needed in that case.

Regards
    Jiri Palecek
#922707#8
Date:
2019-08-06 21:09:19 UTC
From:
To:
Hello,

Bug #922707 in qtbase-opensource-src reported by you has been fixed in the
Git repository and is awaiting an upload. You can see the commit
message below and you can check the diff of the fix at:

https://salsa.debian.org/qt-kde-team/qt/qtbase/commit/fdee0a88021918a323bb7a1c4c44e18abb8d820f
------------------------------------------------------------------------
Fix "please consider packaging doxygen .tags files with -dev package, not -doc"

* Fix "please consider packaging doxygen .tags files with -dev
  package, not -doc"
  - Move qhp .tags files into -dev package as they are needed
  at build time for qhp generation.
  (Closes: #922707)
------------------------------------------------------------------------

(this message was generated automatically)
-- 
Greetings

https://bugs.debian.org/922707
#922707#17
Date:
2019-08-09 21:52:43 UTC
From:
To:
severity 922707 normal
thanks

Raising the severity of the bug, this is clearly something that needs to be
fixed
#922707#22
Date:
2019-10-20 19:04:45 UTC
From:
To:
Hello,

Bug #922707 in qtbase-opensource-src reported by you has been fixed in the
Git repository and is awaiting an upload. You can see the commit
message below and you can check the diff of the fix at:

https://salsa.debian.org/qt-kde-team/qt/qtbase/commit/fdee0a88021918a323bb7a1c4c44e18abb8d820f
------------------------------------------------------------------------
Fix "please consider packaging doxygen .tags files with -dev package, not -doc"

* Fix "please consider packaging doxygen .tags files with -dev
  package, not -doc"
  - Move qhp .tags files into -dev package as they are needed
  at build time for qhp generation.
  (Closes: #922707)
------------------------------------------------------------------------

(this message was generated automatically)
-- 
Greetings

https://bugs.debian.org/922707