Adding doc comments to Configure and App.

This commit is contained in:
mark_story 2010-11-14 18:26:54 -05:00
parent b91566d35f
commit 1631f31460
2 changed files with 33 additions and 6 deletions

View file

@ -1,6 +1,6 @@
<?php
/**
* Configure class
* App class
*
* PHP 5
*
@ -18,7 +18,29 @@
* @license MIT License (http://www.opensource.org/licenses/mit-license.php)
*/
/**
* Class/file loader and path management.
* App is responsible for path managment, class location and class loading.
*
* ### Adding paths
*
* You can add paths to the search indexes App uses to find classes using `App::build()`. Adding
* additional controller paths for example would alter where CakePHP looks for controllers when you
* call App::import('Controller', 'Posts'); This allows you to split your application up across the filesystem.
*
* ### Inspecting loaded paths
*
* You can inspect the currently loaded paths using `App::path('controller')` for example to see loaded
* controller paths.
*
* ### Locating plugins and themes
*
* Plugins and Themes can be located with App as well. Using App::pluginPath('DebugKit') for example, will
* give you the full path to the DebugKit plugin. App::themePath('purple'), would give the full path to the
* `purple` theme.
*
* ### Inspecting known objects
*
* You can find out which objects App knows about using App::objects('controller') for example to find
* which application controllers App knows about.
*
* @link http://book.cakephp.org/view/933/The-App-Class
* @package cake

View file

@ -19,7 +19,11 @@
*/
/**
* Configuration class (singleton). Used for managing runtime configuration information.
* Configuration class. Used for managing runtime configuration information.
*
* Provides features for reading and writing to the runtime configuration, as well
* as methods for loading additional configuration files or storing runtime configuration
* for future use.
*
* @package cake
* @subpackage cake.cake.libs
@ -46,7 +50,7 @@ class Configure {
}
/**
* Used to store a dynamic variable in the Configure instance.
* Used to store a dynamic variable in Configure.
*
* Usage:
* {{{
@ -126,7 +130,7 @@ class Configure {
}
/**
* Used to read information stored in the Configure instance. Currently its not
* Used to read information stored in Configure. Its not
* possible to store `null` values in Configure.
*
* Usage:
@ -173,7 +177,7 @@ class Configure {
}
/**
* Used to delete a variable from the Configure instance.
* Used to delete a variable from Configure.
*
* Usage:
* {{{
@ -197,6 +201,7 @@ class Configure {
/**
* Loads a file from app/config/configure_file.php.
*
* Config file variables should be formated like:
* `$config['name'] = 'value';`
* These will be used to create dynamic Configure vars. load() is also used to