Skip to content

Commit

Permalink
Changing a bunch of links in doc blocks
Browse files Browse the repository at this point in the history
  • Loading branch information
lorenzo committed Oct 15, 2011
1 parent f8772dc commit 6709170
Show file tree
Hide file tree
Showing 6 changed files with 29 additions and 33 deletions.
2 changes: 1 addition & 1 deletion lib/Cake/Configure/PhpReader.php
Expand Up @@ -11,7 +11,7 @@
* Redistributions of files must retain the above copyright notice
*
* @copyright Copyright 2005-2011, Cake Software Foundation, Inc. (http://cakefoundation.org)
* @link http://book.cakephp.org/view/1196/Testing CakePHP(tm) Tests
* @link http://book.cakephp.org/2.0/en/development/configuration.html#loading-configuration-files CakePHP(tm) Configuration
* @package Cake.Configure
* @since CakePHP(tm) v 2.0
* @license MIT License (http://www.opensource.org/licenses/mit-license.php)
Expand Down
2 changes: 1 addition & 1 deletion lib/Cake/Console/Command/BakeShell.php
Expand Up @@ -26,7 +26,7 @@
* Bake is a command-line code generation utility for automating programmer chores.
*
* @package Cake.Console.Command
* @link http://book.cakephp.org/view/1522/Code-Generation-with-Bake
* @link http://book.cakephp.org/2.0/en/console-and-shells/code-generation-with-bake.html
*/
class BakeShell extends Shell {

Expand Down
2 changes: 1 addition & 1 deletion lib/Cake/Console/Command/SchemaShell.php
Expand Up @@ -26,7 +26,7 @@
* Schema is a command-line database management utility for automating programmer chores.
*
* @package Cake.Console.Command
* @link http://book.cakephp.org/view/1523/Schema-management-and-migrations
* @link http://book.cakephp.org/2.0/en/console-and-shells/schema-management-and-migrations.html
*/
class SchemaShell extends Shell {

Expand Down
8 changes: 4 additions & 4 deletions lib/Cake/Controller/Component/AclComponent.php
Expand Up @@ -29,7 +29,7 @@
* implementations should extend `AclBase` and implement the methods it defines.
*
* @package Cake.Controller.Component
* @link http://book.cakephp.org/view/1242/Access-Control-Lists
* @link http://book.cakephp.org/2.0/en/core-libraries/components/access-control-lists.html
*/
class AclComponent extends Component {

Expand Down Expand Up @@ -288,7 +288,7 @@ public function initialize($component) {
* @param string $aco ACO The controlled object identifier.
* @param string $action Action (defaults to *)
* @return boolean Success (true if ARO has access to action in ACO, false otherwise)
* @link http://book.cakephp.org/view/1249/Checking-Permissions-The-ACL-Component
* @link http://book.cakephp.org/2.0/en/core-libraries/components/access-control-lists.html#checking-permissions-the-acl-component
*/
public function check($aro, $aco, $action = "*") {
if ($aro == null || $aco == null) {
Expand Down Expand Up @@ -376,7 +376,7 @@ public function check($aro, $aco, $action = "*") {
* @param string $actions Action (defaults to *)
* @param integer $value Value to indicate access type (1 to give access, -1 to deny, 0 to inherit)
* @return boolean Success
* @link http://book.cakephp.org/view/1248/Assigning-Permissions
* @link http://book.cakephp.org/2.0/en/core-libraries/components/access-control-lists.html#assigning-permissions
*/
public function allow($aro, $aco, $actions = "*", $value = 1) {
$perms = $this->getAclLink($aro, $aco);
Expand Down Expand Up @@ -427,7 +427,7 @@ public function allow($aro, $aco, $actions = "*", $value = 1) {
* @param string $aco ACO The controlled object identifier.
* @param string $action Action (defaults to *)
* @return boolean Success
* @link http://book.cakephp.org/view/1248/Assigning-Permissions
* @link http://book.cakephp.org/2.0/en/core-libraries/components/access-control-lists.html#assigning-permissions
*/
public function deny($aro, $aco, $action = "*") {
return $this->allow($aro, $aco, $action, -1);
Expand Down
26 changes: 11 additions & 15 deletions lib/Cake/Controller/Component/AuthComponent.php
Expand Up @@ -34,7 +34,7 @@
* Binds access control with user authentication and session management.
*
* @package Cake.Controller.Component
* @link http://book.cakephp.org/view/1250/Authentication
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html
*/
class AuthComponent extends Component {

Expand Down Expand Up @@ -77,7 +77,7 @@ class AuthComponent extends Component {
* You can also use AuthComponent::ALL instead of the string 'all'.
*
* @var array
* @link http://book.cakephp.org/view/1278/authenticate
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html
*/
public $authenticate = array('Form');

Expand Down Expand Up @@ -133,7 +133,6 @@ class AuthComponent extends Component {
* with an invalid or expired session
*
* @var string
* @link http://book.cakephp.org/view/1277/ajaxLogin
*/
public $ajaxLogin = null;

Expand All @@ -158,7 +157,6 @@ class AuthComponent extends Component {
* unspecified, it will be "Auth.User".
*
* @var string
* @link http://book.cakephp.org/view/1276/sessionKey
*/
public static $sessionKey = 'Auth.User';

Expand All @@ -167,7 +165,6 @@ class AuthComponent extends Component {
* logins. Defaults to `/users/login`
*
* @var mixed
* @link http://book.cakephp.org/view/1269/loginAction
*/
public $loginAction = array(
'controller' => 'users',
Expand All @@ -182,7 +179,7 @@ class AuthComponent extends Component {
* set, the user will be redirected to the page specified in $loginRedirect.
*
* @var mixed
* @link http://book.cakephp.org/view/1270/loginRedirect
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html#AuthComponent::$loginRedirect
*/
public $loginRedirect = null;

Expand All @@ -194,7 +191,6 @@ class AuthComponent extends Component {
* @var mixed
* @see AuthComponent::$loginAction
* @see AuthComponent::logout()
* @link http://book.cakephp.org/view/1271/logoutRedirect
*/
public $logoutRedirect = null;

Expand All @@ -203,7 +199,7 @@ class AuthComponent extends Component {
* acccess.
*
* @var string
* @link http://book.cakephp.org/view/1273/authError
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html#AuthComponent::$authError
*/
public $authError = null;

Expand All @@ -212,7 +208,6 @@ class AuthComponent extends Component {
*
* @var array
* @see AuthComponent::allow()
* @link http://book.cakephp.org/view/1251/Setting-Auth-Component-Variables
*/
public $allowedActions = array();

Expand Down Expand Up @@ -429,7 +424,7 @@ public function constructAuthorize() {
*
* @param mixed $action,... Controller action name or array of actions
* @return void
* @link http://book.cakephp.org/view/1257/allow
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html#making-actions-public
*/
public function allow($action = null) {
$args = func_get_args();
Expand All @@ -454,7 +449,7 @@ public function allow($action = null) {
* @param mixed $action,... Controller action name or array of actions
* @return void
* @see AuthComponent::allow()
* @link http://book.cakephp.org/view/1258/deny
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html#making-actions-require-authorization
*/
public function deny($action = null) {
$args = func_get_args();
Expand All @@ -478,6 +473,7 @@ public function deny($action = null) {
* @param array $map Actions to map
* @return void
* @see BaseAuthorize::mapActions()
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html#mapping-actions-when-using-crudauthorize
*/
public function mapActions($map = array()) {
if (empty($this->_authorizeObjects)) {
Expand All @@ -496,7 +492,7 @@ public function mapActions($map = array()) {
*
* @param mixed $user Either an array of user data, or null to identify a user using the current request.
* @return boolean True on login success, false on failure
* @link http://book.cakephp.org/view/1261/login
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html#identifying-users-and-logging-them-in
*/
public function login($user = null) {
$this->_setDefaults();
Expand All @@ -520,7 +516,7 @@ public function login($user = null) {
*
* @return string AuthComponent::$logoutRedirect
* @see AuthComponent::$logoutRedirect
* @link http://book.cakephp.org/view/1262/logout
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html#logging-users-out
*/
public function logout() {
$this->_setDefaults();
Expand All @@ -542,7 +538,7 @@ public function logout() {
*
* @param string $key field to retrive. Leave null to get entire User record
* @return mixed User record. or null if no user is logged in.
* @link http://book.cakephp.org/view/1264/user
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html#accessing-the-logged-in-user
*/
public static function user($key = null) {
if (!CakeSession::check(self::$sessionKey)) {
Expand Down Expand Up @@ -670,7 +666,7 @@ public function constructAuthenticate() {
*
* @param string $password Password to hash
* @return string Hashed password
* @link http://book.cakephp.org/view/1263/password
* @link http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html#hashing-passwords
*/
public static function password($password) {
return Security::hash($password, null, true);
Expand Down
22 changes: 11 additions & 11 deletions lib/Cake/basics.php
Expand Up @@ -39,7 +39,7 @@
* `config('config1', 'config2');`
*
* @return boolean Success
* @link http://book.cakephp.org/view/1125/config
* @link http://book.cakephp.org/2.0/en/core-libraries/global-constants-and-functions.html#config
*/
function config() {
$args = func_get_args();
Expand Down Expand Up @@ -69,8 +69,8 @@ function config() {
* @param boolean $var Variable to show debug information for.
* @param boolean $showHtml If set to true, the method prints the debug data in a browser-friendly way.
* @param boolean $showFrom If set to true, the method prints from where the function was called.
* @link http://book.cakephp.org/view/1190/Basic-Debugging
* @link http://book.cakephp.org/view/1128/debug
* @link http://book.cakephp.org/2.0/en/development/debugging.html#basic-debugging
* @link http://book.cakephp.org/2.0/en/core-libraries/global-constants-and-functions.html#debug
*/
function debug($var = false, $showHtml = null, $showFrom = true) {
if (Configure::read('debug') > 0) {
Expand Down Expand Up @@ -152,7 +152,7 @@ function sortByKey(&$array, $sortby, $order = 'asc', $type = SORT_NUMERIC) {
* @param boolean $double Encode existing html entities
* @param string $charset Character set to use when escaping. Defaults to config value in 'App.encoding' or 'UTF-8'
* @return string Wrapped text
* @link http://book.cakephp.org/view/1132/h
* @link http://book.cakephp.org/2.0/en/development/debugging.html#h
*/
function h($text, $double = true, $charset = null) {
if (is_array($text)) {
Expand Down Expand Up @@ -204,7 +204,7 @@ function pluginSplit($name, $dotAppend = false, $plugin = null) {
*
* @see debug()
* @param array $var Variable to print out
* @link http://book.cakephp.org/view/1136/pr
* @link http://book.cakephp.org/2.0/en/development/debugging.html#pr
*/
function pr($var) {
if (Configure::read('debug') > 0) {
Expand All @@ -222,7 +222,7 @@ function pr($var) {
* @param array Third array
* @param array Etc...
* @return array All array parameters merged into one
* @link http://book.cakephp.org/view/1124/am
* @link http://book.cakephp.org/2.0/en/development/debugging.html#am
*/
function am() {
$r = array();
Expand All @@ -244,7 +244,7 @@ function am() {
*
* @param string $key Environment variable name.
* @return string Environment variable setting.
* @link http://book.cakephp.org/view/1130/env
* @link http://book.cakephp.org/2.0/en/development/debugging.html#env
*/
function env($key) {
if ($key === 'HTTPS') {
Expand Down Expand Up @@ -464,7 +464,7 @@ function clearCache($params = null, $type = 'views', $ext = '.php') {
*
* @param array $values Array of values to strip slashes
* @return mixed What is returned from calling stripslashes
* @link http://book.cakephp.org/view/1138/stripslashes_deep
* @link http://book.cakephp.org/2.0/en/development/debugging.html#stripslashes_deep
*/
function stripslashes_deep($values) {
if (is_array($values)) {
Expand All @@ -483,7 +483,7 @@ function stripslashes_deep($values) {
* @param string $singular Text to translate
* @param mixed $args Array with arguments or multiple arguments in function
* @return mixed translated string
* @link http://book.cakephp.org/view/1121/__
* @link http://book.cakephp.org/2.0/en/development/debugging.html#__
*/
function __($singular, $args = null) {
if (!$singular) {
Expand Down Expand Up @@ -701,7 +701,7 @@ function LogError($message) {
*
* @param string $file File to look for
* @return Full path to file if exists, otherwise false
* @link http://book.cakephp.org/view/1131/fileExistsInPath
* @link http://book.cakephp.org/2.0/en/development/debugging.html#fileExistsInPath
*/
function fileExistsInPath($file) {
$paths = explode(PATH_SEPARATOR, ini_get('include_path'));
Expand All @@ -722,7 +722,7 @@ function fileExistsInPath($file) {
*
* @param string String to convert
* @return string with underscore remove from start and end of string
* @link http://book.cakephp.org/view/1126/convertSlash
* @link http://book.cakephp.org/2.0/en/development/debugging.html#convertSlash
*/
function convertSlash($string) {
$string = trim($string, '/');
Expand Down

0 comments on commit 6709170

Please sign in to comment.