Index: branches/1.2.x/units/sections/categories/e_category_eh.php
===================================================================
diff -u -N -r14562 -r14622
--- branches/1.2.x/units/sections/categories/e_category_eh.php	(.../e_category_eh.php)	(revision 14562)
+++ branches/1.2.x/units/sections/categories/e_category_eh.php	(.../e_category_eh.php)	(revision 14622)
@@ -28,11 +28,13 @@
 		}
 
 		/**
-		 * Permission exceptions
+		 * Checks user permission to execute given $event
 		 *
 		 * @param kEvent $event
+		 * @return bool
+		 * @access public
 		 */
-		function CheckPermission(&$event)
+		public function CheckPermission(&$event)
 		{
 			$skip_permissions_check_events = Array (
 				'OnAnotherCustomEvent',
@@ -66,11 +68,14 @@
 		}
 
 		/**
-		 * Sets custom query for the list
+		 * Apply any custom changes to list's sql query
 		 *
 		 * @param kEvent $event
+		 * @return void
+		 * @access protected
+		 * @see kDBEventHandler::OnListBuild()
 		 */
-		function SetCustomQuery(&$event)
+		protected function SetCustomQuery(&$event)
 		{
 			parent::SetCustomQuery($event);
 
@@ -89,23 +94,27 @@
 		}
 
 		/**
-		 * Before new item created
+		 * Sets correct status for new categories created on front-end
 		 *
 		 * @param kEvent $event
+		 * @return void
+		 * @access protected
 		 */
-		function OnBeforeItemCreate(&$event)
+		protected function OnBeforeItemCreate(&$event)
 		{
 			parent::OnBeforeItemCreate($event);
 
 
 		}
 
 		/**
-		 * Before existing item updated
+		 * Sets correct status for new categories created on front-end
 		 *
 		 * @param kEvent $event
+		 * @return void
+		 * @access protected
 		 */
-		function OnBeforeItemUpdate(&$event)
+		protected function OnBeforeItemUpdate(&$event)
 		{
 			parent::OnBeforeItemUpdate($event);
 
@@ -136,13 +145,14 @@
 
 		}
 
-
 		/**
-		 * After new item created
+		 * Occurs after creating item
 		 *
 		 * @param kEvent $event
+		 * @return void
+		 * @access protected
 		 */
-		function OnAfterItemCreate(&$event)
+		protected function OnAfterItemCreate(&$event)
 		{
 			parent::OnAfterItemCreate($event);
 
@@ -174,11 +184,13 @@
 		}
 
 		/**
-		 * After item loaded
+		 * Removes this item and it's children (recursive) from structure dropdown
 		 *
 		 * @param kEvent $event
+		 * @return void
+		 * @access protected
 		 */
-		function OnAfterItemLoad(&$event)
+		protected function OnAfterItemLoad(&$event)
 		{
 			parent::OnAfterItemLoad($event);