[kde-freebsd] Qt5 on FreeBSD 5.3 upgrade: please add ports/UPDATING entries

[Matthias Andree]

Dear KDE porters,

thanks for your long and intricate work on the Qt 5 5.3 upgrade.

However, I have bumped into some obstacles, and I would like to ask you
to add UPDATING entries so we avoid other people from being tripped up
in the same places.

I am using 9.3-RELEASE-* amd64 with portmaster and pkgNG. No pkg
binaries here.

In particular, I found:

1. pkg delete -f qt5-qmldevtools
   is required before qt5-qml can be installed.

2. qt5-quick does not build if some 5.2.1 ports are left, I suppose (but
did not check) this is due to qt5-quick build preferring /usr/local
libraries over the locally built ones when linking.

I get errors like these /usr/local/lib/libQt5Quick.so.5: undefined
reference to `QQmlCustomParser::error(QQmlCustomParserNode const&,
QString const&)' while building qt5-quick.

Deleting all remaining qt5*5.2.* ports at this time sidesteps that problem.

This was the failure situation in portmaster, after having recovered
from #1.  Unfortunately I lost the *useful* error logs, so I cannot
reproduce the command line that led to the libQt5Quick.so linker failure.

...

> *** [sub-tools-all] Error code 2
> 1 error
> ===> Compilation failed unexpectedly.
> Try to set MAKE_JOBS_UNSAFE=yes and rebuild before reporting the failure to
> the maintainer.
> *** [do-build] Error code 1
> 
> Stop in /usr/ports/x11-toolkits/qt5-quick.
> 
> ===>>> make build failed for x11-toolkits/qt5-quick
> ===>>> Aborting update
> 
> ===>>> Update for qt5-quick-5.2.1_2 failed
> ===>>> Aborting update
> 
> ===>>> Update for qt5-webkit-5.2.1_5 failed
> ===>>> Aborting update
> 
> ===>>> Update for devel/qt5-designer failed
> ===>>> Aborting update

...

> ===>>> The following actions were performed:
> 	Installation of lang/qt5-qml (qt5-qml-5.3.2)
> 	Upgrade of qt5-xml-5.2.1_1 to qt5-xml-5.3.2
> 	Upgrade of qt5-linguisttools-5.2.1 to qt5-linguisttools-5.3.2
> 	Upgrade of qt5-clucene-5.2.1_1 to qt5-clucene-5.3.2
> 	Upgrade of qt5-help-5.2.1_2 to qt5-help-5.3.2
> 	Upgrade of qt5-printsupport-5.2.1_2 to qt5-printsupport-5.3.2
> 	Upgrade of qt5-testlib-5.2.1_1 to qt5-testlib-5.3.2
> 	Installation of lang/ruby20 (ruby-2.0.0.576_1,1)
> 
> 
> ===>>> You can restart from the point of failure with this command line:
>        portmaster <flags> devel/qt5-designer devel/qt5-assistant www/webkit-qt5 x11-toolkits/qt5-quick devel/qt5-concurrent multimedia/qt5-multimedia devel/qt5-script x11-toolkits/qt5-declarative 

(Note portmaster does not display these in build order, it was )

We either need to make sure the local libs are preferred over
/usr/local/lib during the build, or instruct users (via UPDATING) to
kill qt5-quick before rebuilding it.

I hope you can add relevant UPDATING entries.

Thanks a lot.

Cheers,
Matthias