PHPDocumentor - Script-Bereich dokumentieren

[Benny-one]

Hi,
weiß einer auf die Schnelle, ob und wie man einen Script-Bereich dokumentieren kann?
Damit meine ich jetzt nicht eine Funktion o.ä. zu dokumentieren (das ist ja kein Problem), sondern ich möchte einen bestimmten Abschnitt dokumentieren.

Beispiel:

<?php
/**
* Beschreibung des Abschnitts
*/
if($a==$b) {
  echo "bar";
}
else {
  echo "foo";
}
while($a<=$b) {
  echo "Hello";
}
/**
* Ende - der Teil soll nicht dokumentiert werden. 
*Der Schnipsel soll in der Doku samt Beschreibung von oben auftauchen.
*/
?>

[Hopka]

http://manual.phpdoc.org/HTMLframesC...ource.pkg.html

[Benny-one]

Ne, das ist es leider nicht ganz. Denn @source muss ebenfalls vor einer funktion oder methode platziert werden, und das habe ich ja nicht.

[Hopka]

Mit den optionalen Zeilenparametern könntest du ja auch nur Teile einer Funktion dokumentieren.

Wenn du etwas ganz außerhalb von Funktionen / Klassen / Methoden dokumentieren möchtest, dann geht das mit phpDocumentor afaik gar nicht.

[Benny-one]

Original geschrieben von Hopka
Wenn du etwas ganz außerhalb von Funktionen / Klassen / Methoden dokumentieren möchtest, dann geht das mit phpDocumentor afaik gar nicht.

das habe ich mir schon gedacht

[Marcusson]

Schreib dir doch selbst eine entsprechende Erweiterung. PHP Documentor ist IMHO doch schliesslich Open-Source!

[Benny-one]

Nene, die Zeit habe ich dann auch wieder nicht. Wäre nur ein n2h gewesen, wenn das auf die schnelle ginge.