Hello goba,
i just noticed that you've put up a nice agenda for the doc meeting at LT.
Unfortunatley i don't know yet if / how long i can attend it. For this reason
i'd appreciate it if you could add an entry to the agenda:
We need documentation support for aliases, methods and hybrids (function and
method).
I've put some ideas into it and think we need to expand the proto mechanism so
that it recognizes the syntax below. At the moment this may seem impossible.
But on the contrary we need it. So the docmeeting is the best place to find
solutions how to get such a thing into php. Perhaps we expand the current doc
build environment with some PHP code? Maybe i'll end up hacking some Java
again? I don't know yet.
Doc := Start Lines Short End
Short := String
End := NL
Lines := Line [ Lines ]
Line := Proto NL
Start := "/* {{{"
End := [ NL ] [ "}}}" ] "*/"
Proto := Entry Return Entity [ "(" Params ")" ]
Entry := "proto" | "alias" | "method" | "property"
Return := "void" | Type [ "|" Type ]*
Type := "mixed" | "bool" | "int" | "string" | "float" | "array" | "resource" |
"handler" | "object" | Class
Entity := Func | [ Flags ] Class "::" Method | [ Flags ] Class "::" Property
Flags := Modifier [ "," Flags ]
Modifier:= "static" | "final" | "public" | "protected" | "private" | "abstract"
Func := <String>
Class := <string>
Method := <String>
Property:= <String>
Params := Param [ "," Params ] | "[" Params "]"
Param := Type [ "&" ] String [ "=" Default ]
Default := <Value>
WS := <space> | <tab>
NL := <cr> | <lf> | <cr> <lf>
Comments:
- i omitted whitespace
- classes/interfaces need to be documented too
Best regards,
Marcus mailto:[EMAIL PROTECTED]
p.s.: I'm not subscribed to phpdoc@
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
