Re: looking for volunteers phpDocumentor, new converter reST
| From: | George Schlossnagle | Date: | Fri, 13 Jun 2003 15:49:20 +0000 |
| Subject: | Re: looking for volunteers phpDocumentor, new converter reST | ||
| References: | 1 | Groups: | php.pear.dev php.pear.doc |
| Request: | Send a blank email to pear-dev+get-17415@lists.php.net to get a copy of this message | ||
On Friday, June 13, 2003, at 11:29 AM, Sterling Hughes wrote:
On Fri, 2003-06-13 at 11:35, George Schlossnagle wrote:I'll admit I didn't read this thread until the parent post to your post. But settling on a documentation standard that requires using a tool that is only written for another scripting language seems downright silly to me. Thats like running php.net off of mod_perl because you want to use some of the api hooking features available there and not in php. Now I understand that translators do not format a format constitute. I also believe that forcing use of Python/Perl as part of any central PHP management process is sad, ironic, and self-defeating. Even when this arrangement is forced onto you by it being the defacto choice available for a problem. GeorgeOn Friday, June 13, 2003, at 11:21 AM, Sterling Hughes wrote:Well, sure. But that's no technical reason for turning a format down. If you want purity in scripting, write a python replacement program. Until that's written, when it comes to the big 3 (perl, python, php) you shouldn't be choosing the tool based on the language, but rather the functionality it provides.# apt-get install python I don't think its unreasonable to require Perl, Python or PHP, as they are pretty major UNIX scripting languages.I think it's kinda silly and self-defeating to require another scripting language to compile the documentation for this scripting language. This is not about the ease of installation to me (python lives on all my systems, in fact I think it came installed on every system I run), it's the prinicipal of the matter.
-Sterling-- Principal Consultant -- OmniTI Computer Consulting, Inc. -- +1.410.872.4910 x202 -- 1024D/1100A5A0 1370 F70A 9365 96C9 2F5E 56C2 B2B9 262F 1100 A5A0George-- "That stuff's easy compared to installing Horde"- Alan Knowles, In response to my applause for creating a LALR parser for PHP.-- PEAR Development Mailing List (http://pear.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php -- George Schlossnagle