summaryrefslogtreecommitdiff
path: root/src/websockets/doc/src/index.qdoc
diff options
context:
space:
mode:
Diffstat (limited to 'src/websockets/doc/src/index.qdoc')
-rw-r--r--src/websockets/doc/src/index.qdoc96
1 files changed, 36 insertions, 60 deletions
diff --git a/src/websockets/doc/src/index.qdoc b/src/websockets/doc/src/index.qdoc
index 81a2cb4..e3fce1e 100644
--- a/src/websockets/doc/src/index.qdoc
+++ b/src/websockets/doc/src/index.qdoc
@@ -1,29 +1,5 @@
-/****************************************************************************
-**
-** Copyright (C) 2013 Kurt Pattyn <pattyn.kurt@gmail.com>
-** Contact: https://www.qt.io/licensing/
-**
-** This file is part of the documentation of the Qt Toolkit.
-**
-** $QT_BEGIN_LICENSE:FDL$
-** Commercial License Usage
-** Licensees holding valid commercial Qt licenses may use this file in
-** accordance with the commercial license agreement provided with the
-** Software or, alternatively, in accordance with the terms contained in
-** a written agreement between you and The Qt Company. For licensing terms
-** and conditions see https://www.qt.io/terms-conditions. For further
-** information use the contact form at https://www.qt.io/contact-us.
-**
-** GNU Free Documentation License Usage
-** Alternatively, this file may be used under the terms of the GNU Free
-** Documentation License version 1.3 as published by the Free Software
-** Foundation and appearing in the file included in the packaging of
-** this file. Please review the following information to ensure
-** the GNU Free Documentation License version 1.3 requirements
-** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
-** $QT_END_LICENSE$
-**
-****************************************************************************/
+// Copyright (C) 2013 Kurt Pattyn <pattyn.kurt@gmail.com>
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\page qtwebsockets-index.html
@@ -31,61 +7,61 @@
\title Qt WebSockets
\brief Provides an implementation of the WebSocket protocol.
- WebSocket is a web-based protocol designed to enable two-way communication
- between a client application and a remote host. It enables the two entities
- to send data back and forth if the initial handshake succeeds. WebSocket is
- the solution for applications that struggle to get real-time data feeds
- with less network latency and minimum data exchange.
+ WebSocket is a web-based protocol designed to enable a two-way interactive
+ communication session between a client application and a remote host. It
+ enables the two entities to send data back and forth if the initial
+ handshake succeeds.
The Qt WebSockets module provides C++ and QML interfaces that enable
Qt applications to act as a server that can process WebSocket requests,
or a client that can consume data received from the server, or both.
- \section1 Getting Started
+ \section1 Using the Module
- To include the definitions of the module's classes, use the following directive:
+ \section2 QML API
- \code
- #include <QtWebSockets/QtWebSockets>
- \endcode
+ \include {module-use.qdocinc} {using the qml api} {QtWebSockets}
- To import the QML types into your application, use the following import statement in your .qml file:
+ \section2 C++ API
- \qml \QtMinorVersion
- import QtWebSockets 1.\1
- \endqml
+ \include {module-use.qdocinc} {using the c++ api}
- To link against the module, add this line to your qmake .pro file:
+ \section3 Building with CMake
- \code
- QT += websockets
- \endcode
+ \include {module-use.qdocinc} {building with cmake} {WebSockets}
- \section1 Licenses
+ \section3 Building with qmake
- Qt WebSockets is available under commercial licenses from \l{The Qt Company}.
- In addition, it is available under free software licenses. Since Qt 5.4,
- these free software licenses are
- \l{GNU Lesser General Public License, version 3}, or
- the \l{GNU General Public License, version 2}.
- See \l{Qt Licensing} for further details.
+ \include {module-use.qdocinc} {building_with_qmake} {websockets}
+
+ \section1 Examples
- \section1 Reference Documentation
\list
- \li \l{Qt WebSockets Overview}{Overview}
- \li \l{Qt WebSockets C++ Classes}{C++ Classes}
- \li \l{Qt WebSockets QML Types}{QML Types}
+ \li \l {Qt WebSockets Examples}
\endlist
- \section1 Examples
+ \section1 Reference
- The module provides the following \l{Qt WebSockets Examples}{Examples} as a guide to using
- the API.
+ \list
+ \li \l {Qt WebSockets Overview} {Overview}
+ \li \l {Qt WebSockets C++ Classes} {C++ Classes}
+ \li \l {Qt WebSockets QML Types} {QML Types}
+ \endlist
\section1 Conformance
+
\list
- \li \l {Testing Qt WebSockets}
+ \li \l {Testing Qt WebSockets}
\endlist
+
+ \section1 Licenses
+
+ Qt WebSockets is available under commercial licenses from \l{The Qt Company}.
+ In addition, it is available under free software licenses. Since Qt 5.4,
+ these free software licenses are
+ \l{GNU Lesser General Public License, version 3}, or
+ the \l{GNU General Public License, version 2}.
+ See \l{Qt Licensing} for further details.
*/
/*!
@@ -98,5 +74,5 @@
\l {Autobahn|Testsuite installation documentation}
to set up the test suite.
- \include README testsuite
+ \include README.qdocinc testsuite
*/