clang needs the path to the system include files. There is
an option to pass system include paths to qdoc on the command
line, but currently there is no way to get the information
from the build system.

With this change, clangqdoc asks if the system include paths
have been provided. If not, it uses the path to <locale.h> as
the system include path, which it passes to clang using the
-isystem option.

Thanks to Edward Welbourne for this solution.

Change-Id: I2716505126d7780fc616b8ffd7cd2865576bae16
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>

The file qt_find_clang.prf is inspired by qtcreator's clang_installation.pri.
The code from the while loop in ClangVisitor::parseProperty contains code
moved from CppCodeParser::matchProperty. The code in the for loop of
ClangCodeParser::parseSourceFile (from the "Doc parses the comment"), is mostly
moved from CppCodeParser::matchDocsAndStuff.

In CppCodeParser, most of the code is removed since clang is used for parsing.
We just need to leave enough to parse the declaration in the comments which
still use the old parser (\fn, ...)

Known issues:
- When the parameter name is a comment, it is lost.
  (e.g. QObject::eventFilter(QObject * /* watched */, QEvent * /* event */)
- I can't compute default parameters when they are expanded from a macro.
  (e.g. QObject::tr)
- Instances of #ifndef Q_QDOC need to be reviewed

Change-Id: I92d4ca4fc52810d9d3de433147a9953eea3a1802
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>

Task-number: QTBUG-47566
Change-Id: I4a7dc1fe14154695b968fffd14abd2e3189c6ad2
Reviewed-by: Jake Petroules <jake.petroules@qt.io>
Reviewed-by: Simon Hausmann <simon.hausmann@qt.io>

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

More than two thirds of main() concerned parsing the command-line
arguments and settings globals, interacting minimally with the rest.
So split that code out into a sub-class of the command-line parser, to
make main() itself easier to read.

Changed a QStringLiteral to a QLatin1String to work round an MSVC-2010
issue.

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

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>