@internal
Mark documentation as private, internal to the software project
by Gregory Beaver
Copyright 2002, Gregory Beaver
(phpDocumentor 1.2+)
@internal
any information that should not be displayed in public documentation [unspecified format]
Description
Use @internal to facilitate the creation of two sets of documentation, one for advanced developers or for internal company use, and the other for the general PHP public. Use this tag or its cousin, inline {@internal}}
@internal responds to the command-line -pp, --parseprivate, as both @internal and --parseprivate share the same purpose. In both cases, the intent is to allow the creation of two sets of documentation, one for public use, and the other for a subset of developers, either the project developers or those who wish to extend the project. In essence, it allows the creation of both user-level and programmer-level documentation from the same source, and is one of phpDocumentor's most useful features.
Example
Here is an example of how to use @internal and {@internal}}:
/**
* This class does things
*
* {@internal To access the company guidelines on modifying this class,
* see {@link http://www.example.com Company Guidelines}, or contact
* your supervisor}}}
* Using this class can be very helpful for several reasons. etc. etc.
* @internal the class uses the private methods {@link _foo()} and
* {@link _bar()} to do some wacky stuff
*/
class Doesthings