How to escape phpdoc comment in phpdoc comment?

Question

I would like to know how to escape phpdoc comments within a phpdoc comment.

For example, how would I have to write this:

/**
 * Some documentation...
 *
 * <code>
 * /**
 *  * Example example phpdoc.
 *  */
 * </code>
 */

Obviously above example won't work.

I tried replacing the asterisk's with *, but it will just nicely print "*"...

Answer 1

You need to use @example. Add the following lines after the tag </code>

 @example /path/to/example.php How to use this function
 @example anotherexample.inc This example is in the "examples" subdirectory

You can find more info here. So you apparently need to have the example code in a separate file too.

Answer 2

According to DocBlock Description details, you can, as of 1.2.0rc1, write {@*} to write */.

For example:

/**
 * Simple DocBlock with a code example containing a docblock
 *
 * <code>
 *  /**
 *   * My sample DocBlock in code
 *   {@*} 
 * </code>
 */