From: Fran Rogers <krimpet@users.mediawiki.org>
Date: Wed, 6 Aug 2008 03:55:49 +0000 (+0000)
Subject: Wrapped certain tricky constructs in @cond/@endcond to prevent Doxygen
X-Git-Tag: 1.31.0-rc.0~46097
X-Git-Url: https://git.cyclocoop.org/%242?a=commitdiff_plain;h=851eaecd50ad45dc0ff7c7b43dc1b5fad486c2e9;p=lhc%2Fweb%2Fwiklou.git

Wrapped certain tricky constructs in @cond/@endcond to prevent Doxygen
from choking on them and segfaulting.
---

diff --git a/includes/GlobalFunctions.php b/includes/GlobalFunctions.php
index c5d5f1f567..cfdec5cd4a 100644
--- a/includes/GlobalFunctions.php
+++ b/includes/GlobalFunctions.php
@@ -12,6 +12,9 @@ require_once dirname(__FILE__) . '/LogPage.php';
 require_once dirname(__FILE__) . '/normal/UtfNormalUtil.php';
 require_once dirname(__FILE__) . '/XmlFunctions.php';
 
+// Hide compatibility functions from Doxygen
+/// @cond
+
 /**
  * Compatibility functions
  *
@@ -87,6 +90,9 @@ if ( !function_exists( 'array_diff_key' ) ) {
 	}
 }
 
+/// @endcond
+
+
 /**
  * Like array_diff( $a, $b ) except that it works with two-dimensional arrays.
  */
diff --git a/includes/SiteConfiguration.php b/includes/SiteConfiguration.php
index 6cdd508222..73aae1adc9 100644
--- a/includes/SiteConfiguration.php
+++ b/includes/SiteConfiguration.php
@@ -5,8 +5,12 @@
  * meaning that require_once() fails to detect that it is including the same
  * file again. We use DIY C-style protection as a workaround.
  */
+
+// Hide this pattern from Doxygen, which spazzes out at it
+/// @cond
 if (!defined('SITE_CONFIGURATION')) {
 define('SITE_CONFIGURATION', 1);
+/// @endcond
 
 /**
  * This is a class used to hold configuration settings, particularly for multi-wiki sites.
diff --git a/includes/api/ApiFormatJson_json.php b/includes/api/ApiFormatJson_json.php
index 2418f02e6b..9714ab80e6 100644
--- a/includes/api/ApiFormatJson_json.php
+++ b/includes/api/ApiFormatJson_json.php
@@ -812,6 +812,9 @@ class Services_JSON
     }
 }
 
+
+// Hide the PEAR_Error variant from Doxygen
+/// @cond
 if (class_exists('PEAR_Error')) {
 
     /**
@@ -827,6 +830,7 @@ if (class_exists('PEAR_Error')) {
     }
 
 } else {
+/// @endcond
 
     /**
      * @todo Ultimately, this class shall be descended from PEAR_Error