aboutsummaryrefslogtreecommitdiff
path: root/lib/csapi/receipts.h
diff options
context:
space:
mode:
authorKitsune Ral <Kitsune-Ral@users.sf.net>2018-07-18 18:39:56 +0900
committerKitsune Ral <Kitsune-Ral@users.sf.net>2018-07-18 18:39:56 +0900
commit5e6b4bb975fa9697a6aca001629c65db506a437f (patch)
treedeeb501bd6b534dc1ce454fb03e2d91e09597770 /lib/csapi/receipts.h
parent56480bc96b28356c44547cc3d9ea1afbda9f04f9 (diff)
downloadlibquotient-5e6b4bb975fa9697a6aca001629c65db506a437f.tar.gz
libquotient-5e6b4bb975fa9697a6aca001629c65db506a437f.zip
csapi: Doxy-comments thanks to the latest GTAD
Diffstat (limited to 'lib/csapi/receipts.h')
-rw-r--r--lib/csapi/receipts.h15
1 files changed, 15 insertions, 0 deletions
diff --git a/lib/csapi/receipts.h b/lib/csapi/receipts.h
index 3c11bcb1..101f2d05 100644
--- a/lib/csapi/receipts.h
+++ b/lib/csapi/receipts.h
@@ -12,9 +12,24 @@ namespace QMatrixClient
{
// Operations
+ /// Send a receipt for the given event ID.
+ ///
+ /// This API updates the marker for the given receipt type to the event ID
+ /// specified.
class PostReceiptJob : public BaseJob
{
public:
+ /*! Send a receipt for the given event ID.
+ * \param roomId
+ * The room in which to send the event.
+ * \param receiptType
+ * The type of receipt to send.
+ * \param eventId
+ * The event ID to acknowledge up to.
+ * \param receipt
+ * Extra receipt information to attach to ``content`` if any. The
+ * server will automatically set the ``ts`` field.
+ */
explicit PostReceiptJob(const QString& roomId, const QString& receiptType, const QString& eventId, const QJsonObject& receipt = {});
};
} // namespace QMatrixClient