Gerando documentação para funções no Netbeans

Basta colocar este bloco de comentários antes da definição da função:

1:  /**   
2:   * contarDiffHoras  
3:   *  
4:   * conta a diferença em horas entre a data informada e a data do sistema  
5:   * obs: sempre uma data no passado  
6:   *  
7:   * @param string $data a data para comparar no formato d/m/Y H:i  
8:   */  

Fica assim:

1:  /**   
2:   * contarDiffHoras  
3:   *  
4:   * conta a diferença em horas entre a data informada e a data do sistema  
5:   * obs: sempre uma data no passado  
6:   *  
7:   * @param string $data a data para comparar no formato d/m/Y H:i  
8:   */  
9:  function contarDiffHoras($data){  
10:       $data = date_create_from_format('d/m/Y H:i', $data);//data informada  
11:       $now = date_create();//data atual  
12:       $diff = date_diff($now, $data);//calcula a diferença entre as datas  
13:       return ($diff->format('%a') * 24) + $diff->format('%H');//calcula a diferença em horas  
14:  }  

E, no Netbeans, aparece assim: