Exemplo parte de código documentado com PHPDoc.

<?php
/**
* Comentário de cabeçalho de arquivos
* Esta classe de upload de fotos
*
* @author leo genilhu <leo@genilhu.com>
* @version 0.1
* @copyright GPL © 2006, genilhu ltda.
* @access public
* @package Infra_Estrutura
* @subpackage UploadGenilhu
* @example Classe uploadGenilhu.
*/


class uploadGenilhu {
/**
* Comentário de variáveis
* Variável recebe o diretório para gravar as fotos.
* @access private
* @name $diretorio
*/
var $diretorio = "" ;

/**
* Função para gravar imagem em diretório
* @access public
* @param String $imagem_nome
* @param String $diretorio
* @return void
*/
function upload_up($imagem_nome, $diretorio)
{
$tmp = move_uploaded_file($this->arquivo["tmp_name"], $diretorio);
return($tmp);
}
?>