diff --git a/include/crm/cluster/compat.h b/include/crm/cluster/compat.h
index e95b444e41..e1e202cd57 100644
--- a/include/crm/cluster/compat.h
+++ b/include/crm/cluster/compat.h
@@ -1,131 +1,131 @@
 /*
  * Copyright 2004-2024 the Pacemaker project contributors
  *
  * The version control history for this file may have further details.
  *
  * This source code is licensed under the GNU Lesser General Public License
  * version 2.1 or later (LGPLv2.1+) WITHOUT ANY WARRANTY.
  */
 
 #ifndef PCMK__CRM_CLUSTER_COMPAT__H
 #  define PCMK__CRM_CLUSTER_COMPAT__H
 
 #include <stdint.h>         // uint32_t
 
 #include <glib.h>           // gboolean, guint
 #include <libxml/tree.h>    // xmlNode
 
 #if SUPPORT_COROSYNC
 #include <corosync/cpg.h>   // cpg_handle_t
 #endif  // SUPPORT_COROSYNC
 
 #include <crm/cluster.h>    // crm_node_t
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 /**
  * \file
  * \brief Deprecated Pacemaker cluster API
  * \ingroup cluster
  * \deprecated Do not include this header directly. The cluster APIs in this
  *             header, and the header itself, will be removed in a future
  *             release.
  */
 
-// \deprecated Do not use
+//! \deprecated Do not use
 enum crm_get_peer_flags {
     CRM_GET_PEER_CLUSTER   = 0x0001,
     CRM_GET_PEER_REMOTE    = 0x0002,
     CRM_GET_PEER_ANY       = CRM_GET_PEER_CLUSTER|CRM_GET_PEER_REMOTE,
 };
 
-// \deprecated Use \c pcmk_cluster_t instead
+//! \deprecated Use \c pcmk_cluster_t instead
 typedef pcmk_cluster_t crm_cluster_t;
 
-// \deprecated Do not use Pacemaker for cluster node cacheing
+//! \deprecated Do not use Pacemaker for cluster node cacheing
 crm_node_t *crm_get_peer(unsigned int id, const char *uname);
 
-// \deprecated Do not use Pacemaker for cluster node cacheing
+//! \deprecated Do not use Pacemaker for cluster node cacheing
 crm_node_t *crm_get_peer_full(unsigned int id, const char *uname, int flags);
 
-// \deprecated Use stonith_api_kick() from libstonithd instead
+//! \deprecated Use stonith_api_kick() from libstonithd instead
 int crm_terminate_member(int nodeid, const char *uname, void *unused);
 
-// \deprecated Use stonith_api_kick() from libstonithd instead
+//! \deprecated Use \c stonith_api_kick() from libstonithd instead
 int crm_terminate_member_no_mainloop(int nodeid, const char *uname,
                                      int *connection);
 
-// \deprecated Use crm_xml_add(xml, attr, crm_peer_uuid(node)) instead
+//! \deprecated Use \c crm_xml_add(xml, attr, crm_peer_uuid(node)) instead
 void set_uuid(xmlNode *xml, const char *attr, crm_node_t *node);
 
 #if SUPPORT_COROSYNC
 
-// \deprecated Do not use
+//! \deprecated Do not use
 gboolean cluster_connect_cpg(pcmk_cluster_t *cluster);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 void cluster_disconnect_cpg(pcmk_cluster_t *cluster);
 
 //! \deprecated Do not use
 uint32_t get_local_nodeid(cpg_handle_t handle);
 
 #endif  // SUPPORT_COROSYNC
 
-// \deprecated Use \c pcmk_cluster_connect() instead
+//! \deprecated Use \c pcmk_cluster_connect() instead
 gboolean crm_cluster_connect(pcmk_cluster_t *cluster);
 
-// \deprecated Use \c pcmk_cluster_disconnect() instead
+//! \deprecated Use \c pcmk_cluster_disconnect() instead
 void crm_cluster_disconnect(pcmk_cluster_t *cluster);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 int crm_remote_peer_cache_size(void);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 void crm_remote_peer_cache_refresh(xmlNode *cib);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 crm_node_t *crm_remote_peer_get(const char *node_name);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 void crm_remote_peer_cache_remove(const char *node_name);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 gboolean crm_is_peer_active(const crm_node_t *node);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 guint crm_active_peers(void);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 guint reap_crm_member(uint32_t id, const char *name);
 
 //!@{
 //! \deprecated Use <tt>enum pcmk_cluster_layer</tt> instead
 enum cluster_type_e {
     pcmk_cluster_unknown    = pcmk_cluster_layer_unknown,
     pcmk_cluster_invalid    = pcmk_cluster_layer_invalid,
     pcmk_cluster_corosync   = pcmk_cluster_layer_corosync,
 };
 //!@}
 
-// \deprecated Use \c pcmk_cluster_layer_text() instead
+//! \deprecated Use \c pcmk_cluster_layer_text() instead
 const char *name_for_cluster_type(enum cluster_type_e type);
 
-// \deprecated Use \c pcmk_get_cluster_layer() instead
+//! \deprecated Use \c pcmk_get_cluster_layer() instead
 enum cluster_type_e get_cluster_type(void);
 
-// \deprecated Use \c pcmk_get_cluster_layer() instead
+//! \deprecated Use \c pcmk_get_cluster_layer() instead
 gboolean is_corosync_cluster(void);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 void crm_peer_init(void);
 
-// \deprecated Do not use
+//! \deprecated Do not use
 void crm_peer_destroy(void);
 
 #ifdef __cplusplus
 }
 #endif
 
 #endif // PCMK_CLUSTER_COMPAT__H