From bb899ba1b24920537ec2d1961e6df02c53108190 Mon Sep 17 00:00:00 2001
From: Ulf Gebhardt <ulf.gebhardt@webcraft-media.de>
Date: Wed, 8 Jun 2016 19:30:35 +0200
Subject: [PATCH] #3 docu lib

---
 lib/lib.php          | 44 ++++++++++++++++++++++++++++++++++++++++----
 lib/lib_controll.php | 38 +++++++++++++++++++++++++++++++++++---
 lib/lib_css.php      | 22 +++++++++++++++++++++-
 lib/lib_js.php       | 20 ++++++++++++++++++++
 lib/lib_jscss.php    | 26 ++++++++++++++++++++++++++
 lib/lib_php.php      | 27 ++++++++++++++++++++++-----
 6 files changed, 164 insertions(+), 13 deletions(-)

diff --git a/lib/lib.php b/lib/lib.php
index 7eee58d..1e32a9c 100644
--- a/lib/lib.php
+++ b/lib/lib.php
@@ -1,20 +1,56 @@
 <?php
+/**
+ * System - PHP Framework
+ *
+ * PHP Version 5.6
+ *
+ * @copyright   2016 Ulf Gebhardt (http://www.webcraft-media.de)
+ * @license     http://www.opensource.org/licenses/mit-license.php MIT
+ * @link        https://github.com/webcraftmedia/system
+ * @package     SYSTEM\LIB
+ */
 namespace LIB;
+
+/**
+ * Lib Class provided by System to define API to load libs.
+ * @todo better abstraction model
+ */
 abstract class lib {
+    /**
+     * Call php lib include
+     *
+     * @return bool Returns true or false depending if lib could be loaded.
+     */
     public static function php(){
         if(!\method_exists(static::get_class(), 'php_autoload')){
             throw new \SYSTEM\LOG\ERROR('Function php_autoload not implemented in '.static::get_class());}
         return static::php_autoload();}
+    
+    /**
+     * Call css lib include
+     *
+     * @return string Returns path of the css lib to be included.
+     */
     public static function css(){
          if(!\method_exists(static::get_class(), 'css_path')){
             throw new \SYSTEM\LOG\ERROR('Function css_path not implemented in '.static::get_class());}
-        return static::css_path(); //use tpl here? yes? any negative effex?
-    }
+        return static::css_path();}
+        
+    /**
+     * Call js lib include
+     *
+     * @return string Returns path of the js lib to be included.
+     */
     public static function js(){
          if(!\method_exists(static::get_class(), 'js_path')){
             throw new \SYSTEM\LOG\ERROR('Function js_path not implemented in '.static::get_class());}
-        return static::js_path();
-    }
+        return static::js_path();}
+        
+    /**
+     * Default Version for every lib if not overritten by derived class
+     *
+     * @return string Returns version string of the library.
+     */
     public static function version(){
         return 'The library '.static::get_class().' did not specify a version';}
 }
\ No newline at end of file
diff --git a/lib/lib_controll.php b/lib/lib_controll.php
index d87bd76..1949d08 100644
--- a/lib/lib_controll.php
+++ b/lib/lib_controll.php
@@ -1,20 +1,52 @@
 <?php
+/**
+ * System - PHP Framework
+ *
+ * PHP Version 5.6
+ *
+ * @copyright   2016 Ulf Gebhardt (http://www.webcraft-media.de)
+ * @license     http://www.opensource.org/licenses/mit-license.php MIT
+ * @link        https://github.com/webcraftmedia/system
+ * @package     SYSTEM\LIB
+ */
 namespace LIB;
+
+/**
+ * lib_controll Class provided by System to register libs.
+ */
 class lib_controll {
+    /** array Variable to store all registred libs*/
     private static $libs = array();
+    
+    /**
+     * Check if given class is a valid lib
+     *
+     * @param string $lib Lib Class
+     * @return bool Returns true or false.
+     */
     private static function check_lib($lib){
         if( !\class_exists($lib) ||
             !\is_array($parents = \class_parents($lib)) ||
             !\array_search('LIB\lib', $parents)){
             return false;}
         return true;}
-        
+    
+    /**
+     * Register given class as lib
+     *
+     * @param string $classname Lib Class
+     * @return null Returns null.
+     */
     public static function register($classname){
         if(!self::check_lib($classname)){
             throw new \SYSTEM\LOG\ERROR('Problem with your lib class: '.$classname.'; it might not be available or inherits from the wrong class!');}
-        array_push(self::$libs,$classname);
-    }
+        array_push(self::$libs,$classname);}
     
+    /**
+     * Get all registered libs available
+     *
+     * @return array Returns array with lib classes.
+     */
     public static function all(){
         return self::$libs;}
 }
\ No newline at end of file
diff --git a/lib/lib_css.php b/lib/lib_css.php
index 356edd9..30b2581 100644
--- a/lib/lib_css.php
+++ b/lib/lib_css.php
@@ -1,5 +1,25 @@
 <?php
+/**
+ * System - PHP Framework
+ *
+ * PHP Version 5.6
+ *
+ * @copyright   2016 Ulf Gebhardt (http://www.webcraft-media.de)
+ * @license     http://www.opensource.org/licenses/mit-license.php MIT
+ * @link        https://github.com/webcraftmedia/system
+ * @package     SYSTEM\LIB
+ */
 namespace LIB;
+
+/**
+ * css lib Class provided by System to provide css libs.
+ * @todo better abstraction model
+ */
 abstract class lib_css extends lib{
-    protected static function css_path(){} //css webpath
+    /**
+     * Get Css lib include path
+     *
+     * @return string Returns path of the css lib to be included (webpath).
+     */
+    protected static function css_path(){}    
 }
\ No newline at end of file
diff --git a/lib/lib_js.php b/lib/lib_js.php
index 4bf71ae..b3c9a0f 100644
--- a/lib/lib_js.php
+++ b/lib/lib_js.php
@@ -1,5 +1,25 @@
 <?php
+/**
+ * System - PHP Framework
+ *
+ * PHP Version 5.6
+ *
+ * @copyright   2016 Ulf Gebhardt (http://www.webcraft-media.de)
+ * @license     http://www.opensource.org/licenses/mit-license.php MIT
+ * @link        https://github.com/webcraftmedia/system
+ * @package     SYSTEM\LIB
+ */
 namespace LIB;
+
+/**
+ * js lib Class provided by System to provide js libs.
+ * @todo better abstraction model
+ */
 abstract class lib_js extends lib{
+    /**
+     * Get js lib include path
+     *
+     * @return string Returns path of the js lib to be included (webpath).
+     */
     protected static function js_path(){} //js webpath
 }
\ No newline at end of file
diff --git a/lib/lib_jscss.php b/lib/lib_jscss.php
index a2042f1..c631cb1 100644
--- a/lib/lib_jscss.php
+++ b/lib/lib_jscss.php
@@ -1,6 +1,32 @@
 <?php
+/**
+ * System - PHP Framework
+ *
+ * PHP Version 5.6
+ *
+ * @copyright   2016 Ulf Gebhardt (http://www.webcraft-media.de)
+ * @license     http://www.opensource.org/licenses/mit-license.php MIT
+ * @link        https://github.com/webcraftmedia/system
+ * @package     SYSTEM\LIB
+ */
 namespace LIB;
+
+/**
+ * js+css lib Class provided by System to provide js+css libs.
+ * @todo better abstraction model
+ */
 abstract class lib_jscss extends lib{
+    /**
+     * Get js lib include path
+     *
+     * @return string Returns path of the js lib to be included (webpath).
+     */
     protected static function js_path(){}
+    
+    /**
+     * Get Css lib include path
+     *
+     * @return string Returns path of the css lib to be included (webpath).
+     */
     protected static function css_path(){}
 }
\ No newline at end of file
diff --git a/lib/lib_php.php b/lib/lib_php.php
index 53785ee..6805921 100644
--- a/lib/lib_php.php
+++ b/lib/lib_php.php
@@ -1,8 +1,25 @@
 <?php
+/**
+ * System - PHP Framework
+ *
+ * PHP Version 5.6
+ *
+ * @copyright   2016 Ulf Gebhardt (http://www.webcraft-media.de)
+ * @license     http://www.opensource.org/licenses/mit-license.php MIT
+ * @link        https://github.com/webcraftmedia/system
+ * @package     SYSTEM\LIB
+ */
 namespace LIB;
-//dont use system paths? for php yes - for js css not possibledue webpath -> PLIB object?
-//or mask all paths using api
-abstract class lib_php extends lib{
-    protected static function php_autoload(){} //autload magic? require_once lib\autoload.inc -> should do the trick -> do that in lib
-}
 
+/**
+ * php lib Class provided by System to provide php libs.
+ * @todo better abstraction model
+ */
+abstract class lib_php extends lib{
+    /**
+     * include the php files to be used
+     *
+     * @return null Returns null
+     */
+    protected static function php_autoload(){}
+}
\ No newline at end of file