Doc meeting at LT

From: Date: Mon, 07 Jul 2003 20:04:24 +0000
Subject: Doc meeting at LT
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969355092@lists.php.net to get a copy of this message
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:helly@php.net p.s.: I'm not subscribed to phpdoc@

« previous php.doc (#969355092) next »