Updated documentation of several system classes.
authorMatthias Schmidt <gravatronics@live.com>
Wed, 3 Aug 2011 15:08:12 +0000 (17:08 +0200)
committerMatthias Schmidt <gravatronics@live.com>
Wed, 3 Aug 2011 15:08:12 +0000 (17:08 +0200)
24 files changed:
wcfsetup/install/files/lib/system/application/AbstractApplication.class.php
wcfsetup/install/files/lib/system/application/ApplicationHandler.class.php
wcfsetup/install/files/lib/system/application/IApplication.class.php
wcfsetup/install/files/lib/system/auth/UserAuth.class.php
wcfsetup/install/files/lib/system/breadcrumb/Breadcrumb.class.php
wcfsetup/install/files/lib/system/breadcrumb/Breadcrumbs.class.php
wcfsetup/install/files/lib/system/cache/CacheHandler.class.php
wcfsetup/install/files/lib/system/form/FormDocument.class.php
wcfsetup/install/files/lib/system/form/container/AbstractFormElementContainer.class.php
wcfsetup/install/files/lib/system/form/container/MultipleSelectionFormElementContainer.class.php
wcfsetup/install/files/lib/system/form/container/SelectionFormElementContainer.class.php
wcfsetup/install/files/lib/system/form/container/SingleSelectionFormElementContainer.class.php
wcfsetup/install/files/lib/system/form/element/AbstractFormElement.class.php
wcfsetup/install/files/lib/system/form/element/AbstractNamedFormElement.class.php
wcfsetup/install/files/lib/system/form/element/LabelFormElement.class.php
wcfsetup/install/files/lib/system/form/element/MultipleSelectionFormElement.class.php
wcfsetup/install/files/lib/system/form/element/PasswordInputFormElement.class.php
wcfsetup/install/files/lib/system/form/element/SingleSelectionFormElement.class.php
wcfsetup/install/files/lib/system/form/element/TextInputFormElement.class.php
wcfsetup/install/files/lib/system/image/adapter/ImageAdapter.class.php
wcfsetup/install/files/lib/system/image/adapter/ImagickImageAdapter.class.php
wcfsetup/install/files/lib/system/io/Tar.class.php
wcfsetup/install/files/lib/system/io/TarWriter.class.php
wcfsetup/install/files/lib/system/language/LanguageFactory.class.php

index c08bc3d31962844ed44b3e92c4077523e39353fa..39ab8510fddc1ac0a6a84ab02a65f193324f05fd 100644 (file)
@@ -10,7 +10,7 @@ use wcf\system\WCF;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system
+ * @subpackage system.application
  * @category   Community Framework
  */
 abstract class AbstractApplication implements IApplication {
index bee0313cf9d9c1162f938b785bc6a317f3a8d9fb..82c452aa898aa9a1c1e6ea647114202d32c1f176 100644 (file)
@@ -16,7 +16,6 @@ use wcf\system\SingletonFactory;
 class ApplicationHandler extends SingletonFactory {
        /**
         * application cache
-        *
         * @var array<array>
         */     
        protected $cache = null;
index 5ad2f3a2072c274853b85d7de7f28c9fdc5163b0..74f4d3537ceda33fca408997570cef03504c0518 100644 (file)
@@ -8,7 +8,7 @@ namespace wcf\system\application;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system
+ * @subpackage system.application
  * @category   Community Framework
  */
 interface IApplication {
index fcede6b246d84b4a39cf9b153582ddd92c6dac69..a4ad24f7b417b271c25029e9129bb9f76dd758f0 100644 (file)
@@ -16,8 +16,7 @@ use wcf\system\event\EventHandler;
 abstract class UserAuth {
        /**
         * active instance
-        *
-        * @var UserAuth
+        * @var wcf\system\auth\UserAuth
         */
        protected static $instance = null;
        
index c0bcea4e2c625b2502e5a837a11588f2c9f5e281..96180792ddde240b2ac3c0d551599bcdd53275aa 100644 (file)
@@ -15,14 +15,12 @@ use wcf\util\StringUtil;
 class Breadcrumb {
        /**
         * displayed label
-        * 
         * @var string
         */
        protected $label = '';
        
        /**
         * target url
-        * 
         * @var string
         */
        protected $url = '';
index 6ddc6721684584d941aa41c9a55a541cfa267c6a..74b64e5b36f82321f36b908b5dca49f35850fd3e 100644 (file)
@@ -15,15 +15,14 @@ use wcf\system\SingletonFactory;
 class Breadcrumbs extends SingletonFactory {
        /**
         * list of breadcrumbs
-        * 
-        * @var array<Breadcrumb>
+        * @var array<wcf\system\breadcrumb\Breadcrumb>
         */     
        protected $items = array();
        
        /**
-        * Adds a breadcrumb (insert order is crucial!)
+        * Adds a breadcrumb (insertion order is crucial!).
         * 
-        * @param       Breadcrumb              $item
+        * @param       wcf\system\breadcrumb\Breadcrumb        $item
         */     
        public function add(Breadcrumb $item) {
                $this->items[] = $item;
@@ -32,7 +31,7 @@ class Breadcrumbs extends SingletonFactory {
        /**
         * Returns the list of breadcrumbs.
         * 
-        * @return      array<Breadcrumb>
+        * @return      array<wcf\system\breadcrumb\Breadcrumb>
         */      
        public function get() {
                return $this->items;
@@ -41,8 +40,8 @@ class Breadcrumbs extends SingletonFactory {
        /**
         * Replaces a breadcrumb, returns true if replacement was successful.
         * 
-        * @param       Breadcrumb              $item
-        * @param       integer                 $index
+        * @param       wcf\system\breadcrumb\Breadcrumb        $item
+        * @param       integer         $index
         * @return      boolean
         */
        public function replace(Breadcrumb $item, $index) {
@@ -58,7 +57,7 @@ class Breadcrumbs extends SingletonFactory {
        /**
         * Removes a breadcrumb, returns true if deletion was successful.
         * 
-        * @param       integer                 $index
+        * @param       integer         $index
         * @return      boolean
         */
        public function remove($index) {
index e9235979e50f1bc4e7602745c67e5eff55dcf61f..b3505de410796ee9038a0f5b1374f5585422fc08 100644 (file)
@@ -16,15 +16,13 @@ use wcf\util\StringUtil;
  */
 class CacheHandler extends SingletonFactory {
        /**
-        * Registered cache resources.
-        * 
+        * registered cache resources
         * @var array
         */
        protected $cacheResources = array();
        
        /**
         * cache source object
-        * 
         * @var wcf\system\cache\source\ICacheSource
         */
        protected $cacheSource = null;
@@ -157,7 +155,7 @@ class CacheHandler extends SingletonFactory {
        /**
         * Returns the cache source object.
         *
-        * @return      CacheSource
+        * @return      wcf\system\cache\source\ICacheSource
         */
        public function getCacheSource() {
                return $this->cacheSource;
index 1758680922b22457e70f3b5c062c9ab9bd6e5edb..160365941ebac2ca3a0f8d4a099d9675df327120 100644 (file)
@@ -15,14 +15,12 @@ use wcf\util\StringUtil;
 class FormDocument {
        /**
         * list of FormElementContainer objects
-        *
         * @var array<wcf\system\form\IFormElementContainer>
         */
        protected $containers = array();
        
        /**
         * form document name
-        *
         * @var string
         */
        protected $name = '';
index e4cdcec0e5ae3beea2912eff868a7545dfc5851b..5b9af14b4f344dec2aec1b1f5bfa19c6e8f19256 100644 (file)
@@ -12,27 +12,24 @@ use wcf\util\StringUtil;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.container
  * @category   Community Framework
  */
 abstract class AbstractFormElementContainer implements IFormElementContainer {
        /**
-        * list of FormElement objects
-        *
+        * list of IFormElement objects
         * @var array<wcf\system\form\IFormElement>
         */
        protected $children = array();
        
        /**
         * element description or help text
-        *
         * @var string
         */
        protected $description = '';
        
        /**
         * element label
-        *
         * @var string
         */
        protected $label = '';
index ac65a137662fb243e7968e505d59ab4917e36d1e..425d550bdfc4581176dac34a995f545b1e0f9855 100644 (file)
@@ -8,13 +8,12 @@ namespace wcf\system\form\container;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.container
  * @category   Community Framework
  */
 class MultipleSelectionFormElementContainer extends SelectionFormElementContainer {
        /**
         * container value
-        *
         * @var array
         */
        protected $value = array();
index 0eecc8cd259925d548bef5cda4c1b5d21f0e1829..1380ab033d78e6e45655ac6f31fe5541ec46006f 100644 (file)
@@ -8,13 +8,12 @@ namespace wcf\system\form\container;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.container
  * @category   Community Framework
  */
 abstract class SelectionFormElementContainer extends AbstractFormElementContainer {
        /**
         * container name
-        *
         * @var string
         */
        protected $name = '';
index 5961c1622bafb32c54a568837d028d84cd6f6127..99ffc0bdc81d19f3461e8fb243cc1145fb147411 100644 (file)
@@ -8,13 +8,12 @@ namespace wcf\system\form\container;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.container
  * @category   Community Framework
  */
 class SingleSelectionFormElementContainer extends SelectionFormElementContainer {
        /**
         * container value
-        *
         * @var string
         */
        protected $value = '';
index 3035f58961e26e460c25a5893b5da2f12098e475..7aa006614739c68e093dd425d776a95e97b70056 100644 (file)
@@ -11,27 +11,24 @@ use wcf\util\StringUtil;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.element
  * @category   Community Framework
  */
 abstract class AbstractFormElement implements IFormElement {
        /**
         * element description or help text
-        *
         * @var string
         */
        protected $description = '';
        
        /**
         * element label
-        *
         * @var string
         */
        protected $label = '';
        
        /**
         * FormElementContainer object
-        *
         * @var wcf\system\form\IFormElementContainer
         */
        protected $parent = null;
index db80e015ad94fd3c499e3384d4a696bac2b0fdaf..4559bf02a561a0d83215e890064d10023e38336e 100644 (file)
@@ -9,20 +9,18 @@ use wcf\util\StringUtil;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.element
  * @category   Community Framework
  */
 abstract class AbstractNamedFormElement extends AbstractFormElement {
        /**
         * element name
-        *
         * @var string
         */
        protected $name = '';
        
        /**
         * element value
-        *
         * @var string
         */
        protected $value = '';
index 30a16c2dc1d532e03e05368973f23fce36d5374a..802dfa185b287dc84a89ab6b78b092df83cd92de 100644 (file)
@@ -9,13 +9,12 @@ use wcf\system\util\StringUtil;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.element
  * @category   Community Framework
  */
 class LabelFormElement extends AbstractFormElement {
        /**
         * element text
-        *
         * @var string
         */
        protected $text = '';
index 3dfbc6d5407656e34bfeca5274254500cd9c3cc1..65311695d72d91d400d1358ef08a708b4805e5b2 100644 (file)
@@ -8,7 +8,7 @@ namespace wcf\system\form\element;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.element
  * @category   Community Framework
  */
 class MultipleSelectionFormElement extends AbstractNamedFormElement {
index 8b8589d700afa9afedf2ff95f9dfc330fd8198d8..e1e36395f755d204334403af8a2688e6d2e304e8 100644 (file)
@@ -9,7 +9,7 @@ use wcf\util\StringUtil;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.element
  * @category   Community Framework
  */
 class PasswordInputFormElement extends AbstractNamedFormElement {
index e3a6c811607146119bb12489ee10c7d426a9131d..d1fd6d9d55c68fa42a7a63cb57c39417e1f924e8 100644 (file)
@@ -8,7 +8,7 @@ namespace wcf\system\form\element;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.element
  * @category   Community Framework
  */
 class SingleSelectionFormElement extends AbstractNamedFormElement {
index 7a41b9b8b2baed98540392f3710fda525f05c4b5..01e0bdd25a58005b679554c20ba37c0c7ea7664a 100644 (file)
@@ -9,7 +9,7 @@ use wcf\util\StringUtil;
  * @copyright  2001-2011 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
  * @package    com.woltlab.wcf
- * @subpackage system.form
+ * @subpackage system.form.element
  * @category   Community Framework
  */
 class TextInputFormElement extends AbstractNamedFormElement {
index 626d0a785d67eaf9a2aefead2357a50a9d6b0de1..eac4360e41bd22acf9dd051d6467f5ebe5cf05c7 100644 (file)
@@ -15,7 +15,6 @@ use wcf\system\session\SystemException;
 class ImageAdapter implements IImageAdapter {
        /**
         * IImageAdapter object
-        * 
         * @var IImageAdapter
         */
        protected $adapter = null;
index 99efd8c141a92ee2336d8d6d0f52b936c5e805ff..9db0a8dc311cc15f1c53518b41d7fb0f053c4b2a 100644 (file)
@@ -15,14 +15,12 @@ use wcf\system\exception\SystemException;
 class ImagickImageAdapter implements IImageAdapter {
        /**
         * active color
-        * 
         * @var \ImagickPixel
         */
        protected $color = null;
        
        /**
         * Imagick object
-        * 
         * @var \Imagick
         */
        protected $imagick = null;
index 42f48059c9a7bd7c14dad3794b0fb2e8b1a002fa..d1611a780434cbc57463815aae90a0db8198109e 100644 (file)
@@ -22,12 +22,46 @@ use wcf\util\FileUtil;
  * @category   Community Framework
  */
 class Tar {
+       /**
+        * name of the archive
+        * @var string
+        */
        protected $archiveName = '';
+       
+       /**
+        * content of the tar file
+        * @var array
+        */
        protected $contentList = array();
+       
+       /**
+        * indicates if tar file is opened
+        * @var boolean
+        */
        protected $opened = false;
+       
+       /**
+        * indicates if file content has been read
+        * @var boolean
+        */
        protected $read = false;
+       
+       /**
+        * file object
+        * @var wcf\system\io\File
+        */
        protected $file = null;
+       
+       /**
+        * indicates if the tar file is (g)zipped
+        * @var boolean
+        */
        protected $isZipped = false;
+       
+       /**
+        * file access mode
+        * @var string
+        */
        protected $mode = 'rb';
        
        /**
index df6ac2e4c16fb85f35cd81493d75b4de11a5cc91..0dd0061c4958ad1646b9492cdac901a8d009bd26 100644 (file)
@@ -20,6 +20,9 @@ use wcf\util\FileUtil;
  * @category   Community Framework
  */
 class TarWriter extends Tar {
+       /**
+        * @see wcf\system\io\Tar::$mode
+        */
        protected $mode = 'wb+';
        
        /**
index b84b0ccd911384ecd9ac04dba877933b982918a3..f426954fa75a4c2880affd09dae10ae750d03959 100644 (file)
@@ -18,31 +18,28 @@ use wcf\util\StringUtil;
  */
 abstract class LanguageFactory {
        /**
-        * Language cache.
-        *
+        * Language cache
         * @var array<array>
         */
        private static $cache = null;
        
        /**
-        * Initialized languages.
-        *
-        * @var array<Language>
+        * Initialized languages
+        * @var array<wcf\data\language\Language>
         */
        private static $languages = array();
        
        /**
         * Active template scripting compiler
-        *
-        * @var TemplateScriptingCompiler
+        * @var wcf\system\template\TemplateScriptingCompiler
         */
        private static $scriptingCompiler = null;
        
        /**
-        * Returns a Language-object for each requested language id.
+        * Returns a Language-object for the requested language id.
         *
         * @param       integer         $languageID
-        * @return      Language
+        * @return      wcf\data\language\Language
         */
        public static function getLanguage($languageID) {
                if (self::$cache === null) self::loadCache();
@@ -91,7 +88,7 @@ abstract class LanguageFactory {
        /**
         * Returns a list of available language categories.
         * 
-        * @return      array
+        * @return      array<string>
         */     
        public static function getCategories() {
                $categories = array();
@@ -171,7 +168,7 @@ abstract class LanguageFactory {
         * Returns an instance of Language or NULL for a given language code.
         *
         * @param       string          $languageCode
-        * @return      Language
+        * @return      wcf\data\language\Language
         */
        public static function getLanguageByCode($languageCode) {
                if (self::$cache === null) self::loadCache();
@@ -196,7 +193,7 @@ abstract class LanguageFactory {
        /**
         * Returns the active scripting compiler object.
         *
-        * @return      TemplateScriptingCompiler
+        * @return      wcf\system\template\TemplateScriptingCompiler
         */
        public static function getScriptingCompiler() {
                if (self::$scriptingCompiler === null) {
@@ -237,10 +234,8 @@ abstract class LanguageFactory {
         * @param       integer         $languageID
         */
        private static function setLocale($languageID) {
-               // set locale for
-               // string comparison
-               // character classification and conversion
-               // date and time formatting
+               // set locale for string comparison, character classification and
+               // conversion and date and time formatting
                setlocale(LC_COLLATE, self::$languages[$languageID]->get('wcf.global.locale.unix').'.UTF-8', self::$languages[$languageID]->get('wcf.global.locale.unix'), self::$languages[$languageID]->get('wcf.global.locale.win'));
                setlocale(LC_CTYPE, self::$languages[$languageID]->get('wcf.global.locale.unix').'.UTF-8', self::$languages[$languageID]->get('wcf.global.locale.unix'), self::$languages[$languageID]->get('wcf.global.locale.win'));
        }
@@ -280,6 +275,7 @@ abstract class LanguageFactory {
                                }
                        }
                }
+               
                return $availableLanguages;
        }
        
@@ -308,9 +304,10 @@ abstract class LanguageFactory {
        }
        
        /**
-        * Returns an ordered list of all installed languages.
+        * Returns an ordered list with the names all installed languages in the
+        * active language.
         * 
-        * @return      array
+        * @return      array<string>
         */     
        public static function getLanguages() {
                $languages = array();
@@ -319,22 +316,21 @@ abstract class LanguageFactory {
                }
                
                StringUtil::sort($languages);
-               
                return $languages;
        }
        
        /**
-        * Returns a sorted list of all installed language codes.
+        * Returns an ordered list of all installed language codes.
         * 
-        * @return      array
+        * @return      array<string>
         */
        public static function getLanguageCodes() {
-               $languages = array();
+               $languageCodes = array();
                foreach (self::$cache['codes'] as $languageCode => $languageID) {
-                       $languages[$languageID] = $languageCode;
+                       $languageCodes[$languageID] = $languageCode;
                }
                
-               StringUtil::sort($languages);
-               return $languages;
+               StringUtil::sort($languageCodes);
+               return $languageCodes;
        }
 }