summaryrefslogtreecommitdiffstats
path: root/doc/global
Commit message (Collapse)AuthorAgeFilesLines
* Doc: Fix path of qt-cmake on WindowsKai Köhne5 days1-1/+1
| | | | | | | | Path changed in Qt sometime before 6.8. Pick-to: 6.10 6.9 6.8 Change-Id: I5335d0eed1428801bed77e762b82d69ffb2437f8 Reviewed-by: Joerg Bornemann <[email protected]>
* Android: update to Gradle 8.14.2 and AGP 8.10.1Assam Boudjelthia2025-06-281-2/+2
| | | | | | | | | | | | | Update to latest versions for Gradle: * Gradle 8.12 -> 8.14.0 * Android Gradle Plugin 8.8.0 -> 8.10.1. [ChangeLog][Third-Party Code] Updated Gradle to 8.14.1 and AGP to 8.10.1. Task-number: QTBUG-137782 Change-Id: Ifbc808e18412f6e2e45612612d36a1f9bf57c1a9 Reviewed-by: Ville Voutilainen <[email protected]>
* Doc: Adjust styling of QML property signatures in offline docsTopi Reinio2025-06-112-0/+8
| | | | | | | | | | | | | | | | | | | | | Recent changes in QDoc's output for QML type reference pages included rearranging the `extra synopsis` element, i.e, read-only, since, and deprecation information for properties. As a result, the existing CSS for the offline documentation caused some elements to be rendered on top of each other when using the qlitehtml- based backend in Qt Assistant and Qt Creator. To fix the layout, set a fixed width for the table elements that are used to display the properties, property groups, and methods. This change brings the style of QML reference pages closer to that of C++ reference, where signatures also have a fixed width. Pick-to: 6.10 6.9 6.8 Fixes: QTBUG-136990 Change-Id: I72adbeaca46cd9dd99c54368257268dc8db6bfdc Reviewed-by: Paul Wicking <[email protected]> Reviewed-by: David Boddie <[email protected]>
* Doc: Update the HTML tab configVenugopal Shivashankar2025-05-301-1/+1
| | | | | | | | | - Added translat='no' attribute to input and style - Added the missing linefeeds Change-Id: I51ffe1bd0eb8d06bab7a7eedcd862e88fe794588 Pick-to: 6.9 6.8 Reviewed-by: Topi Reiniö <[email protected]>
* Doc: Enable automatic linking to sources on code.qt.ioTopi Reinio2025-05-271-0/+3
| | | | | | | | | | | | Since 6.10, QDoc is capable of generating links to the declaration in the source code for each documented C++ API entity in their `Detailed description`. Add the required configuration to enable this feature in online documentation builds. Change-Id: Iaafabc5aea50a6cd72549bb1c04007bb4de498ca Reviewed-by: Paul Wicking <[email protected]>
* Doc: Update external links to Qt Creator docs to 16.0.0 levelLeena Miettinen2025-05-261-8/+140
| | | | | | | | | | Mostly additions, but some title changes, too. Pick-to: 6.8 6.9 Change-Id: Ic911183c1ad77f68f2fc958d82456010b8ce8201 Reviewed-by: Mats Honkamaa <[email protected]> Reviewed-by: Esa Törmänen <[email protected]> Reviewed-by: Inkamari Harjula <[email protected]>
* Revert "Doc: Modify \tabcontent..\endtabcontent macros"Topi Reinio2025-04-281-4/+4
| | | | | | | | | | | | | | | | | | | | | This reverts commit 5c0b08a20dd14f7fd8632495aa911fe427f58f7f. After the original commit, DocBook support for tabbed content was introduced (as format-specific macros). This means that the original macros will also have to be HTML-format specific, as macros cannot have both default and format-specific variants defined. In addition to reverting, add linefeeds to (end)tabcontent.HTML macros to solve the same problem that the reverted commit did. In passing, fix an issue with the tabcontent.DocBook macro; it takes a single argument, therefore the placeholder for the value must be \1. Change-Id: I90ed6bc37d70c10754b3b810198ac44fcd189766 Reviewed-by: Paul Wicking <[email protected]> Reviewed-by: David Boddie <[email protected]>
* Implement \tabs for DocBookThibaut Cuvelier2025-04-031-2/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The existing implementation only works for online HTML and the workaround generates nonsensical DocBook that not a single processor could parse. This implementation is not ideal, but gives enough information for processors to do their job (i.e. the tab title and contents are uniquely linked, the tabs in a group are related). Unaware processors still render useful information to the user thanks to links. The ideal presentation would use a container such as `formalgroup` for the tabs, but there is no notion of tab in DocBook. The missing part in this patch is allowing all uses of tabs with DocBook; they are still guarded by `\if defined(onlinedocs)`. For instance, this change updates `porting-to-ios.xml` from: ```xml <db:listitem…> <db:para>If your application uses imports or plugins that depend on special Qt modules, these Qt modules should be added to your build configuration file. For example, if your application uses the Qt Multimedia import in QML, you should add the following to your .pro or CMakeLists.txt file: </db:para> <db:section xml:id="using-cmake"> <db:title>Using CMake</db:title> <db:programlisting language="cpp" role="bad">find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(my_project PRIVATE Qt6::Multimedia) </db:programlisting> </db:section> <db:section xml:id="using-qmake"> <db:title>Using qmake</db:title> <db:programlisting language="cpp" role="bad">QT += multimedia </db:programlisting> <db:para>In Qt for iOS, everything is compiled statically and placed into the application bundle. The applications are &quot;sandboxed&quot; inside their bundles and cannot make use of shared object files. Because of this, also the plugins used by the Qt modules need to be statically linked. To do this, define the required plugins using the <db:link xlink:href="qmake-variable-reference.xml#qtplugin">QTPLUGIN</db:link> variable.</db:para> </db:section> ``` to: ```xml <db:listitem…> <db:para>If your application uses imports or plugins that depend on special Qt modules, these Qt modules should be added to your build configuration file. For example, if your application uses the Qt Multimedia import in QML, you should add the following to your .pro or CMakeLists.txt file: </db:para> <db:bridgehead xml:id="tab-cmake" renderas="sect5" role="tabbed checked tab-group_build-ios-app" xlink:href="#tab-cmake_contents">CMake</db:bridgehead> <db:bridgehead xml:id="tab-qmake" renderas="sect5" role="tabbed checked tab-group_build-ios-app" xlink:href="#tab-qmake_contents">qake</db:bridgehead> <db:sidebar xml:id="tab-cmake_contents"> <db:programlisting language="cpp" role="bad">find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(my_project PRIVATE Qt6::Multimedia) </db:programlisting> </db:sidebar> <db:sidebar xml:id="tab-qmake_contents"> <db:programlisting language="cpp" role="bad">QT += multimedia </db:programlisting> </db:sidebar> ``` Change-Id: I63f3e8d03a5f4ee52e7c67971d14d4497dd78cb8 Reviewed-by: Paul Wicking <[email protected]>
* Doc: Update copyright year in the global configurationTopi Reinio2025-03-275-5/+5
| | | | | | | Pick-to: 6.9 6.8 6.5 Fixes: QTBUG-134788 Change-Id: I118d15df4e644dbed1a3de5efdb0b5d5a0e11c20 Reviewed-by: Andreas Eliasson <[email protected]>
* Doc: Drop "Unknown base" spurious regex from configPaul Wicking2025-03-261-2/+1
| | | | | | | | | | | | | This regex pattern instructs QDoc to not include the matching warning in its warning count. The warning has changed to a report, however, which won't count towards the warning count in any case, so the regexp isn't needed anymore. Task-number: QTBUG-131459 Task-number: QTBUG-134219 Pick-to: 6.9 6.8 Change-Id: Ic461c63b62bd25fb2d1f3b485c46db55e52e20cf Reviewed-by: Topi Reiniö <[email protected]>
* Docs: Replace supported Android NDK r26b with r27cNicholas Bennett2025-03-251-2/+2
| | | | | | | | | | Updated the macros in qtbase to propagate changes to other doc projects. A separate change has been raised to handle multiple supported ndks in prior LTSs Task-number: QTQAINFRA-6479 Change-Id: Ic052f1b6b80473cc33c7f2be23049969d3cec0ee Reviewed-by: Assam Boudjelthia <[email protected]>
* Doc: Don't add padding to div that wraps the pre elementAndreas Eliasson2025-03-141-2/+2
| | | | | | | | | | | | The current style adds padding to non-pre elements, such as any p or div elements. The final html adds a wrapping div with a .pre class that also gets padding added to it. This patch removes the padding from this wrapping div. Fixes: QTBUG-133710 Pick-to: 6.9 6.8 6.5 Change-Id: I6411dcda9cfed5f0f82d8bd9ea8dc809b1a3b4d6 Reviewed-by: Venugopal Shivashankar <[email protected]>
* Doc: Use Qt Design System colors also in help CSSLeena Miettinen2025-03-046-29/+19
| | | | | | | | | | - Replace colors in offline-dark.css - Do not use the note and attention icons in offline templates Task-number: QTBUG-133761 Pick-to: 6.9 6.9.0 6.8 Change-Id: I55e81d6c3887764542e23c8f85f4d46e273b3885 Reviewed-by: Topi Reiniö <[email protected]>
* Long live \constraints!Marc Mutz2025-02-281-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | We have divergence in the way we document function, operator and constructor constraints. About half use \note, while the other doesn't. Some say "if and only if" while others say just "participates only if". So add a qdoc macro, \constraints, to semantically mark up these constraints. It expands to a section titled `Constraints`, and uses a predefined sentence (prefix) for constraints. Documentation for constraints is moved to the end of the comment blocks to separate them from the rest of the text. Apply them to all the standard-ish constraint documentation blocks (grepped for "participate"). I didn't look for other, one-off, ways documentation authors may have documented constraints, but I'm also not aware of any. Re-wrap lines only if the result fits into a single line. As a drive-by, drop additional "if"s, as in "only if X and -if- Y" to make the texts work with the `Constraints` section. Fixes: QTBUG-106871 Pick-to: 6.9 6.8 6.5 Change-Id: I18c2f9f734474017264e49165389f8c9c7f34030 Reviewed-by: Kai Köhne <[email protected]> Reviewed-by: Paul Wicking <[email protected]> Reviewed-by: Volker Hilsheimer <[email protected]>
* Docs: Create \Q4A macro for "Qt for Android" and replace instancesNicholas Bennett2025-02-282-1/+2
| | | | | | | | | | | | | | "Android" is trademarked and needs to be referenced in a certain way. The following steps were taken: -Created qdoc macro. -Updated "Qt Android" and "Qt for Android" to use \Q4A in qdoc files. The macro will need to be adopted in all documentation projects. Task-number: QAA-2836 Pick-to: 6.9 6.8 6.5 Change-Id: I4b52247a4ed52047242a06404e6d3aa19de9c16c Reviewed-by: Assam Boudjelthia <[email protected]>
* Android: update Android SDK to version 35.0.1Rami Potinkara2025-02-261-1/+1
| | | | | | | | | | | | | | | This patch updates the macro AndroidBuildToolsVer to version 35.0.1. The version 35.0.1 is used elsewhere, see b49421a984ac2b203b7995f3787b67184c990089 Amends: 9b475eadfcf04194a094454f65295c3a456000a4 Task-number: QTBUG-129462 Pick-to: 6.9 6.8 6.5 Change-Id: Ic15e12c563fa3d16315daa13b6f6b6ef19535954 Reviewed-by: Nicholas Bennett <[email protected]>
* Remove references to the deprecated QtCharts moduleTomi Korpipaa2025-02-241-1/+0
| | | | | | | Task-number: QTBUG-133659 Change-Id: I3220c4f63c5ae00dbd1786daf8d09c07d8139a4c Reviewed-by: Miikka Heikkinen <[email protected]> Reviewed-by: Volker Hilsheimer <[email protected]>
* Doc: Ignore 'Unknown base <type> for QML type' warnings for nowTopi Reinio2025-02-181-1/+2
| | | | | | | | | | | | | These warnings are false positives when testing in the CI when a documentation module containing the base type is meant to be loaded as a dependency; In the CI, the .index files for doc dependencies are not available so we see this warning. Ignore these warnings for now in the global documentation config. Pick-to: 6.9 6.8 Change-Id: Ic1711bf7389e9f9d4a04e3b72b2c9f8b25539357 Reviewed-by: Paul Wicking <[email protected]>
* Android: update Android 15 SDK 35 to docsRami Potinkara2025-02-141-4/+4
| | | | | | | | | | | | | This patch updates the macros for Android maxApiVer, AndroidMaxVer, AndroidPlatformVer, AndroidBuildToolsVer variables to reflect Android 15 Task-number: QTBUG-129462 Pick-to: 6.9 6.8 6.5 Change-Id: Ia6edfa7811dd8c98a0a99c10d8781aa09384bdfa Reviewed-by: Assam Boudjelthia <[email protected]> Reviewed-by: Nicholas Bennett <[email protected]>
* Remove references to the deprecated QtDataVisualization moduleTomi Korpipaa2025-02-131-3/+0
| | | | | | Task-number: QTBUG-133658 Change-Id: Ibf8123ffacf6fc4cc02817a5d2ac380ff317f815 Reviewed-by: Volker Hilsheimer <[email protected]>
* Fix or remove broken and outdated external links in qtbase documentationDavid Boddie2025-02-081-182/+72
| | | | | | Change-Id: Ia78b3b16b89ab3f80d990b6e338b4a0f294ab1ed Pick-to: 6.8 6.9 Reviewed-by: Topi Reiniö <[email protected]>
* Doc: Clean up output for tabbed content macroTopi Reinio2025-02-081-1/+1
| | | | | | | | | | | Insert line breaks in the content the \tab macro expands to. This produces nicer-looking html and also fixes an issue related to the post-processing done to the generated files. Fixes: QTWEBSITE-1202 Pick-to: 6.9 6.8 Change-Id: If4e7f7242f8687ef84ad715744653c4167cf907f Reviewed-by: Andreas Eliasson <[email protected]>
* Doc: Update external link to freedesktop.org trash specificationKai Köhne2025-01-271-1/+1
| | | | | | | | | Old link gives a 404 Pick-to: 6.9 Change-Id: I3e528a29a6ed2d0d97c3fcf1cf11c441a2882415 Reviewed-by: Volker Hilsheimer <[email protected]> Reviewed-by: Jaishree Vyas <[email protected]>
* Doc: Fix link to RFC 8259Kai Köhne2025-01-271-5/+5
| | | | | | | | | | | | Fixes qdoc warning corelib/doc/src/json.qdoc:22: (qdoc) warning: Can't link to 'RFC 8259' Amends 65fda988e92e Pick-to: 6.9 Change-Id: I62c1cf05366cd13180d21d7b4cbf68c0c0f48e1d Reviewed-by: Johannes Grunenberg <[email protected]> Reviewed-by: Thiago Macieira <[email protected]>
* Doc: Modify \tabcontent..\endtabcontent macrosTopi Reinio2025-01-091-2/+2
| | | | | | | | | | | | | | | QDoc markup following the \tabcontent macro should start a new paragraph. As HTML-specific macros are injected directly into the output, QDoc's doc parser is not aware that the macro should start a new paragraph. Turn the macros into generic, non-format-specific macros, expanding to \div and \enddiv commands that wrap the tab content. Pick-to: 6.9 6.8 6.5 Change-Id: Ie8313af391b1a38ef74592acac3198fef5b7b310 Reviewed-by: Venugopal Shivashankar <[email protected]>
* Android: document androidtestrunner toolAssam Boudjelthia2024-12-191-0/+4
| | | | | | | | | Add documentation and usage of androidtestrunner tool. Pick-to: 6.9 6.8 Fixes: QTBUG-84330 Change-Id: I03aa67ebf0ba807f20595547f2598d905080a878 Reviewed-by: Nicholas Bennett <[email protected]>
* Doc: Fix usage instructions for the \youtube macroTopi Reinio2024-12-181-1/+2
| | | | | | | | | | | The example configuration included a space character that caused a syntax error parsing the .qdocconf. Replace the hardcoded qhp `QtDoc` project name with a placeholder. Pick-to: 6.9 6.8 Change-Id: Iadf3a50e030f02182016ed9832f4f59d29f82c57 Reviewed-by: Topi Reiniö <[email protected]>
* Doc: Set trademarks page in global configurationTopi Reinio2024-12-091-0/+3
| | | | | | | | | | | | | The new \tm command appends a trademark symbol and links to the trademark documentation page if `navigation.trademarkspage` variable is set. As we have such a page in qtdoc repository, set the variable in the global configuration. This works as all Qt module docs have a dependency to the `qtdoc` documentation set. Pick-to: 6.8 Task-number: QTBUG-124393 Change-Id: Iabc6e7e5afe5114eac79947f0feb512458f1c4da Reviewed-by: Topi Reiniö <[email protected]>
* Docs: Fix broken layout on landing page (dark offline style)Eike Ziller2024-12-061-5/+3
| | | | | | | | | | | | | | The style was already fixed for the "light" offline style, but the dark offline style was missed. Amends d39c9d37ade8d74e534952e47061168be8904fc7 Task-number: QTBUG-129178 Fixes: QTBUG-131950 Pick-to: 6.8 Change-Id: I4f005cbe1945b8a973fb7bf77fb56b4d59d96b9c Reviewed-by: Paul Wicking <[email protected]> Reviewed-by: Kai Köhne <[email protected]>
* Create qdoc macros for C++ class docs 2.1: qHash()Marc Mutz2024-11-271-0/+55
| | | | | | | | | | | | | | | | | | | | | | | | | | Add a family of qdoc macros to document the various qHash() overloads we have. This patch does not change the \relates of the qHash() functions, they remain as inconsistent as they have been. Created QTBUG-129815 to clean things up. Since this author expects the \relates to change in the future, there are different \qhash commands, and all except \qhashbuiltin take the class name as an argument, for use in a centrally-choreographed fix for QTBUG-129815. As drive-by's, fix: - missing documentation about Key having to support qHash() in the associative Qt containers - drop noexcept and default arguments from \fn lines that needed to have their argument names changed - move the QStringView overload from qhash.cpp to qstringview.cpp (as it \relates to the former) Fixes: QTBUG-129574 Pick-to: 6.8 6.5 Change-Id: I8e8c2edc27422cbe5823f56baf3a24d7f7050836 Reviewed-by: Ivan Solovev <[email protected]> Reviewed-by: Jaishree Vyas <[email protected]>
* Remove unusable Q_OBJECT qdoc macroKai Köhne2024-11-191-1/+0
| | | | | | | | | | | | | Commit e2ff9e3b9957 was adding Q_OBJECT as a qdoc macro to allow to mask Q_OBJECT calls that are part of the documentation. Anyhow, while qdoc does allow the underscore in the _definition_ of macros, it doesn't allow it for the _invocation_. The questionable places should rather use snippet files. Fixes: QTBUG-130799 Pick-to: 6.8 Change-Id: I13bac0334b67ba7072946ab7d3f34c7a304c3f84 Reviewed-by: Paul Wicking <[email protected]>
* Add new icons for the tools doc front page templateInkamari Harjula2024-11-113-0/+0
| | | | | | | Icons folder-32x32.png, paste_general-32x32.png, and web-32x32.png added. Change-Id: I3b744f38a8654874a127eac6a161f38e52287ac6 Reviewed-by: Leena Miettinen <[email protected]>
* Create qdoc macros for C++ class docs 1.2: member-swap(), simplified phrasingMarc Mutz2024-11-081-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | We have some patterns for how to document certain functions, but we also vary the sentences a lot, and you have to look up one documentation piece and copy it, essentially. If we ever want to change them, we end up with shotgun surgery. So apply DRY to the documentation and start a collection of macros to help with repetitive C++ class documentation tasks. The first macro is for member-swap(), and this second patch is for documentation that used the simplified phrasing ("Swaps this X with \a other."), which this patch adopts as the text for \memberswap, too, because it doesn't repeat the macro argument, making it easier to find a grammatically-fitting argument than in the traditional phrasing. This doesn't change the documentation, except as follows: * standardizes on simpified instead of traditional phrasing for docs that already use the \memberswap macro * adds the "very fast and never fails" blurb, if it was missing * changes the function's argument name to `other`, as required by the macro. Task-number: QTBUG-129573 Pick-to: 6.8 6.7 6.5 6.2 Change-Id: I1123e783ce0da76c5997ff74007d77504ac5b334 Reviewed-by: Topi Reiniö <[email protected]> Reviewed-by: Ivan Solovev <[email protected]>
* Create qdoc macros for C++ class docs 1.1: member-swap(), traditional phrasingMarc Mutz2024-11-052-0/+16
| | | | | | | | | | | | | | | | | | | | | | | | | We have some patterns for how to document certain functions, but we also vary the sentences a lot, and you have to look up one documentation piece and copy it, essentially. If we ever want to change them, we end up with shotgun surgery. So apply DRY to the documentation and start a collection of macros to help with repetitive C++ class documentation tasks. The first macro is for member-swap(), and the first patch is for documentation that used the traditional phrasing ("Swaps the X \a other with this X."). This doesn't change the documentation, except as follows: * adds the "very fast and never fails" blurb, if it was missing * changes the function's argument name to `other`, as required by the macro. Task-number: QTBUG-129573 Pick-to: 6.8 6.7 6.5 6.2 Change-Id: Ib494bd218334724b3b43796ba6f71fb52b83aa94 Reviewed-by: Ivan Solovev <[email protected]>
* Docs: Broken layout on landing page (offline style)Alexei Cazacov2024-09-261-5/+3
| | | | | | | | | | | | | | This commit fixes the broken layout. Wrapping the divs of col-1 (content) and col-2(sidebar) classes with a container with `display:flex` does the job. Fixes: QTBUG-129178 Pick-to: 6.8 Change-Id: I6867b178e5a1acf6a4fbd5302a857e5f3ca0a62f Reviewed-by: Paul Wicking <[email protected]> Reviewed-by: Kai Köhne <[email protected]> (cherry picked from commit d39c9d37ade8d74e534952e47061168be8904fc7) Reviewed-by: Qt Cherry-pick Bot <[email protected]>
* Doc: Drop parentheses and fifth macro argument in offline '\grid'Paul Wicking2024-09-201-1/+1
| | | | | | | | | | The parenthesis ends up without content, and that looks confusing and broken in e.g. Qt Assistant. Fixes: QTBUG-120151 Pick-to: 6.8.0 6.8 Change-Id: Ib616741bc0463e8bece481c2a37cd7c3992921ab Reviewed-by: Topi Reiniö <[email protected]>
* Doc: Pad text and pre code blocks in tabsAndreas Eliasson2024-09-201-3/+3
| | | | | | | | | Use the pre element selector, not the .pre class selector to add correct padding to pre code blocks and non-code blocks. Pick-to: 6.8 6.7 6.5 6.2 Change-Id: I14886f44597354c81840a866c75caa62387a7375 Reviewed-by: Tor Arne Vestbø <[email protected]>
* Doc: Minor update to global configurationPaul Wicking2024-09-171-1/+5
| | | | | | | | | QDoc now has support for a configuration variable, `productname`, the value of which QDoc's `\since` command prepends to version strings. Task-number: QTBUG-128911 Change-Id: I03a90764c5886174e2863f50a8e30d2316f02fb5 Reviewed-by: Topi Reiniö <[email protected]>
* Doc: Add a template for a tool documentation front pageLeena Miettinen2024-09-1112-0/+116
| | | | | | | | | Change-Id: I4f8c1731dd8ab7a5f32e5580e45ea1fafdc08960 Reviewed-by: Venugopal Shivashankar <[email protected]> Reviewed-by: Inkamari Harjula <[email protected]> Reviewed-by: Esa Törmänen <[email protected]> Reviewed-by: Teea Põldsam <[email protected]> Reviewed-by: Safiyyah Moosa <[email protected]>
* Android: bump AGP to 8.6.0 which supports Android 15Assam Boudjelthia2024-09-091-1/+1
| | | | | | | | | | | | | | AGP 8.5.2 still throws a warning about not being tested with Android 15 builds, now 8.6.0 is released and doesn't have the warning. Amends b5d8552f2baab56457d3f39f6b2915c72447b702. Pick-to: 6.8 Fixes: QTBUG-128648 Task-number: QTBUG-126061 Change-Id: I3d7a4c9c184e1a81f0ebb9431a6e3ca9706d19e9 Reviewed-by: Ville Voutilainen <[email protected]>
* Android: upgrade to Gradle 8.10 and AGP 8.5.2Assam Boudjelthia2024-08-251-2/+2
| | | | | | | | | | | | | | | | | | | | | | Bump Gradle version to the latest of 8.10 and Android Gradle Plugin to 8.5.2 which is used by latest stable Android Studio Koala. AndroidX core depenedency doesn't need an update as the latest stable is still 1.13.1. [*] https://developer.android.com/build/releases/gradle- plugin#compatibility [*] https://developer.android.com/build/releases/gradle-plugin#updating- gradle [*] https://github.com/gradle/gradle/releases/tag/v8.10.0 [*] https://developer.android.com/jetpack/androidx/releases/core [ChangeLog][Third-Party Code] Updated Gradle to 8.10 and AGP to 8.5.2. Pick-to: 6.8 6.7 Fixes: QTBUG-126061 Change-Id: I2178915776f7de60a0ca04826b7cee3e120096b3 Reviewed-by: Mårten Nordheim <[email protected]>
* Doc: Fix issues in print media type in offline stylePaul Wicking2024-08-211-8/+1
| | | | | | | | | | | | | | | | | | | | | | | | When generating HTML output, QDoc references CSS styles that control the visual appearance. For a standard build of Qt's documentation (a 'local' build, if you will), an "offline" style is the default. This style sheet is maintained in `qtbase.git`. This style is not particularly well maintained, as it is not the style in use for documentation published to `doc.qt.io`. As such, some issues where found as a side-effect of other work. In particular, an ill-placed background image in the `@media print` CSS instructions was found in the print dialogue from locally generated content. While validating the fix, it became clear that the `toc` CSS class was moved into an obstructing position in the same media type. Change the `@media print` definition such that: - The `toc` class is hidden entirely. Task-number: QTBUG-124162 Fixes: QTBUG-128205 Pick-to: 6.8 Change-Id: Ic427036a698d7fc0e07e9190289e5d2c196885d9 Reviewed-by: Andreas Eliasson <[email protected]>
* Doc: Fix Qt Creator link issuesLeena Miettinen2024-08-051-1/+1
| | | | | Change-Id: I828e2d48a4a332ad48d11fe81fee7e334960bb74 Reviewed-by: Topi Reiniö <[email protected]>
* Doc: Update \externalpage entries for Qt Creator documentationLeena Miettinen2024-08-022-216/+1150
| | | | | | | | | | - The docs were restructured in v. 13.0 and 14.0, so most headings changed, some topics were removed and lots of topics were added - Use the macro \QC - Fix the broken links in qtbase Change-Id: Ic173a3e9a1c80322162c3feb277098de2a9f1cc6 Reviewed-by: Topi Reiniö <[email protected]>
* Doc: Fix broken linksSafiyyah Moosa2024-06-261-1/+6
| | | | | | | | | | | | | | | | | This commit fixes: Broken URL (404): 'https://doc.qt.io/qtcreator/creator-autotest.html' from qtest-overview.html https://doc.qt.io/qtcreator/creator-autotest.html is replaced with https://doc.qt.io/qtcreator/creator-how-to-build-and-run-tests.html. Broken URL (404): 'http://www.opengl.org/wiki/Tessellation_Shader' from qopenglshaderprogram.html 'http://www.opengl.org/wiki/Tessellation_Shader' is replaced with https://www.khronos.org/opengl/wiki/Tessellation Task-number: QTBUG-126281 Fixes: QTBUG-126502 Pick-to: 6.8 6.7 6.5 Change-Id: Ifda1258a6500adcfa3fe861135ab98082ed2df10 Reviewed-by: Topi Reiniö <[email protected]>
* DocBook: indicate more clearly what a YouTube video isThibaut Cuvelier2024-06-231-1/+2
| | | | | | | | | | The previous description was too bare bones and did not allow further processing of the file. The new implementation gives more information and is consistent with what the standard xslTNG style sheets expect (https://github.com/docbook/xslTNG/blob/2.2.0/src/test/resources/xml/mo-1/preface.xml). Previous versions of the style sheets do not support video embedding. Change-Id: I1604858b6ad6254c4006470521a30cc0acd7b136 Reviewed-by: Topi Reiniö <[email protected]>
* Doc: Add macros for generating a grid structure of itemsTopi Reinio2024-06-212-0/+61
| | | | | | | | | | | | | | | These macros generate a a three-column grid of items in online documentation. These make for a clutter-free and more visually pleasing result in many cases, compared to a standard \table layout. For compatibility reasons, these macros continue to output a table structure in offline documentation builds. Task-number: QTWEBSITE-1144 Change-Id: Iab994b383f488dbd225c6a04d64cf41e2dbb20e9 Reviewed-by: Paul Wicking <[email protected]>
* Android: Update Gradle to 8.7 and Android Gradle Plug-in (AGP) to 8.4.0Rami Potinkara2024-05-241-2/+2
| | | | | | | | | | Updated Gradle to 8.7 Updated AGP to 8.4.0 Updated same versions in examples and docs macros Task-number: QTBUG-113383 Change-Id: Ib2e841f2e57e576c5d689a208a275ce5e9e4b80f Reviewed-by: Assam Boudjelthia <[email protected]>
* Android: bump min supported SDK to 28 (Android 9)Assam Boudjelthia2024-05-231-2/+2
| | | | | | | | | | | Bump the minimum supported Android API from 23 to 28 i.e. Android Oreo 9. This is done to focus more and more on recent versions. Fixes: QTBUG-125023 Task-number: QTBUG-124890 Change-Id: I4d510b771f413e5711dd44de454211e019c63db6 Reviewed-by: Heikki Halmet <[email protected]>
* Docs: Correct Android ABI string in build documentationNicholas Bennett2024-05-201-1/+1
| | | | | | | | Changed arm64-v8 to arm64-v8a. Pick-to: 6.7 Change-Id: I8ee5a5591bc22c28422643ab0d462b0638624d8c Reviewed-by: Assam Boudjelthia <[email protected]>