From 67325f986a8516100bc18eec4e77504bce72a7a3 Mon Sep 17 00:00:00 2001
From: Garvin Hicking <mail@garv.in>
Date: Tue, 5 Jun 2007 07:58:47 +0000
Subject: [PATCH] Beautify, add missing code comments

---
 include/functions_config.inc.php  | 17 +++++++++++++++++
 include/functions_entries.inc.php | 20 +++++++++-----------
 2 files changed, 26 insertions(+), 11 deletions(-)

diff --git a/include/functions_config.inc.php b/include/functions_config.inc.php
index d7314543..f9dcb83c 100644
--- a/include/functions_config.inc.php
+++ b/include/functions_config.inc.php
@@ -460,6 +460,9 @@ function serendipity_checkAutologin($ident, $iv) {
     return $cookie;
 }
 
+/**
+ * Set a session cookie which can identify a user accross http/https boundaries
+ */
 function serendipity_setAuthorToken() {
     $hash = sha1(uniqid(rand(), true));
     serendipity_setCookie('author_token', $hash);
@@ -1950,6 +1953,13 @@ function serendipity_setFormToken($type = 'form') {
     }
 }
 
+/**
+ * Load available/configured options for a specific theme (through config.inc.php of a template directory)
+ * into an array.
+ *
+ * @param   array   Referenced variable coming from the config.inc.php file, where the config values will be stored in
+ * @return  array   Final return array with default values
+ */
 function &serendipity_loadThemeOptions(&$template_config) {
     global $serendipity;
     $_template_vars =& serendipity_db_query("SELECT name, value FROM {$serendipity['dbPrefix']}options
@@ -1969,6 +1979,13 @@ function &serendipity_loadThemeOptions(&$template_config) {
     return $template_vars;
 }
 
+/**
+ * Check if a member of a group has permissions to execute a plugin
+ *
+ * @param string    Pluginname
+ * @param int       ID of the group of which the members should be checked
+ * @return boolean
+ */
 function serendipity_hasPluginPermissions($plugin, $groupid = null) {
     static $forbidden = null;
     global $serendipity;
diff --git a/include/functions_entries.inc.php b/include/functions_entries.inc.php
index f5d350e2..673f5c14 100644
--- a/include/functions_entries.inc.php
+++ b/include/functions_entries.inc.php
@@ -952,17 +952,15 @@ function serendipity_printEntries($entries, $extended = 0, $preview = false, $sm
                 $entry['is_cached'] = true;
             }
 
-	    //--JAM: Highlight-span search terms
-	    if ($serendipity['action'] == 'search') {
-	        $searchterms = str_replace('"', '', $serendipity['GET']['searchterms']);
-	        $searchterms = explode($searchterms, ' ');
-		foreach($searchterms as $searchdx => $searchterm) {
-		    $searchclass = "foundterm foundterm".$searchdx;
-		    $entry['body'] = preg_replace('/('.$searchterm.')/mi',
-		        '<span class="'.$searchclass.'">\1</span>',
-			$entry['body']);
-		}
-	    }
+            //--JAM: Highlight-span search terms
+            if ($serendipity['action'] == 'search') {
+                $searchterms = str_replace('"', '', $serendipity['GET']['searchterms']);
+                $searchterms = explode($searchterms, ' ');
+                foreach($searchterms as $searchdx => $searchterm) {
+                    $searchclass = "foundterm foundterm".$searchdx;
+                    $entry['body'] = preg_replace('/('.$searchterm.')/mi', '<span class="'.$searchclass.'">\1</span>', $entry['body']);
+                }
+            }
 
             if (!empty($entry['properties']['ep_cache_extended'])) {
                 $entry['extended']  = &$entry['properties']['ep_cache_extended'];