#933597 qt3d5-examples: qt examples missing important files

Package:
qt3d5-examples
Source:
qt3d-opensource-src
Description:
Qt 5 3d examples
Submitter:
Mike Bird
Date:
2019-10-21 07:45:10 UTC
Severity:
important
#933597#5
Date:
2019-07-31 21:21:27 UTC
From:
To:
Installing various qt*examples packages such as this does not make
them visible in qtcreator.  This may be because the various
examples-manifest.xml (and associated images) are in the doc-html
packages (where they do not appear to be used) rather than in
the qt*examples packages where they are needed.  Installing the
doc-html files magically makes the examples appear in qtcreator.

#933597#10
Date:
2019-08-02 18:53:26 UTC
From:
To:
Hi Mike!

Thanks for bringing this up! I do not use qtcreator myself, so I could
not notice this bug.

This is a difficult issue for two reasons:

1) It affects all submodules, not just qt3d (we have 31 *-doc-html
packages at the moment).

2) Currently our .install files for the *-doc-html look very simple
and basically install everything under /usr/share/qt5/doc/{MODULE}.

To fix this, we need to explicitly list all files we want to install,
except the examples-manifest.xml files, which should go to -examples.
This is manual work, and it is easy to miss some such files.

I wonder if it will be better to simply make the *-examples packages
recommend the *-doc-html packages. (Not depend because the examples
can be run without qtcreator.) What do you think about this?

I am currently on vacation so I will be able to work on this not
earlier than in two weeks. But hopefully we can get this fixed before
Qt 5.12 reaches unstable.

#933597#15
Date:
2019-08-02 20:22:21 UTC
From:
To:
Sent via the Samsung Galaxy Note9, an AT&T 5G Evolution capable smartphone
-------- Original message --------From: Dmitry Shachnev <mitya57@debian.org> Date: 8/2/19  11:53 AM  (GMT-07:00) To: Mike Bird <mgb-debian@yosemite.net>, 933597@bugs.debian.org Subject: Bug#933597: qt3d5-examples: qt examples missing important files Hi Mike!On Wed, Jul 31, 2019 at 02:21:27PM -0700, Mike Bird wrote:> Installing various qt*examples packages such as this does not make> them visible in qtcreator.  This may be because the various> examples-manifest.xml (and associated images) are in the doc-html> packages (where they do not appear to be used) rather than in> the qt*examples packages where they are needed.  Installing the> doc-html files magically makes the examples appear in qtcreator.Thanks for bringing this up! I do not use qtcreator myself, so I couldnot notice this bug.This is a difficult issue for two reasons:1) It affects all submodules, not just qt3d (we have 31 *-doc-htmlpackages at the moment).2) Currently our .install files for the *-doc-html look very simpleand basically install everything under /usr/share/qt5/doc/{MODULE}.To fix this, we need to explicitly list all files we want to install,except the examples-manifest.xml files, which should go to -examples.This is manual work, and it is easy to miss some such files.I wonder if it will be better to simply make the *-examples packagesrecommend the *-doc-html packages. (Not depend because the examplescan be run without qtcreator.) What do you think about this?I am currently on vacation so I will be able to work on this notearlier than in two weeks. But hopefully we can get this fixed beforeQt 5.12 reaches unstable.Is this something I can help with to reduce your workload post vacation?Scarlett --Dmitry Shachnev

#933597#20
Date:
2019-08-02 23:12:02 UTC
From:
To:
Hi!

El vie., 2 ago. 2019 15:57, Dmitry Shachnev <mitya57@debian.org> escribió:


I do, but I also have almost the full stack installed, so I never bumped
into it.



Putting the xml files along the examples would also prove tricky, as they
are probably bring built with the arch:all build.

So yes, I think a recommendation is the best approach here.

I am currently on vacation so I will be able to work on this not
free to ping me.

#933597#25
Date:
2019-08-03 01:33:04 UTC
From:
To:
Let me do some more testing here.  It might be sufficient just to move
only the various examples-manifest.xml to the examples packages but I
need to do a lot more testing to confirm this.

I believe that there are additional missing dependencies for some
of the examples.  Would it be possible for the *examples* packaging
to include a build-time test that the included examples build?  That
looks to me to be fairly simple to implement but I'm not a DD so I
may be over-looking something.

#933597#30
Date:
2019-08-03 02:11:48 UTC
From:
To:
Hi Mike!

The problem is that there is no "just move" thing. Doc packages are
built separately from examples, and we would have to do a fairly
lengthy process to sort out those xml files form the rest of the doc.

We currently lack lots of tests because we are very limited in man
power. It's not just adding them but also keeping them up to date.
That being said please do not hesitate in filling bugs for examples
missing dependencies.

#933597#35
Date:
2019-08-03 12:39:35 UTC
From:
To:
Hi Lisandro,

I thought it would be more useful to test 5.12 in experimental
rather than 5.11 in Buster.  However I belatedly discovered that
qtcreator is not in experimental.  Of possibly less importance
to my testing the following also appear to be missing:

   qml-module-qt-labs-handlers
   qt5-doc
   qt5-doc-html
   ... and roughly 70 python qt packages.

Is qtcreator likely to appear in experimental any time soon or
should I test in 5.11?

Thanks,

#933597#40
Date:
2019-08-03 12:51:01 UTC
From:
To:
Hi Mike!

El sáb., 3 ago. 2019 09:39, Mike Bird <mgb-debian@yosemite.net> escribió:



You should test with 5.11 or wait for 5.12 to get into unstable.

#933597#45
Date:
2019-08-03 18:28:47 UTC
From:
To:
Hi Mike,

Lisandro already replied, but let me clarify why the packages are missing.

It is now part of qml-module-qtquick2, following the upstream merge:

https://code.qt.io/cgit/qt/qtdeclarative.git/commit/?id=197c22be541e18b3

These packages are still in the NEW queue:

https://ftp-master.debian.org/new/qtdoc-opensource-src_5.12.2-1.html

PyQt5 is in experimental, but it is built against Qt 5.11 there.

Maybe I will update it, but not now.

More likely it won’t be updated.

#933597#50
Date:
2019-08-03 18:31:11 UTC
From:
To:
Hi Scarlett!

Yes please, feel free to commit these changes. I think we have agreed
that recommending the -doc-html packages is the easiest approach.

I think there is no need for new uploads though — I am going to request
a transition when I get back to normal work.

#933597#53
Date:
2019-08-10 18:46:55 UTC
From:
To:
Hello,

Bug #933597 in qt3d-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/qt3d/commit/43c68d19d29b81879bdaec3dbe11140fb5fd6944
------------------------------------------------------------------------
Fix "qt examples missing important files"

* Fix "qt examples missing important files"
  - Move examples manifest files into the examples package.
  - Add breaks/replaces for moved files.
  (Closes: #933597)
* Move qhp .tags files into -dev package as they are needed
  at build time for qhp generation.
  Please see bug: #922707: please consider packaging doxygen
  .tags files with -dev package, not -doc
------------------------------------------------------------------------

(this message was generated automatically)
-- 
Greetings

https://bugs.debian.org/933597

#933597#58
Date:
2019-10-21 07:41:02 UTC
From:
To:
Hello,

Bug #933597 in qt3d-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/qt3d/commit/43c68d19d29b81879bdaec3dbe11140fb5fd6944
------------------------------------------------------------------------
Fix "qt examples missing important files"

* Fix "qt examples missing important files"
  - Move examples manifest files into the examples package.
  - Add breaks/replaces for moved files.
  (Closes: #933597)
* Move qhp .tags files into -dev package as they are needed
  at build time for qhp generation.
  Please see bug: #922707: please consider packaging doxygen
  .tags files with -dev package, not -doc
------------------------------------------------------------------------

(this message was generated automatically)
-- 
Greetings

https://bugs.debian.org/933597