Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 313711 - [qting-edge] x11-libs/qt-core live ebuilds don't install html doc with USE="doc"
Summary: [qting-edge] x11-libs/qt-core live ebuilds don't install html doc with USE="doc"
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Qt Bug Alias
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-04-07 17:37 UTC by Jean-Baptiste Rouault
Modified: 2010-04-10 23:20 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments
build log (build.log,506.62 KB, text/plain)
2010-04-07 17:40 UTC, Jean-Baptiste Rouault
Details
Add html-docs use flag to qt-assistant-4.6.9999 (qt-assistant-4.6.9999-html-docs.patch,3.19 KB, patch)
2010-04-10 12:16 UTC, Jean-Baptiste Rouault
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Jean-Baptiste Rouault 2010-04-07 17:37:28 UTC
Installing qt-core-4.*9999 with USE="doc" doesn't install html documentation as expected.
This is probably because it is needed to run "make docs" as can be seen here : http://is.gd/biQp0

Reproducible: Always

Steps to Reproduce:

Actual Results:  
There is some failure during make install which is ignored (see attached build log)

Expected Results:  
html docs should be generated and installed
Comment 1 Jean-Baptiste Rouault 2010-04-07 17:40:28 UTC
Created attachment 226907 [details]
build log

The error is at the end, before the translations generation
Comment 2 Markos Chandras (RETIRED) gentoo-dev 2010-04-08 23:41:12 UTC
Ok correct me if I am wrong

the rule make docs doesnt generate html documentation according to makefile

docs: adp_docs qch_docs

However, the install_htmldocs rule is the following

install_htmldocs: FORCE
        @$(CHK_DIR_EXISTS) $(INSTALL_ROOT)/usr/share/doc/qt-4.6.9999/ ||
$(MKDIR) $(INSTALL_ROOT)/usr/share/doc/qt-4.6.9999/
        -$(INSTALL_FILE)
/var/tmp/portage/x11-libs/qt-core-4.6.9999/work/qt-everywhere-opensource-src-4.6.9999/doc/html
$(INSTALL_ROOT)/usr/share/doc/qt-4.6.9999/

But the doc/html doesnt exist. The html documentation doesnt exist on live
ebuild because simply upstream nor ships it neither has a rule to generate it

If there are no objections the live ebuilds should be fixed to NOT bother about
the html docs at all
Comment 3 Jean-Baptiste Rouault 2010-04-10 12:15:15 UTC
As stated in the link I pasted in the first comment, if you run make docs, you will see that html docs is generated and can be found in doc/html folder.
It is then necessary to re-run qmake so that install_htmldocs target is updated.
I made a patch for qt-assistant-4.6.9999 ebuild and managed to generate and install html docs with it.
Comment 4 Jean-Baptiste Rouault 2010-04-10 12:16:07 UTC
Created attachment 227257 [details, diff]
Add html-docs use flag to qt-assistant-4.6.9999

Patch to generate and install html docs with qt-assistant
Comment 5 Markos Chandras (RETIRED) gentoo-dev 2010-04-10 13:10:35 UTC
I understand what you are saying here. I am in the middle of some tests regarding move the documentation installation from qt-assistant -> qt-core due to linking issues in 4.7[stable-branch]. If this migration is success I will apply your patch to qt-core-4.6.9999

Stay tuned for the upcoming results
Comment 6 Markos Chandras (RETIRED) gentoo-dev 2010-04-10 13:23:06 UTC
Now that I see your patch more carefully, it might not work since emake docs using /bin/qhelpgenerator which is provided my qt-assistant. It will work if you have qt-assistant installed but It wont if you don't cause it will lead into circullar dependencies

I will try to figure out something
Comment 7 Markos Chandras (RETIRED) gentoo-dev 2010-04-10 23:20:29 UTC
Documentation moved from qt-core -> qt-assistant. Please enable doc use flag on qt-assistant and try rebuild those two packages

Re-open if needed

Thanks for your patch and your feedback