diff --git a/include/libxml/HTMLparser.h b/include/libxml/HTMLparser.h
index d8722fc50..0fcf2f3c9 100644
--- a/include/libxml/HTMLparser.h
+++ b/include/libxml/HTMLparser.h
@@ -27,8 +27,6 @@
 extern "C" {
 #endif
 
-/** @cond ignore */
-
 /*
  * Backward compatibility
  */
@@ -41,16 +39,21 @@ extern "C" {
 /*
  * Most of the back-end structures from XML and HTML are shared.
  */
+/** Same as xmlParserCtxt */
 typedef xmlParserCtxt htmlParserCtxt;
 typedef xmlParserCtxtPtr htmlParserCtxtPtr;
 typedef xmlParserNodeInfo htmlParserNodeInfo;
+/** Same as xmlSAXHandler */
 typedef xmlSAXHandler htmlSAXHandler;
 typedef xmlSAXHandlerPtr htmlSAXHandlerPtr;
+/** Same as xmlParserInput */
 typedef xmlParserInput htmlParserInput;
 typedef xmlParserInputPtr htmlParserInputPtr;
 typedef xmlDocPtr htmlDocPtr;
 typedef xmlNodePtr htmlNodePtr;
 
+/** @cond ignore */
+
 /*
  * Internal description of an HTML element, representing HTML 4.01
  * and XHTML 1.0 (which share the same structure).