From: Nick Mathewson <nickm@torproject.org>
Date: Tue, 5 Nov 2019 17:42:49 +0000 (-0500)
Subject: Doxygen: set TYPEDEF_HIDES_STRUCT.
X-Git-Tag: tor-0.4.3.1-alpha~182^2~1
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=36bceacdcdc6e7ed666cb4bbbf8cc76132f89bbd;p=thirdparty%2Ftor.git

Doxygen: set TYPEDEF_HIDES_STRUCT.

This option tells doxygen to handle typedef struct foo_t foo_t by
making foo_t and struct foo_t synonymous. This lets doxygen find
documentation that it would otherwise miss: otherwise, if it sees
documentation for "int func(foo_t *)" and a prototype for
"int func(struct foo_t)", it will think that the prototype is
undocumented.

Part of #32386.
---

diff --git a/Doxyfile.in b/Doxyfile.in
index be500bbfa8..d0ff030ae0 100644
--- a/Doxyfile.in
+++ b/Doxyfile.in
@@ -435,7 +435,7 @@ INLINE_SIMPLE_STRUCTS  = NO
 # types are typedef'ed and only the typedef is referenced, never the tag name.
 # The default value is: NO.
 
-TYPEDEF_HIDES_STRUCT   = NO
+TYPEDEF_HIDES_STRUCT   = YES
 
 # The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This
 # cache is used to resolve symbols given their name and scope. Since this can be