phpDocumentor phpDocumentor
[ class tree: phpDocumentor ] [ index: phpDocumentor ] [ all elements ]
Prev Next
@name

@name

Specify an alias to use for a procedural page or global variable in displayed documentation and linking

by Gregory Beaver
Tag Documentation written by [email protected]
Copyright 2002, Gregory Beaver
(phpDocumentor 1.1+)
@name $globalvariablename

Description

phpDocumentor recognizes the @name tag in global variable DocBlocks (in conjunction with @global), and uses it to rename a global variable for documentation to make it more readable. A global variable name MUST begin with a dollar sign ($) or phpDocumentor will ignore the tag and raise an error.

Example

Here's an examples:

  1. /**
  2.  * Now, when @global is used in a function, it will link to $baz
  3.  * @name $baz
  4.  * @global $GLOBALS['baz'] 
  5.  */
  6. $GLOBALS['baz'array('foo','bar');
  7.  
  8. /**
  9.  * @global array used for stuff
  10.  */
  11. function mine()
  12. {
  13.     global $baz;
  14. }

Prev Up Next
@link phpDocumentor tags @package

Documentation generated on Tue, 24 Oct 2006 09:20:08 -0500 by phpDocumentor 1.3.1