nicht angemeldet
Hat jemand Erfahrung mit PHPDoc ?
Huhu Forumaniacs
bin gerade über das [1] gestolpert
bzw.
http://pear.php.net/manual/en/packages.phpdoc.php
und auf den ersten Blick sehr angetan davon.
Wollte wissen ob jemand von Euch bereits damit gearbeitet hat, und ob es ggf. weitere (bessere, andere, schönere etc. ) Alternativen gibt.
Würde mich über fütterzurück freuen ;-)
Viele Grüße
lulu
[1] PHPdoc
-
hallo lulu,
Das Konzept, das mit PHPDOC verfolgt werden soll, ist tatsächlich interessant. Ich habe mich allerdings längere Zeit nicht mehr damit beschäftigt
was du dort findest, ist leider inzwischen ein bißchen alt und immer noch beta - und funktioniert nicht richtig
deutlich jünger und lesenswert
Wollte wissen ob jemand von Euch bereits damit gearbeitet hat, und ob es ggf. weitere (bessere, andere, schönere etc. ) Alternativen gibt.
Die einzigen "Alternativen" wären die diversen PHP-Manuals, die es ja gibt, zum Beispiel http://www.php.net/manual/de/
Christoph S.
-
Hallo,
ich kenne keine Alternativen.
Die Idee entstand, weil man eine Einheitliche Dokumentationsform schaffen wollte und Javadoc als Vorlage benutzte.
Ich finde PHPDoc für grosse Projekte gut.
Der Mehraufwand rentiert sich aber definitiv erst bei grösseren Projekten, wo eine gute Doku die halbe Miete ist.Michael R.
-
hi,
Die Idee entstand, weil man eine Einheitliche Dokumentationsform schaffen wollte und Javadoc als Vorlage benutzte.
Ich sagte ja, daß das Konzept eigentlich sehr interessant ist. Die Doku soll aus PHP-Code "erzeugt" werden können, aber genau das scheint (immer) noch nicht zu klappen. Ich habe es "offline" über den lokalen Apache nie so richtig zum Laufen gebracht und deshalb ungefähr ein halbes Jahr nicht mehr weiter verfolgt.
Der Mehraufwand rentiert sich aber definitiv erst bei grösseren Projekten, wo eine gute Doku die halbe Miete ist.
ein "Projekt" sollte grundsätzlich dokumentiert werden, selbst wenn es _nur_ ein Gästebuchscript ist. Und "Mehraufwand" soll durch PHPdoc ja gerade vermieden werden, da man im Idealfall keine eigenständigen Dokumentationen mehr tippen muß
Christoph S.
-
Huhu Christoph
Also, ein wenig funktioniert es schon. Habe es allerdings erst mit
relative simpel gestrickten snippets getestet.
Was mich irritiert hatte war vor allem das letzte Aktualisierungsdatum auf der Website von PHPDoc (Dez/ 2000)Ansonsten würde mich das beta-ige nicht stören.
Jetzt warte ich erstmal ab ob ich eine Rückantwort vom Entwickler bekomme, habe ihn dies bezüglich "an-ge-emailt" (auch ein hübsches Wort ;-).
Viele Grüße
lulu
-
Huhu lulu
(wenn man mal mit jemandem sprechen möchte der einen wirklich versteht muss man halt Selbstgespräche führen ;-)
Da steht doch deutlich geschrieben, dass sich die neueste Version unter http://csv.php.net finden lässt, und siehe da
http://cvs.php.net/cvs.php/phpdoc
es wird emsig daran gearbeitet (last update < 2 days).
Feine Sache das...
Viele Grüße
lulu
-
-
-
-