Re: Doxygen: Automatisiert Grundstruktur erstellen?

From	Thomas 'PointedEars' Lahn <PointedEars@web.de>
Newsgroups	de.comp.lang.php
Subject	Re: Doxygen: Automatisiert Grundstruktur erstellen?
Date	2016-01-05 16:59 +0100
Organization	PointedEars Software (PES)
Message-ID	<1762722.GPmjuRpIvv@PointedEars.de> (permalink)
References	(1 earlier) <n6dd38$ru9$1@dont-email.me> <1977592.bA0cxcuXD2@PointedEars.de> <n6g30r$gg$1@dont-email.me> <6080153.mLM9xEGu6c@PointedEars.de> <bt568be4f8i7529n3e8%sfroehli@Froehlich.Priv.at>

Show all headers | View raw

Stefan Froehlich wrote:

> On Tue, 05 Jan 2016 16:19:47 Thomas 'PointedEars' Lahn wrote:
>> Wie kann man *das* also „relativ trivial mit PHP-Mitteln erledigen“?
> 
> Hängt vom Quelltext ab. Wenn man sich z.B. darauf verlassen kann,
> dass ein regulärer Ausdruck der Form
> 
> (private|protected|public)[[:space:]]+(static)?[[:space:]]+function
> 
> alle Methoden findet und *nur* diese, dann kann man das relativ
> einfach erledigen. Da es sich hier um eine einmalige Arbeit handelt,
> ist die Überprüfung obiger Annahme mit find/grep durchaus im Rahmen
> des Machbaren.

Die Funktion/Methoden finden ist das eine (und nein, dafür genügt jener 
reguläre Ausdruck bei weitem nicht); *korrekte*, grundlegende 
Dokumentationskommentare dafür erzeugen, so dass das Ergebnis eben nicht nur 

  /**
   *
   */
  … function …

ist, das andere.  Daher meine Frage, wie das – wie von Torsten behauptet – 
„trivial mit PHP [zu] erledigen“ sein kann.
 
>> Benötigt würde dafür AFAICS eine minimale Implementierung eines
>> PHP- Compilers, damit formale Parameter und ihre vermutlichen oder
>> deklarierten Typen und die vermutlichen Typen des Rückgabewerts
>> sowie optimal auch der Typ von der Funktion geworfenen Exceptions
>> erkannt werden.
> 
> Tja, wenn es schon ein Frontend für AST gäbe... das wird wirklich
> höchste Zeit.

Wie gesagt: Existierende PHP-Editoren bieten das gesuchte Feature.  Mit 
Multicursor könnte man die grundlegenden Dokumentationsblöcke auch für alle 
Funktionen gleichzeitig erzeugen (leider funktionierte das bei meinen Tests 
mit atom-php noch nicht).

-- 
PointedEars
Zend Certified PHP Engineer
Twitter: @PointedEars2
Please do not cc me. / Bitte keine Kopien per E-Mail.

Back to de.comp.lang.php | Previous | Next — Previous in thread | Next in thread | Find similar

Thread

Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-01 23:32 +0100
  Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-02 22:55 +0100
    Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-03 07:29 +0100
      Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-03 13:58 +0100
        Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-05 12:28 +0100
          Re: Doxygen: Automatisiert Grundstruktur erstellen? Claus Reibenstein <4spamersonly@kabelmail.de> - 2016-01-05 13:03 +0100
            Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-05 16:21 +0100
              Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-06 09:47 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Claus Reibenstein <4spamersonly@kabelmail.de> - 2016-01-06 12:36 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-06 17:17 +0100
              Re: Doxygen: Automatisiert Grundstruktur erstellen? "Peter J. Holzer" <hjp-usenet3@hjp.at> - 2016-01-06 12:50 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Claus Reibenstein <4spamersonly@kabelmail.de> - 2016-01-06 13:56 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? "Peter J. Holzer" <hjp-usenet3@hjp.at> - 2016-01-07 09:10 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-06 16:02 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-06 17:19 +0100
          Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-05 14:33 +0100
            Re: Doxygen: Automatisiert Grundstruktur erstellen? Stefan Mayer <meniskus@gmx.net> - 2016-01-05 19:18 +0100
              Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-05 20:37 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Stefan Mayer <meniskus@gmx.net> - 2016-01-05 21:18 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-05 23:20 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Stefan Mayer <meniskus@gmx.net> - 2016-01-06 16:20 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-06 17:22 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Torsten Zuehlsdorff <foo@meisterderspiele.de> - 2016-01-07 11:02 +0100
              Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-06 09:56 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Stefan Mayer <meniskus@gmx.net> - 2016-01-06 15:42 +0100
            Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-06 09:54 +0100
          Re: Doxygen: Automatisiert Grundstruktur erstellen? Torsten Zuehlsdorff <foo@meisterderspiele.de> - 2016-01-06 10:09 +0100
            Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-06 16:05 +0100
            Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-06 17:15 +0100
            Re: Doxygen: Automatisiert Grundstruktur erstellen? Claus Reibenstein <4spamersonly@kabelmail.de> - 2016-01-06 17:46 +0100
              Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-06 18:06 +0100
                Re: Doxygen: Automatisiert Grundstruktur erstellen? Torsten Zuehlsdorff <foo@meisterderspiele.de> - 2016-01-07 11:03 +0100
              Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-06 19:03 +0100
  Re: Doxygen: Automatisiert Grundstruktur erstellen? Torsten Zuehlsdorff <foo@meisterderspiele.de> - 2016-01-04 10:15 +0100
    Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-04 22:58 +0100
      Re: Doxygen: Automatisiert Grundstruktur erstellen? Torsten Zuehlsdorff <foo@meisterderspiele.de> - 2016-01-05 10:41 +0100
        Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-05 12:36 +0100
        Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-05 16:19 +0100
          Re: Doxygen: Automatisiert Grundstruktur erstellen? Stefan+Usenet@Froehlich.Priv.at (Stefan Froehlich) - 2016-01-05 15:48 +0000
            Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-05 16:59 +0100
            Re: Doxygen: Automatisiert Grundstruktur erstellen? "Christoph M. Becker" <cmbecker69@arcor.de> - 2016-01-08 16:55 +0100
              Re: Doxygen: Automatisiert Grundstruktur erstellen? Stefan+Usenet@Froehlich.Priv.at (Stefan Froehlich) - 2016-01-08 16:17 +0000
          Re: Doxygen: Automatisiert Grundstruktur erstellen? Torsten Zuehlsdorff <foo@meisterderspiele.de> - 2016-01-05 19:17 +0100
            Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-05 20:27 +0100
              Re: Doxygen: Automatisiert Grundstruktur erstellen? Torsten Zuehlsdorff <foo@meisterderspiele.de> - 2016-01-06 09:41 +0100
            Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-06 09:59 +0100
    Re: Doxygen: Automatisiert Grundstruktur erstellen? Michael Vogel <ike@spamfence.net> - 2016-01-05 12:30 +0100
  Re: Doxygen: Automatisiert Grundstruktur erstellen? Christian Stadler <stadli@gmx.de> - 2016-01-04 18:15 +0100
    Re: Doxygen: Automatisiert Grundstruktur erstellen? Thomas 'PointedEars' Lahn <PointedEars@web.de> - 2016-01-04 23:02 +0100
      Re: Doxygen: Automatisiert Grundstruktur erstellen? Torsten Zuehlsdorff <foo@meisterderspiele.de> - 2016-01-05 10:46 +0100

csiph-web