diff options
author | Qt Forward Merge Bot <qt_forward_merge_bot@qt-project.org> | 2019-02-02 03:03:51 +0100 |
---|---|---|
committer | Qt Forward Merge Bot <qt_forward_merge_bot@qt-project.org> | 2019-02-02 03:03:51 +0100 |
commit | 2a14e88f548fbc20537ed9a2736c2e058a1d59af (patch) | |
tree | 75e611d394679705651ef8adeb28c11a9c381392 | |
parent | e04be34b5b019df2c7e6009268833462c325c992 (diff) | |
parent | d3cde521533787f5f91364ffdba3e0a386d131f6 (diff) |
Merge remote-tracking branch 'origin/5.12' into 5.13v5.13.0-alpha1
Change-Id: Iea54e173eb192f5e127ade29e5a96e1101f41bb4
4 files changed, 22 insertions, 24 deletions
diff --git a/src/remoteobjects/doc/src/remoteobjects-external-schemas.qdoc b/src/remoteobjects/doc/src/remoteobjects-external-schemas.qdoc index fdc8e4f..18a19a8 100644 --- a/src/remoteobjects/doc/src/remoteobjects-external-schemas.qdoc +++ b/src/remoteobjects/doc/src/remoteobjects-external-schemas.qdoc @@ -81,7 +81,7 @@ the connection or have a way to discover that information. This is exactly the problem the registry was designed to solve. Qt Remote Objects also allows "External Schemas" to be used with the registry, -which helps with connection setup. On the \l QRemoteObjectHostNode side, the +which helps with connection setup. On the \l QRemoteObjectHost side, the user must set the hostUrl with the desired schema. \code @@ -106,8 +106,8 @@ user must set the hostUrl with the desired schema. \endcode On the \l Replica side, the \l QRemoteObjectNode needs to register a callback -to be used when the external schema is detected. The callback must be a \l -RemoteObjectSchemaHandler. +to be used when the external schema is detected. The callback must be a +\l {QRemoteObjectNode::}{RemoteObjectSchemaHandler}. \code // Use standard tcp url for the registry diff --git a/src/remoteobjects/doc/src/remoteobjects-qml.qdoc b/src/remoteobjects/doc/src/remoteobjects-qml.qdoc index e6a874b..2d88689 100644 --- a/src/remoteobjects/doc/src/remoteobjects-qml.qdoc +++ b/src/remoteobjects/doc/src/remoteobjects-qml.qdoc @@ -31,7 +31,7 @@ \ingroup qmlmodules \brief Provides QML types for remote objects support. -The QML types for \l{Qt Remoteobjects} provide the helper pieces needed to build a remote objects network. +The QML types for \l{Qt Remote Objects} provide the helper pieces needed to build a remote objects network. They are typically used in conjunction with custom-registered replica types that make up a specific network. diff --git a/src/remoteobjects/doc/src/remoteobjects-repc.qdoc b/src/remoteobjects/doc/src/remoteobjects-repc.qdoc index bb47b90..e0dc61a 100644 --- a/src/remoteobjects/doc/src/remoteobjects-repc.qdoc +++ b/src/remoteobjects/doc/src/remoteobjects-repc.qdoc @@ -212,7 +212,7 @@ Another nuanced value is SOURCEONLYSETTER, which provides another way of specifying asymmetric behavior, where the \l Source (specifically the helper - class, \l SimpleSource) will have a public getter and setter for the + class, \c SimpleSource) will have a public getter and setter for the property, but it will be ReadOnly (with a notify signal) on the \l Replica side. Thus the property can be fully controlled from the \l Source side, but only observed from the \l Replica side. SOURCEONLYSETTER is the mode diff --git a/src/remoteobjects/qremoteobjectnode.cpp b/src/remoteobjects/qremoteobjectnode.cpp index 46d9fc1..edbc4f5 100644 --- a/src/remoteobjects/qremoteobjectnode.cpp +++ b/src/remoteobjects/qremoteobjectnode.cpp @@ -336,14 +336,14 @@ void QRemoteObjectNode::registerExternalSchema(const QString &schema, QRemoteObj This would (internally) create a node in proxyNode, which (again internally/automatically) connects to the provided registry (given by the \a registryUrl parameter, "local:registry" in this example). Whenever - local:registry emits the \l remoteObjectAdded signal, the \l - QRemoteObjectSourceLocation is passed to the \a filter given to the proxy + local:registry emits the \l remoteObjectAdded signal, the + \c QRemoteObjectSourceLocation is passed to the \a filter given to the proxy call. If this method returns true (the default filter simply returns true without any filtering), the object is acquired() from the internal node and enableRemoting() (once the replica is initialized) is called on proxyNode. If a \a hostUrl is provided (which is required to enable reverseProxy, but - not needed otherwise), the internal node will be a \l QRemoteObjectHostNode + not needed otherwise), the internal node will be a \l QRemoteObjectHost node configured with the provided address. If no \a hostUrl is provided, the internal node will be a QRemoteObjectNode (not HostNode). @@ -429,8 +429,8 @@ bool QRemoteObjectHostBase::proxy(const QUrl ®istryUrl, const QUrl &hostUrl, network to be acquired(), reverseProxy() allows \l Source objects to be "pushed" to an otherwise inaccessible network. - Note: \l proxy() needs to be called before \l reverseProxy(), and a \a - hostUrl needs to be provided to \l proxy for \l reverseProxy() to work. The + Note: \l proxy() needs to be called before \l reverseProxy(), and a + \a hostUrl needs to be provided to \l proxy for \l reverseProxy() to work. The \l reverseProxy() method allows a separate \a filter to be applied. This reverseProxy specific filter will receive notifications of new \l Source objects on proxyNode and acquire them on the internal node if they pass the @@ -1352,12 +1352,9 @@ void QRemoteObjectNodePrivate::onClientRead(QObject *obj) supported schema. This is the default value, and causes a Node error to be set if an unrecognized schema is provided. \value AllowExternalRegistration The provided schema is registered as an - \l {External Schemas} {External Schema} + \l {External Schemas}{External Schema} - \sa QRemoteObjectHost(const QUrl &address, const QUrl ®istryAddress = - QUrl(), AllowedSchemas allowedSchemas=BuiltInSchemasOnly, QObject *parent = - nullptr), setHostUrl(const QUrl &hostAddress, AllowedSchemas - allowedSchemas=BuiltInSchemasOnly) + \sa QRemoteObjectHost */ /*! @@ -1463,9 +1460,9 @@ QRemoteObjectHostBase::QRemoteObjectHostBase(QRemoteObjectHostBasePrivate &d, QO Constructs a new QRemoteObjectHost Node (i.e., a Node that supports exposing \l Source objects on the QtRO network) with the given \a parent. This constructor is meant specific to support QML in the future as it will - not be available to connect to until \l setHostUrl() is called. + not be available to connect to until \l {QRemoteObjectHost::}{setHostUrl}() is called. - \sa setHostUrl(), setRegistryUrl() + \sa {QRemoteObjectHost::}{setHostUrl}(), setRegistryUrl() */ QRemoteObjectHost::QRemoteObjectHost(QObject *parent) : QRemoteObjectHostBase(*new QRemoteObjectHostPrivate, parent) @@ -1481,7 +1478,7 @@ QRemoteObjectHost::QRemoteObjectHost(QObject *parent) {AllowExternalRegistration}) if the schema of the url should be used as an \l {External Schemas} {External Schema} by the registry. - \sa setHostUrl(), setRegistryUrl() + \sa {QRemoteObjectHost::}{setHostUrl}(), setRegistryUrl() */ QRemoteObjectHost::QRemoteObjectHost(const QUrl &address, const QUrl ®istryAddress, AllowedSchemas allowedSchemas, QObject *parent) @@ -1625,7 +1622,7 @@ bool QRemoteObjectHostBase::setHostUrl(const QUrl &hostAddress, AllowedSchemas a Returns the host address for the QRemoteObjectNode as a QUrl. If the Node is not a Host node, it return an empty QUrl. - \sa setHostUrl() + \sa {QRemoteObjectHost}{setHostUrl}() */ QUrl QRemoteObjectHost::hostUrl() const { @@ -1853,7 +1850,7 @@ bool QRemoteObjectNode::connectToNode(const QUrl &address) In order to \l QRemoteObjectNode::acquire() \l Replica objects over \l {External QIODevices}, Qt Remote Objects needs access to the communications - channel (a \l QIODEvice) between the respective nodes. It is the + channel (a \l QIODevice) between the respective nodes. It is the addClientSideConnection() call that enables this, taking the \a ioDevice as input. Any acquire() call made without calling addClientSideConnection will still work, but the Node will not be able to initialize the \l Replica @@ -2099,13 +2096,14 @@ bool QRemoteObjectHostBase::disableRemoting(QObject *remoteObject) In order to \l QRemoteObjectHost::enableRemoting() \l Source objects over \l {External QIODevices}, Qt Remote Objects needs access to the - communications channel (a \l QIODEvice) between the respective nodes. It is + communications channel (a \l QIODevice) between the respective nodes. It is the addHostSideConnection() call that enables this on the \l Source side, taking the \a ioDevice as input. Any enableRemoting() call will still work without calling addHostSideConnection, but the Node will not be able to - share the \l Source objects without being provided the connection to the - Replica node. Before calling this function you must call \l setHostUrl with - a unique URL and \l QRemoteObjectHost::AllowExternalRegistration. + share the \l Source objects without being provided the connection to + the Replica node. Before calling this function you must call + \l {QRemoteObjectHost::}{setHostUrl}() with a unique URL and + \l {QRemoteObjectHost::}{AllowExternalRegistration}. \sa addClientSideConnection */ |