diff --git a/glib/gtrashstack.c b/glib/gtrashstack.c
index f734e2437..3d94cc65f 100644
--- a/glib/gtrashstack.c
+++ b/glib/gtrashstack.c
@@ -33,35 +33,27 @@
 
 #include "gtrashstack.h"
 
-/**
- * SECTION:trash_stack
- * @title: Trash Stacks
- * @short_description: maintain a stack of unused allocated memory chunks
- *
- * A #GTrashStack is an efficient way to keep a stack of unused allocated
- * memory chunks. Each memory chunk is required to be large enough to hold
- * a #gpointer. This allows the stack to be maintained without any space
- * overhead, since the stack pointers can be stored inside the memory chunks.
- *
- * There is no function to create a #GTrashStack. A %NULL #GTrashStack*
- * is a perfectly valid empty stack.
- *
- * There is no longer any good reason to use #GTrashStack.  If you have
- * extra pieces of memory, free() them and allocate them again later.
- *
- * Deprecated: 2.48: #GTrashStack is deprecated without replacement
- */
-
 /**
  * GTrashStack:
  * @next: pointer to the previous element of the stack,
  *     gets stored in the first `sizeof (gpointer)`
  *     bytes of the element
  *
- * Each piece of memory that is pushed onto the stack
- * is cast to a GTrashStack*.
+ * A `GTrashStack` is an efficient way to keep a stack of unused allocated
+ * memory chunks. Each memory chunk is required to be large enough to hold
+ * a `gpointer`. This allows the stack to be maintained without any space
+ * overhead, since the stack pointers can be stored inside the memory chunks.
  *
- * Deprecated: 2.48: #GTrashStack is deprecated without replacement
+ * There is no function to create a `GTrashStack`. A `NULL` `GTrashStack*`
+ * is a perfectly valid empty stack.
+ *
+ * Each piece of memory that is pushed onto the stack is cast to a
+ * `GTrashStack*`.
+ *
+ * There is no longer any good reason to use `GTrashStack`.  If you have
+ * extra pieces of memory, `free()` them and allocate them again later.
+ *
+ * Deprecated: 2.48: `GTrashStack` is deprecated without replacement
  */
 
 /**