+ 059b10f295 Doc: Check before including the \snippet from a .pro file
+ 7f0cc35d9c Examples: Fix minor bug in Tree Model Completer Example
+ 244c7bd193 Avoid conversion over RGBA64 for RGB32 LCD text blending
+ a381ba4220 Document version number of pixman
+ ff2a71e310 Doc: Move the literal code blocks to a separate file
+ 20ac20bcea Windows QPA: Fix missing accessibility info with WebEngineView
+ 689a1e186b QString: Fix snippet explaining "non-spaced numbered place markers"
+ 85f127cb04 Revise an incorrect QVulkanWindow doc note
+ 3bac18da8e Document SLJIT part of pcre2
+ 621ab8ab59 bmp image handler: check for out of range image size
+ e04b85b026 Doc: improve Mandelbrot example
+ bff307ab93 Fix XCB on endian mismatched client and server with SHM off
+ 45c1473847 Detect when we are at the sentence boundary
+ 49efea26a5 sqlite: Fix QSqlError handling when opening/closing database
+ 1511bfef52 Disable RGB64 backend for ARGB32 when it will be very slow
+ cb5c24fa26 Fix integer overflow in very long sections in ELF objects
+ 12c357bebb Document IAccessible2 version
+ 8aa9bb6d3f Clarify docs regarding the states of a QFutureWatcher with no future set
+ 4fc4f7b0ce Export qt_open64 from QtCore
+ 4b7ff8e98c Protect HSTS code for no-feature-settings build
+ 6948bf20a7 QSslContext: Use 0 instead of TLS_MAX_VERSION
+ e226b0f94a Modernize the "textdate" feature
+ b26cd68bf6 Modernize the "datestring" feature
+ 02663718a9 QHeaderView: Don't unhide hidden sections on layoutChanged()
+ f99e956d65 Add QT_REQUIRE_CONFIG(ssl) to pre-shared key authenticator
+ 5e64957ee4 Fix QCompleter popups preventing the application from exiting
+ 555a6b5d5d Modernize the "filesystemwatcher" feature
+ 857a0d4c51 Fix the /J option for MSVC project generation
+ 3ed8dc3788 Android: fix log output pattern
+ ef4ba0285f SSL: Don't write to closed socket or write to deallocated buffer
+ 94884246d4 QCommandLineParser: Ensure that an option text ends with a newline
+ caa598c843 Fix QUrl::matches for when removing authority parts (other than host)
+ b2b32d3147 fix HTML subset documentation is not very readable on smaller screens
+ c958fb8b48 zlib: Fix spelling of license
+ 5a295a1009 Scale seconds by a thousand to get milliseconds
+ ced34cb3d5 QDateTimeParser: avoid using an invalid hour by default
+ d8817ddde6 Use update() instead of repaint() when displaying a new message
+ 18ec0a8b09 Windows QPA: Fix WM_NCHITTEST not being sent to QAbstractNativeEventFilter
+ 04aeffbe8f Doc: Describe behavior of QSslConfiguration::caCertificates() on iOS
+ 92f42caff1 Fix ICE on QNX 6.6
+ 7146c9075c Fix DejaVu fonts URL
+ 836a2fb887 [macOS] Fix position of sheets when using unifiedTitleAndToolBarOnMac
+ ba0ff45109 Update the DNS public suffix list from publicsuffix.org
+ 4dc251879c Ssl: Fix contrived crash when calling resume
+ 091a386eaf Use native visual ID when creating GBM surfaces for KMS
+ dc5f9d0c31 Only use a translucent background if there is support for alpha
+ 0d7c049e44 Update bundled libpng to version 1.6.35
+ 0509383cf2 Bump copyright year in executable metadata
+ c593492d16 Modernize the "animation" feature
+ 4e7b58629a Modernize the "big_codecs" feature
+ 9c8ca26a48 Modernize the "codecs" feature
+ 3eebadc173 Modernize the "mimetype" feature
+ b7887f9b4f Linux: Remove our use of syscall() for statx(2) and renameat2(2)
+ fc4b0769a5 Fix pdf printing in static builds
+ 1cd2955173 Fix enum passed to QFontDatabase::findFont
+ 2624676b57 qmake: Remove the extra space before -MT
+ 7f60940fbe Re-disable statx() on Android
+ 6599c1f758 QPicture: fix crash for malformed picture
+ 44eeeb8e81 Upgrade PCRE2 to 10.32
+ 948f8ce2ec QWinEventNotifier: fix crash on application shutdown
+ 2708c6c11d OpenSSL: force the "1.0.0" soname when loading OpenSSL 1.0
+ 0cb44e2cfb Fix stylesheet example for QLineEdit:read-only code example
+ 72bedd49bf [cocoa] Disable offline renderers for dual AMD FirePro GPU
+ 509d566ec0 Don't block mouse events if the window is a Tooltip type
+ 38afa46c47 macOS: Only detect changes to the SDK version within the same developer dir
+ d2e0e416d4 Fix leaking QTabletEventPrivate instance
+ d4e937a628 xcb: Don't get initial screen rotation
+ 3b8075de3b Fix deleting of QSharedPointer internals in case QPointer loses the race
+ 1b9af84c1b Don't create an offscreen surface when not on the GUI thread
+ c9d18d4a9c eglfs_kms: initialize m_deviceListener
+ 67c66c4ea4 windows: Give up on SwitchableComposition
+ 033cc3403a mkspecs: use cross compile tools with LTCG
+ 9f2216667a Fix memory copy in QGIFFormat::disposePrevious()
+ b5d249f953 Update the floppy disk icon (save) to be physically correct
+ 825f988156 Modernize the "textcodec" feature
+ 9933511838 Fix typo in define. s/GL_FRAMEBUFFER_SRB/GL_FRAMEBUFFER_SRGB
+ 38b87cc4bb Doc: Clarify what samples() returns if not explicitly set
+ bdebc90c28 Bump version
+ dec7961709 QSyntaxHighlighter: Delay all highlights until first rehighlight
+ 9137691e74 Windows QPA: Fix crash showing QSystemTrayIcon's context menu with PROCESS_DPI_UNAWARE
Change-Id: Id50872011aff4f604d7444d7aa4799c1c61b45f6
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
Welcome to Qt 5
===============
Qt is a cross-platform application and user interface framework. It
consists of a number of software libraries and development tools.
Qt is developed as an open source project. It is available under both
open source and commercial licenses.
All information on Qt is available on the Qt Developer Network:
http://qt-project.org
Be sure to check out the release notes, which will list any known
problems or limitations of this version:
https://wiki.qt.io/Category:Release
Overview
--------
You can use the Qt 5 installation program to install the following components:
- Qt libraries, prebuilt for a particular development platform (operating system
and compiler)
- Qt Creator integrated development environment (IDE)
- Basic development tools, prebuilt for a particular development platform
- Documentation
- Qt in source code form (needed only if you want to build the framework and
tools yourself)
Install Qt libraries to develop or run applications that need the Qt runtimes or
to try out example applications built with Qt.
Qt Creator is designed to make Qt development easier, but you can also use a 3rd
party IDE (such as MS Visual Studio), or just an editor and command line, in
addition to basic Qt development tools (Qt Designer, Qt Assistant, qmlscene, and
so on).
Installing Qt 5
---------------
You can download Qt 5 from http://qt-project.org/downloads. The site provides
download links for all supported development platforms.
Start the installation program like any executable on the development platform.
On Linux, you might first have to make the installation program executable.
Select the components that you want to install and follow the instructions of
the installation program to complete the installation.
Use the Maintenance Tool under <install_dir> to remove all installed
components.
Directory Structure
-------------------
The default top-level installation directory is the directory "Qt<version>" in
your home directory, but you can specify another directory (<install_dir>). On
Windows, however, the default top-level installation directory is "C:\Qt\Qt<version>".
Each Qt version is installed in the <install_dir>/<version> directory. This directory
contains subdirectories for the Qt libraries (<compiler>) and sources (Src).
The <compiler> directory contains subdirectories for development tools (bin) and
examples.
Starting Development Tools
--------------------------
You can start Qt Creator directly after the installation by selecting the option
on the last page of the installation program. You can start most of
the development tools, such as GUI designers, compilers, and debuggers
directly from Qt Creator. You can also access the installed documentation and
example applications from Qt Creator.
The development tools are located in the directory
<install_dir>/<version>/<compiler>/bin. You can run them from Qt Creator or from
the command line. You can also launch some of them as standalone applications.
For example:
- Qt Assistant, the Qt documentation reader
- Qt QML Scene, the viewer for Qt Quick 2 files
- Qt QML Viewer, the viewer for Qt Quick 1 files
and - Qt Designer, the GUI designer for Qt widgets-based applications
You can use Qt Creator to develop with other Qt versions as well:
http://qt-project.org/doc/qtcreator-2.6/creator-project-qmake.html
Running Example Applications
----------------------------
You can open most example applications in the Qt Creator Welcome mode to build
and run them. Additional examples can be opened by browsing
<install_dir>/<version>/<compiler>/examples.
Building Qt 5 from Source
-------------------------
See <install_dir>/<version>/src/README and
http://wiki.qt.io/Building_Qt_5_from_Git
for instructions on building Qt from source.
Developing Qt Applications
--------------------------
To develop a Qt application, you need to set up a project. Qt Creator contains
wizards that guide you step-by-step through the project creation process. The
wizards prompt you to enter the settings needed for a particular type of project
and create the necessary files for you. To start, select File > New File or
Project.
The wizards create projects that use the Qt build tool, qmake. It is a
cross-platform system for build automation that helps simplify the build process
for development projects across different platforms. You can modify the build
and run settings for qmake projects in the Qt Creator Projects mode.
Qt Creator provides support for building, running, and deploying Qt applications
for different target platforms, or using different compilers, debuggers, or
Qt versions. Kits define the tools, device type and other settings to use when
building and running your project.
The Qt 5 installation program adds the installed Qt version
(<install_dir>/<version>/<compiler>/bin/qmake) to Qt Creator and creates a kit
that specifies the installed Qt version and compiler. To use the kit, add it for
your project in the Qt Creator Projects mode. Then select the kit in the Kit
selector before you build or run the project.
To compile C++ Qt applications by some other means, add
<install_dir>/<version>/<compiler>/include to your build tool's search path
for include files, and <install_dir>/<version>/<compiler>/lib to the search
path for libraries.
Want to Know More?
-------------------
Much more information is available at:
- http://qt-project.org/resources/getting_started
- http://qt-project.org/doc/
- http://qt-project.org
We hope you will enjoy using Qt!
- The Qt developers @ qt-project.org
08de243eaa