diff --git a/src/document/css/parser.c b/src/document/css/parser.c
index 9715f924f..2aca47539 100644
--- a/src/document/css/parser.c
+++ b/src/document/css/parser.c
@@ -184,16 +184,16 @@ struct selector_pkg {
 /** Move a CSS selector and its leaves into a new list.  If a similar
  * selector already exists in the list, merge them.
  *
- * \param sels
- *   The list to which \a selector should be moved.  Must not be NULL.
- * \param selector
+ * @param sels
+ *   The list to which @a selector should be moved.  Must not be NULL.
+ * @param selector
  *   The selector that should be moved.  Must not be NULL.  If it is
  *   already in some list, this function removes it from there.
- * \param watch
- *   This function updates \a *watch if it merges that selector into
- *   another one.  \a watch must not be NULL but \a *watch may be.
+ * @param watch
+ *   This function updates @a *watch if it merges that selector into
+ *   another one.  @a watch must not be NULL but @a *watch may be.
  *
- * \return \a selector or the one into which it was merged.  */
+ * @returns @a selector or the one into which it was merged.  */
 static struct css_selector *
 reparent_selector(struct list_head *sels, struct css_selector *selector,
                   struct css_selector **watch)
diff --git a/src/dom/stack.h b/src/dom/stack.h
index 820bbb46f..423c5bb5e 100644
--- a/src/dom/stack.h
+++ b/src/dom/stack.h
@@ -67,8 +67,8 @@ struct dom_stack_state {
 	 * The depth of the state in the stack. This is amongst other things
 	 * used to get the state object data. */
 	unsigned int depth;
-	/** Whether this stack state can be popped with #pop_dom_node,
-	 * #pop_dom_nodes, or #pop_dom_state. */
+	/** Whether this stack state can be popped with pop_dom_node(),
+	 * pop_dom_nodes(), or pop_dom_state(). */
 	unsigned int immutable:1;
 };
 
@@ -112,7 +112,7 @@ enum dom_stack_flag {
 	/** No flag needed. */
 	DOM_STACK_FLAG_NONE = 0,
 
-	/** Free nodes when popping by calling #done_dom_node. */
+	/** Free nodes when popping by calling done_dom_node(). */
 	DOM_STACK_FLAG_FREE_NODES = 1,
 };