From 6c803cf91d07f4c3ca6096587bb0c5569ec7d800 Mon Sep 17 00:00:00 2001
From: hickert <hickert@594d385d-05f5-0310-b6e9-bd551577e9d8>
Date: Wed, 18 Jan 2006 07:50:18 +0000
Subject: [PATCH] Added some comments

git-svn-id: https://oss.gonicus.de/repositories/gosa/trunk@2512 594d385d-05f5-0310-b6e9-bd551577e9d8
---
 include/class_config.inc | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/include/class_config.inc b/include/class_config.inc
index 505e48563..ae0b8f63d 100644
--- a/include/class_config.inc
+++ b/include/class_config.inc
@@ -462,45 +462,73 @@ class config  {
 	$arr = array();
 	
   	$this->idepartments= array();
+
+	/* Create multidimensional array, with all departments.
+     */
 	foreach ($this->departments as $key => $val){
 
+		/* remove base from dn */
 		$val2 = str_replace($base,"",$val);
 
+		/* Get every single ou */
 		$str = preg_replace("/ou=/","|ou=",$val2);	
 		$elements = array_reverse(split("\|",$str)); 		
 
+		/* Save last array position */
 		$last = &$arr;
+
+		/* Get array depth  */
 		$cnt = count($elements);
+
+		/* Add last ou element of current dn to our array */
 		foreach($elements as $key => $ele){
 		
+			/* skip enpty */
 			if(empty($ele)) continue;
+
+			/* Extract department name */		
 			$elestr = preg_replace("/^ou=/","", $ele);
 			$elestr = preg_replace("/,$/","",$elestr);	
+
+			/* Add to array */	
 			if($key == ($cnt-2)){
 				$last[$elestr]['ENTRY'] = $val;
 			}
+
+			/* Set next array appending position */
 			$last = &$last[$elestr]['SUB'];
 		}
 	}
+	
+	/* Add base entry */
 	$ret["/"]["ENTRY"] 	= $base;
 	$ret["/"]["SUB"]	= $arr;
 	
 	$this->idepartments= $this->generateDepartmentArray($ret,-1,$max_size);
   }
 
+	/* Creates display friendly output from make_idepartments
+     */
 	function generateDepartmentArray($arr,$depth = -1,$max_size){
 		$ret = array();
 		$depth ++;
-
+	
+		/* Walk through array */	
 		foreach($arr as $name => $entries){
 
+			/* If this department is the last in the current tree position 
+             * remove it, to avoid generating output for it 
+             */
 			if(count($entries['SUB'])==0){
 				unset($entries['SUB']);
 			}
+
+			/* Check if current name is too long, then cut it */
 			if(strlen($name)> $max_size){
 				$name = substr($name,0,($max_size-3))." ...";
 			}
-	
+
+			/* Append the name to the list */	
 			if(isset($entries['ENTRY'])){
 				$a = "";
 				for($i = 0 ; $i < $depth ; $i ++){
@@ -522,6 +550,8 @@ class config  {
 				}
 			}	
 			*/
+
+			/* recursive add of subdepartments */
 			if(isset($entries['SUB'])){
 				$ret = array_merge($ret,$this->generateDepartmentArray($entries['SUB'],$depth,$max_size));
 			}
-- 
2.30.2