Should we re-organize Qt *-doc-html packages?

[Dmitry Shachnev]

Hi all,

This year, we have received two requests to move some files that are currently
shipped in a -doc-html package to another package:

- https://bugs.debian.org/922707 requests moving the .tags file to -dev.
- https://bugs.debian.org/933597 requests moving the examples-manifest.xml
  file and associated images to -examples.

These bugs are really not specific to qtbase or qt3d, so we should consider
them as affecting all Qt submodule packages.

The problem
===========

TL;DR: We can only ship these files in an Architecture: all package.

All files that are currently shipped in -doc or -doc-html are generated by
qdoc, which is built from qttools-opensource-src package. As that package
build-depends on qtwebkit, all Qt source packages up to qtwebkit [1] can *not*
build-depend on qdoc-qt5 when building architecture-dependent packages, as
that would create a B-D loop. So qdoc-qt5 can be only in Build-Depends-Indep.
As a consequence, files generated by qdoc can be only in Architecture: all
packages.

[1]: qtbase, qtdeclarative, qtwebsockets, qtwebchannel, qtsensors, qtlocation

The questions
=============

1) Should we create new Architecture: all packages (like qt*-doc-dev), to
contain the .tags and examples-manifest.xml files?

2) If yes, should it contain both these files or only one of them? Also
should we do it for all submodules, or only for those 6 modules listed
above?

3) If no, should we make qt*-dev or qt*-examples recommend qt*-doc-html?

Note that if the answer is ‘yes’, then we would need to do from 6 to ~30
uploads to NEW. (This is why I lean towards ‘no’.)

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/pkg-kde-talk/attachments/20191112/f6c6cc8b/attachment.sig>