aboutsummaryrefslogtreecommitdiff
path: root/lib/csapi/versions.h
diff options
context:
space:
mode:
Diffstat (limited to 'lib/csapi/versions.h')
-rw-r--r--lib/csapi/versions.h16
1 files changed, 13 insertions, 3 deletions
diff --git a/lib/csapi/versions.h b/lib/csapi/versions.h
index 9f1a4831..3303752d 100644
--- a/lib/csapi/versions.h
+++ b/lib/csapi/versions.h
@@ -11,14 +11,23 @@ namespace QMatrixClient
{
// Operations
+ /// Gets the versions of the specification supported by the server.
+ ///
+ /// Gets the versions of the specification supported by the server.
+ ///
+ /// Values will take the form ``rX.Y.Z``.
+ ///
+ /// Only the latest ``Z`` value will be reported for each supported ``X.Y`` value.
+ /// i.e. if the server implements ``r0.0.0``, ``r0.0.1``, and ``r1.2.0``, it will report ``r0.0.1`` and ``r1.2.0``.
class GetVersionsJob : public BaseJob
{
public:
explicit GetVersionsJob();
- /** Construct a URL out of baseUrl and usual parameters passed to
- * GetVersionsJob. This function can be used when
- * a URL for GetVersionsJob is necessary but the job
+ /*! Construct a URL without creating a full-fledged job object
+ *
+ * This function can be used when a URL for
+ * GetVersionsJob is necessary but the job
* itself isn't.
*/
static QUrl makeRequestUrl(QUrl baseUrl);
@@ -27,6 +36,7 @@ namespace QMatrixClient
// Result properties
+ /// The supported versions.
const QStringList& versions() const;
protected: