| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Add a visitor functor that reconstructs template parameters from
the Clang AST, and use it when either a class or a method template
is detected.
Store this information in the node - for now, they are used only
in the class reference page subtitle (for classes), and detailed
section of function documentation. Template parameters are not
considered when searching/linking to entities, they are for
display only.
[ChangeLog][qdoc] Added capability to display class/method template
parameters in the generated documentation.
Fixes: QTBUG-17456
Change-Id: I300cc63b9fa20d4f6efaeaa27ea3769635a7b32c
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
|
|
|
|
|
|
|
|
| |
Remove useless parentheses, useless </br>, and link to each entity
in the qualified (full) name.
Fixes: QTBUG-81526
Change-Id: I419bd22c1159d71f796806ce8659c232d406b123
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
|
|
|
|
|
|
|
| |
Recent commits introduced two typos that caused a number of
documentation warnings.
Change-Id: I4ad32f96624c7204b4f721f4a3bc1d17ca53492d
Reviewed-by: Venugopal Shivashankar <Venugopal.Shivashankar@qt.io>
|
|\
| |
| |
| | |
Change-Id: Ie6dc6946f0cf21c2cf57643c393e61b2deefb90d
|
| |
| |
| |
| |
| |
| |
| | |
Change-Id: I953f30dc04f4bc95fccb135b79f806d6a354ed70
Coverity-Id: 226101
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| |
| |
| |
| |
| |
| | |
Fixes: QTBUG-65810
Change-Id: I02fa147bed30342f12f26f6ba0169ef6d9f98e79
Reviewed-by: Jani Heikkinen <jani.heikkinen@qt.io>
|
| |
| |
| |
| |
| | |
Change-Id: I81c229523e0d896f25d6d961c9857b615218ecbb
Reviewed-by: Jarek Kobus <jaroslaw.kobus@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
This simple boolean variable determines whether the full path
information of entities is stored into index files, and by extension,
the output of the WebXML generator.
The default value is true, and QDoc's output is unchanged. Using a
value of false is useful for testing QDoc; we can omit system
build paths in the output as those complicated the comparison of
expected and generated data.
[ChangeLog][qdoc] Introduced a configuration variable to drop
host-specific paths from the generated output.
Fixes: QTBUG-81091
Change-Id: Ic8df5e4a52a12821e2858a185c4e658905deb847
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Qt has a long history, with lots of classes and functions
documented being introduced in a specific version. This
\since information for decade-old features is not relevant
anymore, producing noise about ancient Qt releases that
have been long unsupported.
In preparation for Qt 6, introduce a feature where we can set
a cutoff value for \since information that can be ignored in
the generated documentation.
Fixes: QTBUG-81090
Change-Id: Ib35a2a4d8bc3a6cb9719223a45b02f0e63f337ea
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
There is no need to pass a pointer to Config throughout
the API; the only instance of it is created in main()
so we can turn it into a singleton.
Having access to Config without API changes makes
implementation of configurable features easier.
Change-Id: Ida47e067865082dfe036a7a97f7f1ffc736db346
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
|
| |
| |
| |
| |
| |
| | |
Task-number: QTBUG-46653
Change-Id: I62145c2ecb97a5f3538502303fbdb81ad33aded7
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
|
| |
| |
| |
| |
| |
| | |
Change-Id: I74c016fdfbe9d6fad13cad5819a38a4ffd3f16c5
Reviewed-by: Karsten Heimrich <karsten.heimrich@qt.io>
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
|
| |
| |
| |
| |
| | |
Change-Id: I89134948df20e0b546ca6ef835da4a678fd579b2
Reviewed-by: Karsten Heimrich <karsten.heimrich@qt.io>
|
| |
| |
| |
| |
| | |
Change-Id: I69fd2e98079b172e8649697c8fd56064867be9fd
Reviewed-by: Karsten Heimrich <karsten.heimrich@qt.io>
|
| |
| |
| |
| |
| | |
Change-Id: I6eb8545a069febd578604207ae6f4f9311bb9aec
Reviewed-by: Karsten Heimrich <karsten.heimrich@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Adds the QHelpFilterSettings class, describing all
the available filter details.
Adds the QHelpFilterSettingsWidget class, serving
as an editor for all available filter. It also
provides methods for storing and retrieving
filter details into / from the help settings.
Change-Id: Ie87578fc30d8114b95508f5b761e7914447c247a
Reviewed-by: Karsten Heimrich <karsten.heimrich@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
SAX classes for parsing XML documents will be deprecated soon.
Re-implemented SAX-based xml parsing classes using QXmlStreamReader.
All the parsers now inherit from XmlParser, which drives the parsing
loop and allows overriding the methods for handling different XML tokens
in a specific way depending on the use-case.
Task-number: QTBUG-76177
Change-Id: I5393cc7218beffb4e48187e435c89d1d179deb37
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| | |
Ensure the highlight color (which affects the subwindow border)
has a visible effect.
Change-Id: Ic4a3e9295aa85fb248546714fd29f02eca2ce2a5
Reviewed-by: Jarek Kobus <jaroslaw.kobus@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| | |
Add more widgets. Most importantly, add an item view with alternate
colors to be able to view selection colors.
Change-Id: I263ad4b5109e42b3e839892af5fd8d8d7066ca30
Reviewed-by: Jarek Kobus <jaroslaw.kobus@qt.io>
|
|\ \ |
|
| |\ \
| | |/
| | |
| | | |
Change-Id: Iedc2f057fbc2c78a0ed11661dbe9141a542f0de1
|
| | |
| | |
| | |
| | |
| | |
| | | |
Fixes: QTBUG-78146
Change-Id: I1e52e17d9024f566e761b804d56bf029f1d7b83f
Reviewed-by: Kai Koehne <kai.koehne@qt.io>
|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
* Make calling code specify Atom type, remove superfluous ctor.
* Move default initialization from initialization list to in-class
for member that initializes the same in all ctors.
* Move initialization from ctor body to initialization list.
* Mark trivial dtor default.
Change-Id: I5e4a9e5cdcf0b9f3ba68b53dcab34c2ab77b415d
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
Whitespace that got reintroduced from an old patch that
integrated late. Fix it separately to avoid mixing with
other changes.
Change-Id: I6e905cd5710a31c671702a6ad9f5711b251e1020
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
As we claim the html is html5 compliant (<!doctype html>), use the
html5 charset declaration instead of html 4.01 style. Also, drop the
trailing '/' (no need to close meta element).
Update all test content to match the new output.
Task-number: QTBUG-73026
Change-Id: I4cf58a342a2bfb9e76245bd3fb91525e6e59f622
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
The html output is not well-formed xml, so let's not claim that it is.
Update expected output in tests to reflect the change in output.
Task-number: QTBUG-73026
Change-Id: I0e6646eb33cafad7be543869585609d6f4cb0fdb
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
After a recent refactoring, the function that distributes c++
documentation nodes failed to do anything with a function node that
was sharing a comment with other nodes.
Fix the issue and add a testcase for shared c++ \fn documentation
comments.
Fixes: QTBUG-81005
Change-Id: I6320bab232671f8cd969a37136708fc172de8409
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
|
|/ /
| |
| |
| |
| |
| |
| |
| |
| | |
Add some rudimentary output about available RHI backends.
Task-number: QTBUG-78684
Change-Id: I1289c6f67affca33691e1ef701af106e0d494d9a
Reviewed-by: Laszlo Agocs <laszlo.agocs@qt.io>
Reviewed-by: Paul Olav Tvete <paul.tvete@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
The use of this code would be to overhaul the translation project of
the documentation in French, for Developpez.com (which is now stuck
at Qt 4.7 due to outdated tools: https://qt.developpez.com/doc/).
This means that this code will be used and maintained, whatever the
decision follows QTBUG-71493, for instance.
The DocBook support is not 100% vanilla DocBook, as some tags are
missing, but rather an extension (which could be officialised soon:
https://github.com/docbook/docbook/issues/111). These tags are used
to encode metadata about the code being commented (classes, fields,
functions, etc.). More precisely, the required tags are:
[enum|macro|namespace|typedef|union][|name|synopsis],
enum[value|identifier|item], [specialized]template[id].
These extensions can be enabled by the docbook-extensions parameter.
If you want to see the history:
https://github.com/dourouc05/qttools/tree/dourouc05-qdoc-docbook
Change-Id: I919976d8680b41c5ca69bdb79a0b824c29b89d05
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
Reviewed-by: Martin Smith <martin.smith@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Use insert() for m_glyphsPerUnicodeRange, which is a QMultiHash,
fixing:
distancefieldmodel.cpp:186:59: warning: 'QHash<K, V>::iterator QHash<K, V>::insertMulti(const Key&, const T&) [with Key = DistanceFieldModel::UnicodeRange; T = unsigned int]' is deprecated: Use QMultiHash for hashes storing multiple values with the same key. [-Wdeprecated-declarations]
Change-Id: I58488754c67af3c31574a4b657660ac094b188ec
Reviewed-by: Lars Knoll <lars.knoll@qt.io>
|
|\ \
| |/
| |
| | |
Change-Id: I8d517708261431bb0cc5b88030756af989da6bd0
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Change the debug detection to match debug or release for anything
except Msvc/ClangMsvc, effectively turning the check off.
Msvc/ClangMsvc are the only remaining compilers for which
distinct debug/release binaries are generated by
debug-and-release due to the different runtimes.
Fixes: QTBUG-80806
Task-number: QTBUG-80763
Task-number: QTBUG-78445
Change-Id: I85f170787c45a08cc28f37caa54e152dd7191e0f
Reviewed-by: Oliver Wolff <oliver.wolff@qt.io>
Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org>
Reviewed-by: André de la Rocha <andre.rocha@qt.io>
|
| |
| |
| |
| |
| | |
Change-Id: I743baf96185fcb20ce740fcc9c2beb011f5bdefb
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
|
| |
| |
| |
| |
| |
| |
| | |
Clean up some related code
Change-Id: I5d8d853e63a0d6a219d659a83267c748bbe42342
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
- Make it a QFlags, providing operators
- Remove WinCE
- Add a Msvc compiler flag and make the tests for
build directory and d-suffix depending on it.
- Add clang-Msvc/clang-MinGW
- Rename WindowsDesktop to WindowsDesktopMsvc,
WinRtIntel to WinRtIntelMsvc and WinRtArm to WinRtArmMsvc
- Use QFlags::testFlag()
Task-number: QTBUG-80806
Task-number: QTBUG-80763
Task-number: QTBUG-78445
Change-Id: I0dd74a7b03e9e6bee55d4234c12eec17d52ce0e2
Reviewed-by: Oliver Wolff <oliver.wolff@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
UWP targets have the naming scheme of VCRUNTIMEXXX(d)_APP.dll. The
"_APP" part, which is also mentioned in the comment, has to be taken into
account when looking for the d "suffix" of the runtime library.
Change-Id: Iea84687c7c3f230ac9520ca983e742b0938eec15
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
Reviewed-by: Jiong Chang <xspeed1989@gmail.com>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
QDoc automatically generates hyperlinks for words that qualify for
auto-linking. This may become a problem whenever there is a qualified
word as a section or a page title, and that word appear in the
documentation frequently. For example, 'macOS' is mentioned often
and each occurrence is linked, which is unnecessary and sometimes
confusing.
Provide a way to exclude specified words from being auto-linked.
Create a new helper function, DocParser::isAutoLinkString(), to
determine whether a string qualifies, and replace duplicated
code with calls to that function.
Fixes: QTBUG-79135
Change-Id: Ie53fe7ca0692f7b8e10a5f2208df5cd2ee2aab1d
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Apply the rcc part from qtbase/c7e35ffe69a73bb144618714313673f0d0c28394
to the copy of the rcc code used in Qt Designer, fixing:
shared/rcc.cpp: In member function 'bool RCCResourceLibrary::addFile(const QString&, const RCCFileInfo&)':
shared/rcc.cpp:605:47: warning: 'QHash<K, V>::iterator QHash<K, V>::insertMulti(const Key&, const T&) [with Key = QString; T = RCCFileInfo*]' is deprecated: Use QMultiHash for hashes storing multiple values with the same key. [-Wdeprecated-declarations]
Change-Id: Ib9989db852a8e0333d508c055c9f2667d65d74e9
Reviewed-by: hjk <hjk@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Fixes some unprefied textstream usages.
Bump the module version to 6.0.0.
Also windeployqt auto test is temporarily blacklisted because
with the current situation it's not possible to make it pass both
with a 5.x and a 6.x Qt build, and thus this would prevent a qt5.git
integration.
Change-Id: If750cf4f50ba4215cb63b53c42971f3d1f1c8160
Reviewed-by: Simon Hausmann <simon.hausmann@qt.io>
(cherry picked from commit f3d047af903801d9e7705816df5299c4e04a76f4)
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Change-Id: Ie413ca2e2f81ac0e92628ffd2f3e93047a91bd0c
Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org>
Reviewed-by: Simon Hausmann <simon.hausmann@qt.io>
(cherry picked from commit 6b2f32f3dc9de965801927a4bc5d970028a318a6)
Reviewed-by: Allan Sandfeld Jensen <allan.jensen@qt.io>
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
|
|\ \
| |/
| |
| | |
Change-Id: I9ca43519bcad38f38f70eede4ee98b8028528259
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
This patch is the result of formatting all of QDoc's source with
clang-format. The clang-format style is from the qt5 super repo's
_clang-format definition.
The purpose is unify the style across the code, to avoid spending too
much time on style related issues in reviews and cleanup patches. Future
changes to QDoc can benefit from using git-clang-format in combination
with the git commit hook provided in qtrepotools.git as mentioned in
this email to the dev list:
https://lists.qt-project.org/pipermail/development/2019-October/037682.html
Change-Id: I8af6a051c8334b5f35862a4dcd3becce8ac500c2
Reviewed-by: Martin Smith <martin.smith@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
QDoc was incorrectly assuming that QML properties that share a comment
must belong to a property group.
Fix the issue, reduce duplication of code with functions that
output properties and methods, fix the 'id' attributes that were left
empty, and remove the <a name="..."> elements that are obsolete and
unnecessary now that 'id' has correct content.
Add a test for both properties and methods that share a comment, and
fix the expected output data for above changes.
Fixes: QTBUG-80768
Change-Id: Iddfca8214b6058987c76cd8f8dd6a842ce7cea89
Reviewed-by: Levon Sargsyan <levon.sargsyan@qt.io>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
|
|\ \
| |/
| |
| | |
Change-Id: Iba365dc87ee3e96b2a44dad6bf4da436fd7b04f7
|
| |
| |
| |
| |
| |
| | |
Change-Id: I3ec3342eb3362664c605c4120238566d87c8b176
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
The platform no longer has a 'd' suffix for debug binaries
(see qtbase/4d289edb14aeb4976218cc306bfc514e37521b82).
Add a check.
Fixes: QTBUG-80763
Task-number: QTBUG-78445
Change-Id: I8d4617e2111167a546fa172cbca78a656d233ee5
Reviewed-by: Simon Hausmann <simon.hausmann@qt.io>
Reviewed-by: Oliver Wolff <oliver.wolff@qt.io>
|
| |
| |
| |
| |
| |
| |
| | |
Simple cleanup to improve readability.
Change-Id: If9ee2947ad76e64d230584a3cb36e51457f643c3
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Replace the use of QVector in most of QDoc.
Also, remove one redundant C-style cast to int for result from method
call that returns an int. As this happened in a macro, the result is
removing a whole bunch of nagging from code inspection.
Fixes: QTBUG-80669
Change-Id: Ib1aed95e01eaddd1e1213a145e815a0c4753ac67
Reviewed-by: Mårten Nordheim <marten.nordheim@qt.io>
|
| |
| |
| |
| |
| |
| |
| | |
Pre-increment instead of post-increment for efficiency and readability.
Change-Id: I10b33360dd36cd1d0f4338441c1ad4724551e80e
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|
| |
| |
| |
| |
| |
| |
| | |
Drop casting ints to int.
Change-Id: I571f3e245bfc97a7c0c7bea5bedbf0ed5ab04c60
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
|