1 files changed, 36 insertions, 42 deletions

diff --git a/lib/csapi/profile.h b/lib/csapi/profile.h
index 54dc53aa..8279fe20 100644
--- a/lib/csapi/profile.h
+++ b/lib/csapi/profile.h
@@ -6,20 +6,19 @@
 
 #include "jobs/basejob.h"
 
-namespace Quotient
-{
+namespace Quotient {
 
 // Operations
 
-/// Set the user's display name.
-/*!
+/*! \brief Set the user's display name.
+ *
  * This API sets the given user's display name. You must have permission to
  * set this user's display name, e.g. you need to have their ``access_token``.
  */
-class SetDisplayNameJob : public BaseJob
-{
+class SetDisplayNameJob : public BaseJob {
 public:
-    /*! Set the user's display name.
+    /*! \brief Set the user's display name.
+     *
      * \param userId
      *   The user whose display name to set.
      * \param displayname
@@ -29,29 +28,27 @@ public:
                                const QString& displayname = {});
 };
 
-/// Get the user's display name.
-/*!
+/*! \brief Get the user's display name.
+ *
  * Get the user's display name. This API may be used to fetch the user's
  * own displayname or to query the name of other users; either locally or
  * on remote homeservers.
  */
-class GetDisplayNameJob : public BaseJob
-{
+class GetDisplayNameJob : public BaseJob {
 public:
-    /*! Get the user's display name.
+    /*! \brief Get the user's display name.
+     *
      * \param userId
      *   The user whose display name to get.
      */
     explicit GetDisplayNameJob(const QString& userId);
 
-    /*! Construct a URL without creating a full-fledged job object
+    /*! \brief Construct a URL without creating a full-fledged job object
      *
-     * This function can be used when a URL for
-     * GetDisplayNameJob is necessary but the job
-     * itself isn't.
+     * This function can be used when a URL for GetDisplayNameJob
+     * is necessary but the job itself isn't.
      */
     static QUrl makeRequestUrl(QUrl baseUrl, const QString& userId);
-
     ~GetDisplayNameJob() override;
 
     // Result properties
@@ -67,15 +64,15 @@ private:
     QScopedPointer<Private> d;
 };
 
-/// Set the user's avatar URL.
-/*!
+/*! \brief Set the user's avatar URL.
+ *
  * This API sets the given user's avatar URL. You must have permission to
  * set this user's avatar URL, e.g. you need to have their ``access_token``.
  */
-class SetAvatarUrlJob : public BaseJob
-{
+class SetAvatarUrlJob : public BaseJob {
 public:
-    /*! Set the user's avatar URL.
+    /*! \brief Set the user's avatar URL.
+     *
      * \param userId
      *   The user whose avatar URL to set.
      * \param avatarUrl
@@ -85,29 +82,27 @@ public:
                              const QString& avatarUrl = {});
 };
 
-/// Get the user's avatar URL.
-/*!
+/*! \brief Get the user's avatar URL.
+ *
  * Get the user's avatar URL. This API may be used to fetch the user's
  * own avatar URL or to query the URL of other users; either locally or
  * on remote homeservers.
  */
-class GetAvatarUrlJob : public BaseJob
-{
+class GetAvatarUrlJob : public BaseJob {
 public:
-    /*! Get the user's avatar URL.
+    /*! \brief Get the user's avatar URL.
+     *
      * \param userId
      *   The user whose avatar URL to get.
      */
     explicit GetAvatarUrlJob(const QString& userId);
 
-    /*! Construct a URL without creating a full-fledged job object
+    /*! \brief Construct a URL without creating a full-fledged job object
      *
-     * This function can be used when a URL for
-     * GetAvatarUrlJob is necessary but the job
-     * itself isn't.
+     * This function can be used when a URL for GetAvatarUrlJob
+     * is necessary but the job itself isn't.
      */
     static QUrl makeRequestUrl(QUrl baseUrl, const QString& userId);
-
     ~GetAvatarUrlJob() override;
 
     // Result properties
@@ -123,36 +118,35 @@ private:
     QScopedPointer<Private> d;
 };
 
-/// Get this user's profile information.
-/*!
+/*! \brief Get this user's profile information.
+ *
  * Get the combined profile information for this user. This API may be used
  * to fetch the user's own profile information or other users; either
  * locally or on remote homeservers. This API may return keys which are not
  * limited to ``displayname`` or ``avatar_url``.
  */
-class GetUserProfileJob : public BaseJob
-{
+class GetUserProfileJob : public BaseJob {
 public:
-    /*! Get this user's profile information.
+    /*! \brief Get this user's profile information.
+     *
      * \param userId
      *   The user whose profile information to get.
      */
     explicit GetUserProfileJob(const QString& userId);
 
-    /*! Construct a URL without creating a full-fledged job object
+    /*! \brief Construct a URL without creating a full-fledged job object
      *
-     * This function can be used when a URL for
-     * GetUserProfileJob is necessary but the job
-     * itself isn't.
+     * This function can be used when a URL for GetUserProfileJob
+     * is necessary but the job itself isn't.
      */
     static QUrl makeRequestUrl(QUrl baseUrl, const QString& userId);
-
     ~GetUserProfileJob() override;
 
     // Result properties
 
     /// The user's avatar URL if they have set one, otherwise not present.
     const QString& avatarUrl() const;
+
     /// The user's display name if they have set one, otherwise not present.
     const QString& displayname() const;