diff --git a/error.c b/error.c
index 9326170a..b5b79ba4 100644
--- a/error.c
+++ b/error.c
@@ -241,13 +241,15 @@ xmlGenericErrorDefaultFunc(void *ctx ATTRIBUTE_UNUSED, const char *msg, ...) {
 
 /**
  * Set the thread-local "generic" handler and context for error
- * messages. The generic error handler will only receive fragments
- * of error messages which should be concatenated or printed to a
- * stream.
+ * messages.
  *
  * @deprecated See #xmlSetStructuredErrorFunc for alternatives.
  *
- * If handler is NULL, use the built-in default handler which prints
+ * The generic error handler will only receive fragments of
+ * error messages which should be concatenated or printed to a
+ * stream.
+ *
+ * If `handler` is NULL, use the built-in default handler which prints
  * to stderr.
  *
  * Since this is a thread-local setting, it's a good idea to reset
@@ -272,10 +274,13 @@ xmlSetGenericErrorFunc(void *ctx, xmlGenericErrorFunc handler) {
 }
 
 /**
- * It's recommended to use the per-context error handlers instead:
+ * Set the thread-local "structured" handler and context for error
+ * messages.
  *
  * @deprecated Use a per-context error handler.
  *
+ * It's recommended to use the per-context error handlers instead:
+ *
  * - #xmlCtxtSetErrorHandler (since 2.13.0)
  * - #xmlTextReaderSetStructuredErrorHandler
  * - #xmlXPathSetErrorHandler (since 2.13.0)
@@ -285,8 +290,7 @@ xmlSetGenericErrorFunc(void *ctx, xmlGenericErrorFunc handler) {
  * - #xmlRelaxNGSetParserStructuredErrors
  * - #xmlRelaxNGSetValidStructuredErrors
  *
- * Set the thread-local "structured" handler and context for error
- * messages. If handler is NULL, the error handler is deactivated.
+ * If `handler` is NULL, the error handler is deactivated.
  *
  * The structured error handler takes precedence over "generic"
  * handlers, even per-context generic handlers.
diff --git a/xmlmemory.c b/xmlmemory.c
index 24e5e93a..90c8b9c1 100644
--- a/xmlmemory.c
+++ b/xmlmemory.c
@@ -493,7 +493,7 @@ xmlGcMemSetup(xmlFreeFunc freeFunc, xmlMallocFunc mallocFunc,
  * The mallocAtomicFunc is specialized for atomic block
  * allocations (i.e. of areas  useful for garbage collected memory allocators
  *
- * @deprecated #xmlMemGet.
+ * @deprecated Use #xmlMemGet.
  *
  * @param freeFunc  place to save the free() function in use
  * @param mallocFunc  place to save the malloc() function in use