Commit Graph

93 Commits

Author SHA1 Message Date
Alessandro Portale
b24492c6e9 ExtensionSystem: Add field "DocumentationUrl" to PluginSpec
Task-number: QTCREATORBUG-31199
Change-Id: Ieb20d35cc9b4fe976207491bd201750fa4ca0032
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2024-07-29 07:27:03 +00:00
hjk
640a30fb76 Coding style: Mention "final" and endorse it
Change-Id: I6d420b95a31628d39a0be594e66a6b785664ff86
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2024-07-26 11:37:20 +00:00
Leena Miettinen
b160b367d1 Doc: Fix QDoc warnings in Extending Qt Creator Manual
Change-Id: I278ae2338427a7d65253d579d0a1ff7d53245c45
Reviewed-by: hjk <hjk@qt.io>
2024-07-18 10:56:40 +00:00
Eike Ziller
38e005692e Plugin meta data: Add full stop to descriptions
Where they were missing. The text is shown as a paragraph in the
extension manager.

Change-Id: I6e15c89fe4023b222e9c476f4312e13fcb0905c0
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Alessandro Portale <alessandro.portale@qt.io>
2024-06-28 06:46:52 +00:00
Jarek Kobus
b4f798d002 CodingStyle: Fix Utils::QtcProcess -> Utils::Process rename
Change-Id: Iabcfcdea47bf6372904b5a0f89c568790df90023
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2024-06-24 05:49:08 +00:00
Cristian Adam
36e84b1c54 Doc/Wizards: Update minimum CMake version to 3.16
Qt Creator due to the usage of CMake File-API was already requiring
CMake 3.14.

Qt 6.7 now requires CMake version 3.16, thus the version requirement
bump.

Note that Qt SDK is shipping CMake version 3.27.

Fixes: QTCREATORBUG-31079
Change-Id: Ife26d178b80949941cb808a1fbd91389d6d723bc
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2024-06-19 08:12:41 +00:00
Marcus Tillmanns
a76d9bf085 Lua: Add documentation
Change-Id: I96b4525b68919247440d6aad544e0386d921384f
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2024-06-13 12:54:42 +00:00
Eike Ziller
6a68df5fd1 UI guidelines: Update the rules for localization
We switched to single contexts with Tr::tr and have
FilePath::toUserOutput now, adapt the rules accordingly.

Change-Id: Ie73b8077dfd6bef56f709538db1d1b3ec7843041
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2024-05-27 11:17:32 +00:00
Eike Ziller
8b5f5744dc Rename Qt Designer -> Qt Widgets Designer
Fixes: QTCREATORBUG-30756
Change-Id: Icb4a2513e230b71b5bb5033ead6a09ad3a8963ab
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2024-05-23 11:37:08 +00:00
Leena Miettinen
1218175c78 Doc: Write "toolchain" as one word
We still have some occurrences in the UI where it is written as
two words, though.

Change-Id: I245e4185c8ede4313bbe64641f38a3850fa8cbeb
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
2024-05-07 09:25:16 +00:00
Eike Ziller
3249b106e5 Make it possible to add wizards paths via plugin meta data
That makes it easy with Lua plugins, and is useful on the C++ side as
well.

Change-Id: I660956bed47e4c1e27a001ad8999d6701cda86ee
Reviewed-by: Marcus Tillmanns <marcus.tillmanns@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
2024-05-06 09:46:29 +00:00
Leena Miettinen
bdada3c5ff Doc: Move Debugging info into "How To" and "Reference"
- Turn "Debugging" into an overview topic
- Remove FSF GDB as it is not supported anymore

Task-number: QTCREATORBUG-29361
Change-Id: I1d8ce78a2f89a85a1337d83aa6011f06afac4e41
Reviewed-by: David Schulz <david.schulz@qt.io>
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: hjk <hjk@qt.io>
2024-04-19 12:48:39 +00:00
Eike Ziller
8500dd03bf Merge remote-tracking branch 'origin/13.0'
Conflicts:
	doc/qtcreator/src/overview/creator-only/creator-keyboard-shortcuts.qdoc

Change-Id: I2db85da9f4a0593217951313020d71d430986961
2024-03-22 15:13:34 +01:00
Leena Miettinen
19fd7e15e3 Doc: Fix the name of the option for auto-generating navigation links
It is navigation.toctitles.

Change-Id: Ibb935d37436426aacb773d4d9a0c6851ca3472c1
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
2024-03-21 07:25:38 +00:00
Eike Ziller
90e1d96019 Merge remote-tracking branch 'origin/13.0'
Conflicts:
	cmake/QtCreatorIDEBranding.cmake
	doc/qtcreator/src/overview/creator-only/creator-keyboard-shortcuts.qdoc
	qbs/modules/qtc/qtc.qbs
	src/plugins/remotelinux/linuxdevicetester.cpp

Change-Id: I8434e41dcfbb50f6ed032a3e0af1591eb19b79eb
2024-03-20 15:05:58 +01:00
Leena Miettinen
263d5ff1e6 Doc: Update info about automatically generating navigation links
The \nexpage and \previouspage links in the QDS Manual are now
automatically generated according to the list in the "All Topics"
topic.

Change-Id: If93c605863269056060b1585641feac167d95f25
Reviewed-by: Esa Törmänen <esa.tormanen@qt.io>
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
2024-03-19 12:34:11 +00:00
Leena Miettinen
9fa1dbcd3c Doc: Turn "Semantic Highlighting" into how-to topics
And move the general information to the Overview (or the Code
view docs in the QDS Manual).

Task-number: QTCREATORBUG-29361
Change-Id: Ib1d13f3d81d707691c84aa4241ed28662e2bc8ee
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2024-03-14 15:16:37 +00:00
Tim Jenssen
0416941fd1 CMake: introduce option BUILD_DESIGNSTUDIO
This change needs an update of the super repository

If you want to buid QtDesignStudio documentation no branding path
is necessary anymore:

cmake -DCMAKE_GENERATOR:STRING=Ninja -DWITH_DOCS=ON -DCMAKE_PREFIX_PATH:PATH=C:\Qt_online\6.5.3\msvc2019_64 -DBUILD_DESIGNSTUDIO=ON C:/dev/tqtc-qtc-super/qtcreator
cmake --build . --target html_docs

Task-number: QDS-9827
Task-number: QTCREATORBUG-24222
Change-Id: Ic779b6ab57c71c7f6fa53467bf1ba3ee17cab0ea
Reviewed-by: Tim Jenssen <tim.jenssen@qt.io>
2024-02-20 20:19:40 +00:00
Leena Miettinen
76dcc5463a Doc: Turn Editing MIME Types into a how-to topic
Add subheadings and move content around.

Task-number: QTCREATORBUG-29361
Change-Id: I4c1d8c8c7065a3f306e2a4a341bc546c62828903
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2024-01-30 10:44:39 +00:00
Jarek Kobus
96085f327b Coding rules: Add a note about avoiding sender() and QSignalMapper
Change-Id: Ifbc73b3c1e18484c692ee0e2a2999f2fe2e98f8b
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
Reviewed-by: hjk <hjk@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2024-01-10 11:25:49 +00:00
Leena Miettinen
e76ac2e98d Doc: Update instructions for writing Qt Creator and QDS docs
- Mention the new grouping of topics
- Mention that the TOC is now used to automatically generate
  navigation links in the Qt Creator Manual
- Link to QUIP 21 for instructions on using images
  (leave Qt Creator and QDS specific instructions and examples)
- Remove section about Qt Quick Designer docs, which are no longer
  built as part of the Qt Creator Manual
- Remove the example for configuring the docs for an external plugin
  because Fossil is now in qtcreator and Qt Application Manager will
  move there in v.13.0
- Fix broken links to Qt Creator Manual
- Add links to QDoc commands
- Add and remove screenshots
- Fix some language and style issues

Change-Id: I669a3bd5245140f6894bab3fec463766808f1b2a
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
2024-01-08 08:37:08 +00:00
Leena Miettinen
158058ca3b Doc: Reorganize the "Designing UIs" section
- Create how-to and reference topics.
- Move the short descriptions of topics to "IDE Overview".

Task-number: QTCREATORBUG-29361
Change-Id: I11a334de6151350ce993e4135828a3eecaabf308
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
2024-01-05 13:35:43 +00:00
Eike Ziller
a047ebba50 PluginManager: Add documentation for "SoftLoadable"
Change-Id: I542ffe892490ef796ad76a0afeac103a0c1e12f0
Reviewed-by: hjk <hjk@qt.io>
2023-12-12 14:03:55 +00:00
Eike Ziller
39927ff44d PluginManager: Add an "Deprecated" flag for plugins
For plugins that are still provided, but are no longer supported.
They are disabled by default and show a "unsupported" hint in the
plugin manager (similar to "experimental" plugins).

Change-Id: I6ad72fc0043900b5aa919c225ae94850d1d7a443
Reviewed-by: hjk <hjk@qt.io>
2023-12-12 14:03:47 +00:00
Leena Miettinen
3f9f249c0d Doc: Add a readme.md for using recolordocsicons.py
In preparation of moving the instructions for taking screenshots
from the Extending Qt Creator Manual to a QUIP.

Change-Id: I034185e7ab4878cf36766db1e9a6b8de5d2b3fed
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2023-11-20 08:58:50 +00:00
Tim Jenssen
1a3a8ecc96 Merge remote-tracking branch 'origin/qds/dev'
Change-Id: Id242ab4ca485527defdcc1555d204e12e50ddb7a
2023-09-14 17:37:24 +02:00
Leena Miettinen
6cf4b1a3cd Doc: Use hyphenated form of "command-line" where appropriate
That is where it precedes another noun, such as "options",
"arguments", or "tools".

Change-Id: Ic4c339084e7350fe737e499293a8f96c91c57fd7
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
2023-09-13 10:12:26 +00:00
Leena Miettinen
097cb17af4 Doc: Replace "Getting Help" with "How To"
Move the topics to either "How To: Read Qt documentation" or
"Reference", depending on their type.

Task-number: QTCREATORBUG-29361
Change-Id: Ifa46192f7a15a71e8d3454010f6b96764776f82b
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
2023-09-13 06:56:53 +00:00
Leena Miettinen
66fabd0c0d Doc: Turn some "Advanced Use" topics into how-to topics
Task-number: QTCREATORBUG-29361
Change-Id: Ie675e4d72ad524e0a7a4ba4adca8a477ff579d55
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2023-09-13 06:56:40 +00:00
Mats Honkamaa
781e9dd5e3 Doc: Unify product naming
Unify naming for Qt Online Installer and Qt Maintenance Tool. Ass macros for theses
as well.

Task-number: QTBUG-116573
Change-Id: I90247956300607b852a17df96aa667bf55805e36
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Qt CI Patch Build Bot <ci_patchbuild_bot@qt.io>
2023-09-12 16:22:28 +00:00
Eike Ziller
a419670ff5 Build: Change plugin json.in files to CMake style
They were still using variables in qmake style.
Directly use CMake variables in the json.in files and remove the no
longer needed escaping of quotes.

Adds a fatal message if it detects the old style in a .json.in file for
easier porting.

Change-Id: I8de88d8db2da55781f0e9d72eda03f943723188e
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Cristian Adam <cristian.adam@qt.io>
2023-07-25 13:21:16 +00:00
Leena Miettinen
a76f8cf4dc Doc: Change Extending Qt Creator Manual \page to index.html
It was extending-index.html to solve some issues that were
caused when generating the manuals from the same sources, but
those seem to have been solved. The name index.html was already
used at doc.qt.io for version 10.0.

Change-Id: I16c11d286107141f49cf28824cef998bd233d975
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org>
2023-07-20 08:43:04 +00:00
Eike Ziller
3f912c01fb Doc/Extending: Update "getting and building" page
qmake files were still referenced.
Do not focus on building Qt Creator, we ship a development package
nowadays which is preferred.

Change-Id: If209f48c0fcf4f8fbe87ecaddae826ad3a63c209
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
2023-07-05 06:10:57 +00:00
hjk
857f22e6c9 Coding-style: Mention extensions by plugins implementing callbacks
Change-Id: I03a8c1808e46a44c0c59aad1c5537a906442e5a7
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2023-07-03 11:44:34 +00:00
Leena Miettinen
e5e2d47d69 Doc: Add guidelines for writing tooltips
Task-number: QTCREATORBUG-29085
Change-Id: I4f4c8083348080c2e5880ee1ccbcbee14bd20906
Reviewed-by: hjk <hjk@qt.io>
2023-06-28 15:08:34 +00:00
Jarek Kobus
c28f40fff1 Spinner: Add some docs
Change-Id: Ia8717ac93c92e03d27fc4b8c93a32b7785ccc3e9
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: hjk <hjk@qt.io>
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
2023-06-22 08:22:09 +00:00
Jarek Kobus
6f6f6d3f97 Solutions: Add a common Solutions page
Add also The Tasking solution page. Add some hints into README.md file.

Change-Id: I4e355c95977d668fbc2f7bd286f9446e4e4b1f69
Reviewed-by: Jarek Kobus <jaroslaw.kobus@qt.io>
2023-06-15 14:58:42 +00:00
Leena Miettinen
c04a4a1ae0 Doc: Fix qdoc warnings
- Mark undocumented but existing functions with \c (instead of \l or \sa)
- Remove reference to functions I could no longer find
- Fix other broken links
- Fix reference to an image whose file format changed to WEBP
- Use {} instead of "" to mark alt text for images
- Add missing \a commands
- Add class name to a function name so that it can be found

Change-Id: I10655bb0356c7417ab0e14a3ce620930f4ee8349
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2023-05-30 08:13:53 +00:00
Leena Miettinen
e1a67c7cfb Doc: Exclude src/libs/utils/mimetypes2 from doc builds
It is copied from Qt.

Change-Id: Ia9a9f02abcb45d1f2981918259b8cc970c3165ca
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
2023-05-24 06:53:08 +00:00
Jarek Kobus
d8ed764611 TaskTree: Bring the documentation back
It vanished after recent move into Tasking lib.

Amends f84199f8b7

Change-Id: I561784c82285de41c2e29c257940678eeeccb5eb
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2023-05-22 09:51:51 +00:00
Leena Miettinen
77fa93ef0a Doc: Fix reference to an image that is now in WEBP format
Task-number: QTCREATORBUG-28778
Change-Id: I1d0b45781a1692384ec218d74f4f270b083916ed
Reviewed-by: Christian Stenger <christian.stenger@qt.io>
2023-03-24 08:11:57 +00:00
Eike Ziller
cace5a57f2 Plugins: Add documentation about testing
Add information about how to write plugin tests and how to integrate
unit tests.

Change-Id: I13721f03c4c55a265a93f71a7c4d892f3e53a6bb
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2023-02-28 15:42:48 +00:00
Eike Ziller
143835aea8 Coding style: Avoid optional::value()
Change-Id: Ic4769c6f9f016415e01ca5526f6730bc93c6ea81
Reviewed-by: Jarek Kobus <jaroslaw.kobus@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2023-02-23 13:33:53 +00:00
Jarek Kobus
ef731faa47 Coding style: Avoid empty round brackets in lambdas
Remove outdated rules.
Use QList instead of QVector.

Change-Id: I11ea6be09080ddccfdcfc3d09f79cbeff448659e
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: hjk <hjk@qt.io>
2023-02-23 12:05:22 +00:00
Eike Ziller
22a6b79f45 Coding style: Remove outdated section wrt nullptr
Ealier we state that nullptr should be used, and that is the current
policy.

Change-Id: Id462458f36893354a4f95e086d25a946f94b495e
Reviewed-by: hjk <hjk@qt.io>
2023-02-16 11:08:28 +00:00
Eike Ziller
7a2023f157 Coding style: Remove wrong compiler statement and merge C++ sections
The supported compiler are stated in the README, no sense in replicating
and maintaining that information here.

Back then it made sense to differentiate between "C++" and "advanced C+
+(11/14), but nowadays that separation is artificial, it all is "C++
features".

Change-Id: If67274566776ccd37bd20e925531405628edeb47
Reviewed-by: hjk <hjk@qt.io>
2023-02-16 11:08:11 +00:00
Jarek Kobus
78ae704d77 Utils: Enable internal documentation
Change-Id: I8531f7a85c8bee32a207f477e7ee9d3d9f14107c
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2023-02-09 07:37:45 +00:00
Kai Köhne
4e9c1d126c Replace GPL-3.0 with GPL-3.0-only
GPL-3.0 is deprecated by SPDX.

Change done by

 find . -type f -exec perl -pi -e 's/LicenseRef-Qt-Commercial OR GPL-3.0(?!-)/LicenseRef-Qt-Commercial OR GPL-3.0-only/g' {} \;

Change-Id: If316a498e3f27d2030b86d4e7743b3237ce09939
Reviewed-by: Lucie Gerard <lucie.gerard@qt.io>
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2023-01-10 08:05:04 +00:00
Eike Ziller
34aa8e9e19 PluginSpec: Add a "LongDescription" to plugin meta data
The EmacsKeys plugin had a long description with details on what it
does, which in principle is a good thing, but shouldn't be shown with
e.g. the -version command line argument.

Split the description in a short "Description" (name unchanged for
compatibility), and a possibly longer "LongDescription", using only the
first one for -version, and showing both in the plugin details.

Adapt the EmacsKeys plugin meta data.

Fixes: QTCREATORBUG-17312
Change-Id: I4a4abf51e5e19b71ee73edb14c6a897fbceaf916
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: David Schulz <david.schulz@qt.io>
2022-12-16 08:29:57 +00:00
Eike Ziller
ea5a050c5c Merge remote-tracking branch 'origin/8.0' into 9.0
Conflicts:
	src/plugins/mcusupport/mcusupportsdk.cpp
	src/plugins/qmldesigner/components/edit3d/edit3dwidget.cpp
	src/plugins/qmldesigner/components/materialbrowser/bundleimporter.cpp
	src/plugins/qmldesigner/components/materialbrowser/materialbrowserview.cpp

Change-Id: I9317da0fc1243b9ce6d87f577aa843c51f132ad7
2022-10-18 10:48:46 +02:00