From Qt 5.7 -> tools & applications are licensed under GPL v3 with some
exceptions, see
http://blog.qt.io/blog/2016/01/13/new-agreement-with-the-kde-free-qt-foundation/


Updated license headers to use new GPL-EXCEPT header instead of LGPL21 one
(in those files which will be under GPL 3 with exceptions)

License header tests also updated to match current headers.

Change-Id: Ia6bdacaa3c5bbc9d31334e1a0cabfe502a484dc4
Reviewed-by: Jani Heikkinen <jani.heikkinen@qt.io>

Documentation configuration variables 'excludedirs' and 'excludefiles'
had no effect on what source and image files were listed as belonging
to an example.

This commit fixes that, and refactors excludedirs/files handling:
Remove duplicated code blocks, amd simplify the code reading the
variables:

  - Drop checks whether an excluded directory exists
  - Drop conversion of native separators for excluded paths

Both are unnecessary; QDoc expects '/'-separated paths for many other
variables, and if an excluded dir does not exist, it won't exclude
anything.

Change-Id: Ie25511e20d33888653c23bb84975368317eb4306
Reviewed-by: Alex Blasche <alexander.blasche@theqtcompany.com>
Reviewed-by: Martin Smith <martin.smith@theqtcompany.com>

This reverts commit 18fe6a9a

.

Because we are changing the C++ parser to clang, we won't need this
anymore.

Task-number: QTBUG-48191
Change-Id: Iacf134ab91517a0eb3e28ea6bce41f74e3c957a0
Reviewed-by: Martin Smith <martin.smith@theqtcompany.com>

In -single-exec mode, qdoc doesn't read index files.
Therefore, the -indexdir option is ignored. qdoc now
warns immediately when it ignores the -indexdir option
in -single-exec mode.

Change-Id: I85513df04041a722bccf14ad613693f283ab0504
Task-number: QTBUG-50840
Reviewed-by: Topi Reiniö <topi.reinio@theqtcompany.com>

Change-Id: I5d3f78ad0c6e9a494485a2b5dca237c839d0932a
Reviewed-by: Topi Reiniö <topi.reinio@theqtcompany.com>

This commit adds a new argument for \generatelist command, which
enables the generation of an 'example index' page:

    \generatelist annotatedexamples

This will generate a set of tables; one for each module, prefixed
by a header titled with the module name. The table is an annotated
list (title + brief description) for each documented example.

A human-readable name for each module is read from the
navigation.landingpage .qdocconf variable. This name is written
to / read back from the index files as 'indexTitle' attribute.
Examples for modules that do not define a landing page title
are listed in a single table with no accompanying header.

Change-Id: Icb7fa6fb40ec9a0dfce1bf8282c8782a69ec0028
Reviewed-by: Venugopal Shivashankar <venugopal.shivashankar@digia.com>
Reviewed-by: Martin Smith <martin.smith@theqtcompany.com>

qdoc no longer creates a function node when it parses a function
declaration, if a function node for the function already exists.
This avoids needless allocation and deallocation.

qdoc now also avoids creating unnecessary variable nodes.

This change also improves the "No documentation for..." error
message so that it includes the parameters if the error refers
to a function. This makes it easier to find the correct function
when you are trying to correct these errors in the documentation.

Change-Id: Ib0f9361622f9115d677408e36bfed77c42545be0
Task-number: QTBUG-48191
Reviewed-by: Martin Smith <martin.smith@digia.com>

we can do that now, as the bootstrap lib is now a properly exported
module, and qmldevtools is now bootstrapped as well.

this removes the abomination of a copy of the qml parser in qtbase.
unfortunately qtbase/2422251ee5025a067b14b989153764ab36e43f10 is
reverted, as qtdeclarative is still missing the respective change.

this introduces no regression in discoverability or usability, as a full
doc build already needed qttools - for qhelpgenerator.

Change-Id: Ic9c4c9732ddf5998637b9e42e27939ba50b31479
Reviewed-by: Jędrzej Nowacki <jedrzej.nowacki@theqtcompany.com>
Reviewed-by: Martin Smith <martin.smith@digia.com>
Reviewed-by: Lars Knoll <lars.knoll@theqtcompany.com>
Reviewed-by: Topi Reiniö <topi.reinio@digia.com>