From: Amos Jeffries <yadij@users.noreply.github.com>
Date: Sun, 7 Jan 2024 18:37:09 +0000 (+0000)
Subject: Docs: update doxygen support (#1622)
X-Git-Tag: SQUID_7_0_1~241
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=02c8fd1ccfd925a937762ca2bd6015fa397d94b8;p=thirdparty%2Fsquid.git

Docs: update doxygen support (#1622)

Doxygen v1.7.5 changed HTML_HEADER requirements: We now need to add an
open div element to the header that Doxygen then closes for us. This
change also fixes the corresponding generated content on Squid website.

Also, disable IDL_PROPERTY_SUPPORT which has been causing some errors
with output getter/setter matching in the generated output.
---

diff --git a/doc/Programming-Guide/doxygen.header.dyn b/doc/Programming-Guide/doxygen.header.dyn
index 662f114dd3..d8d12bcf83 100644
--- a/doc/Programming-Guide/doxygen.header.dyn
+++ b/doc/Programming-Guide/doxygen.header.dyn
@@ -6,3 +6,4 @@
  * Please see the COPYING and CONTRIBUTORS files for details.
 -->
 <div id="doxypage">
+<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
diff --git a/squid.dox b/squid.dox
index c1b5ebf896..8ab39e0303 100644
--- a/squid.dox
+++ b/squid.dox
@@ -349,7 +349,7 @@ SIP_SUPPORT            = NO
 # should set this option to NO.
 # The default value is: YES.
 
-IDL_PROPERTY_SUPPORT   = YES
+IDL_PROPERTY_SUPPORT   = NO
 
 # If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
 # tag is set to YES then doxygen will reuse the documentation of the first