Discussion :

[mistër g]

Salut à tous,
j'ai téléchargé phpdocumentor de phpdoc.org qui permet de générer de la doc pour php comme javadoc
alors j'ai commencé par une page simple pour voir le résultat mais j'obtiens toujours le message d'erreur suivant :

Reading file /home/gruna/public_html/iarm/assembly/include/fonction_docs.php -- Parsing file
WARNING in fonction_docs.php on line 444: File "/home/gruna/public_html/iarm/assembly/include/fonction_docs.php" has no page-level DocBlock, use @package in the first DocBlock to create one
done

et rien n'est généré, rien du tout
mon fichier fonction_docs.php contient bien un DocBlock avec le tag @package :

voila mon source :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<?php
/**
 * fonction_docs
 * 
 * This source file contains functions to manage uploaded files
 * including upload, download, display and delete files
 * 
 * @package include
 * 
 */ 
 
 
/**
 * This function displays error message
 * @param string $error_mess error message to display
 */
 
 
function put_error( $error_mess ) {
   for( $i=0; $i< sizeof ( $error_mess ); $i++ ) {
      error_log( $error_mess[$i] );
   }
}
 
?>
//

[babarr38]

Salut,

J'ai le même probleme...
Le paradoxe dans l'histoire, c'est que ca fonctionnait il y a deux heures. J'ai cree deux nouvelles classes avec la doc associée... Je regenere la documentation avec DocBuilder et la il ne reconnait plus mes classes et me donne ce même message d'erreur ??
L'information est un vrai mystere par moment...
Mais on finit toujours pas le resoudre ce mystère ...

A+

[babarr38]

Bonjour,

J'ai joue avec mon "block" de commentaire. Et ca fonctionne !!!
Voila la structure de ce dernier :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
 
<?php
/**
 * Class Machin
 *
 * @author XXXXXX
 * @version 1.0
 * @package PAQUET1
 */
 
/**
 * Gestion des attributs et des methodes liees a un machin
 *
 * Les caracteristiques des Machin se decomposent
 * - les caracteristiques de machin
 *
 * @author xxxxx
 * @version 1.0
 */
class Machin
{
}

Si quelqu'un a une explication
a+