diff --git a/error.c b/error.c
index cb954dbf9e..3e00cacb22 100644
--- a/error.c
+++ b/error.c
@@ -201,14 +201,20 @@ rb_warning_category_enabled_p(rb_warning_category_t category)
  * Returns the flag to show the warning messages for +category+.
  * Supported categories are:
  *
- * +:deprecated+ :: deprecation warnings
- * * assignment of non-nil value to <code>$,</code> and <code>$;</code>
- * * keyword arguments
- * * proc/lambda without block
- * etc.
+ * +:deprecated+ ::
+ *   deprecation warnings
+ *   * assignment of non-nil value to <code>$,</code> and <code>$;</code>
+ *   * keyword arguments
+ *   * proc/lambda without block
+ *   etc.
  *
- * +:experimental+ :: experimental features
- * * Pattern matching
+ * +:experimental+ ::
+ *   experimental features
+ *   * Pattern matching
+ *
+ * +:performance+ ::
+ *   performance hints
+ *   * Shape variation limit
  */
 
 static VALUE