Re: [PHP-DOC] How to document 'not implemented, sorta' stuff?

2010-06-07 Thread G. T. Stresen-Reuter
On Jun 7, 2010, at 3:47 PM, Philip Olson wrote: > > There are several features in PHP that are "not implemented [yet]", including > roughly 13 DOM classes. Well, they are sorta (but not really) implemented. > > How should we deal with this? Just my 2¢ but if something is not (yet) implemented,

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-09 Thread G. T. Stresen-Reuter
On Sep 9, 2009, at 2:02 PM, Hannes Magnusson wrote: On Wed, Sep 9, 2009 at 13:20, Brandon Savage wrote: This documentation already exists in that section. I'll amend my diff to reference this section. Something along the lines of "PHP 5's object model also significantly changes the way ob

Re: [PHP-DOC] Patches

2009-07-16 Thread G. T. Stresen-Reuter
On Jul 16, 2009, at 2:04 PM, Moacir de Oliveira > wrote: Patch Explanation Outstanding explanation. Gave me some ideas for how to improve my own code. Ted Stresen-Reuter

Re: [PHP-DOC] docs to svn business

2009-07-09 Thread G. T. Stresen-Reuter
On Jul 9, 2009, at 7:18 PM, Niel Archer wrote: Why is this a problem? SVN revision numbers are incremental as well. I don't see the difference between tying a translation to CVS-123456 and SVN-123456? I'm not particularly familiar with CVS (fortunately), so someone please correct me if I'm

Re: [PHP-DOC] docs to svn business

2009-07-09 Thread G. T. Stresen-Reuter
On Jul 9, 2009, at 6:31 PM, Hannes Magnusson wrote: Create an md5 hash on the version you are translating and use that to "uniquely" identify it. If the EN version is modified by even a single space, the hash will change and you'll know the files are out of sync. What you won't know is just

Re: [PHP-DOC] docs to svn business

2009-07-09 Thread G. T. Stresen-Reuter
On Jul 9, 2009, at 1:24 AM, Philip Olson wrote: How are CVS Revision numbers used today? The best feature of po is that translation text is marked as 'fuzzy' when the main text is changed. If we could do the same with our docbook translation files whenever the en file is committed then we

Re: [PHP-DOC] Re: [HEADSUP] Call for help

2009-07-05 Thread G. T. Stresen-Reuter
On Jul 5, 2009, at 2:57 PM, Peter Beverloo wrote: With the documentation moving to PO files soon (as well as changes around the PhD editor GSoC project) I follow this list pretty closely but I must have missed this (rather important) news item. When will the documentation move to PO files?

Re: [PHP-DOC] [HEADSUP] Call for help

2009-07-05 Thread G. T. Stresen-Reuter
On Jul 5, 2009, at 10:25 AM, Peter Cowburn wrote: For what it's worth, I'd rather see "kick-ass awesome" in there than it being left out. :) I agree! Ted S-R http://tedmasterweb.com

Re: [PHP-DOC] Conforming documentation style - how to document classes

2009-06-16 Thread G. T. Stresen-Reuter
On Jun 15, 2009, at 6:26 PM, Philip Olson wrote: On Jun 15, 2009, at 1:18 AM, G. T. Stresen-Reuter wrote: Hi, I'm not a big contributor (in fact, haven't done much more than test PhD and send some feedback) but I do work with the raw documentation quite a bit. I've foun

[PHP-DOC] Conforming documentation style - how to document classes

2009-06-15 Thread G. T. Stresen-Reuter
Hi, I'm not a big contributor (in fact, haven't done much more than test PhD and send some feedback) but I do work with the raw documentation quite a bit. I've found some apparent irregularities in how classes are documented. For example, the tidy.html has both procedural and OO versions

Re: [PHP-DOC] PhD Plugin System

2009-05-02 Thread G. T. Stresen-Reuter
Hi, On May 1, 2009, at 7:28 PM, Moacir de Oliveira wrote: Another example of theme would render the funcindex.xml file from the PHP documentation source.[4] [4] - http://bugs.php.net/bug.php?id=47651 I have one or two XSL stylesheets that were able to produce a complete list of "keyword

Re: [PHP-DOC] user comments of the future

2009-04-02 Thread G. T. Stresen-Reuter
really does understand how it should be done. Also, it should be noted that for people who aren't able to render the JS (such as screen readers), accessibility is maintained. 1+ for using this approach... G. T. Stresen-Reuter Web: http://tedmasterweb.com Blog: http://tecnotertulia.com Twitter: http://twitter.com/tedmasterweb

Re: [PHP-DOC] Re: Function Index

2009-03-31 Thread G. T. Stresen-Reuter
guess is the latter... Thanks in advance. G. T. Stresen-Reuter Web: http://tedmasterweb.com Blog: http://tecnotertulia.com Twitter: http://twitter.com/tedmasterweb

Re: [PHP-DOC] XHTML (was: A blank page shows)

2008-12-24 Thread G. T. Stresen-Reuter
On Dec 24, 2008, at 6:49 AM, Hannes Magnusson wrote: No need for the rendered docs to be XML parsable, if you need to do some magic against the docs then use the DocBook XML. Good point and in fact, I've changed my mind on the need for totally valid XHTML... I'll keep watching the list for

Re: [PHP-DOC] XHTML (was: A blank page shows)

2008-12-23 Thread G. T. Stresen-Reuter
On Dec 23, 2008, at 4:10 PM, Hannes Magnusson wrote: There are several cases which we simply cannot fix Do you have one documented? I do a lot of XSLT-type stuff and it seems to me that if we're starting with valid XML (.manual.xml) and XHTML is in many respects HTML XMLified that it shoul

Re: [PHP-DOC] Re: Documenting Exceptions

2008-10-03 Thread G. T. Stresen-Reuter
Hi, On Oct 3, 2008, at 8:51 PM, Hannes Magnusson wrote: On Fri, Oct 3, 2008 at 15:42, Brandon Savage <[EMAIL PROTECTED]> wrote: Some of the challenges: I'm using a Mac and the PEAR package gave me some trouble. Once I resolved that, everything went smoothly. However, I'm not I don't

Re: [PHP-DOC] PHP doc XML layout conventions - tool available?

2008-10-02 Thread G. T. Stresen-Reuter
On Oct 2, 2008, at 12:10 PM, Hannes Magnusson wrote: On Thu, Oct 2, 2008 at 13:06, Anthony Bedford <[EMAIL PROTECTED]> wrote: Hi, has anyone out there written a script that will help reformat an XML doc to the PHP doc style? I have a large(ish) table in particular that I don't want to r

[PHP-DOC] Configure failing with "EntityRef: expecting ';'" and "chunk is not well balanced" error

2008-09-01 Thread G. T. Stresen-Reuter
I'm trying to build the PHP docs locally but configure.php is failing with the following error: == Loading and parsing manual.xml... failed. ERROR (/Users/tedsr/phpdoc2/phpdoc/en/install/pecl.xml:147:21) &url.pecl.submit. -

Re: [PHP-DOC] [HEADSUP] New phpweb branch

2008-08-22 Thread G. T. Stresen-Reuter
On Aug 22, 2008, at 1:39 AM, Jean-Sébastien Goupil wrote: That looks like really nice for now. I have just few comments about the new design. Personally, the first thought I had was "Mmm, it looks like a little less professional, but looks like the new era of web". And I spent just 10 minut

Re: [PHP-DOC] (was: (spam title removed))

2008-07-28 Thread G. T. Stresen-Reuter
On Jul 28, 2008, at 12:59 PM, Hannes Magnusson wrote: On Mon, Jul 28, 2008 at 13:14, Richard Quadling <[EMAIL PROTECTED]> wrote: How are these appearing on the list? [snip] I thought you had to be a subscriber? Nope. But you do have to respond to the challenge/response mail. I have no idea h

Re: [PHP-DOC] [ANNOUNCE] PhD 0.3.0 Released!

2008-07-24 Thread G. T. Stresen-Reuter
On Jul 24, 2008, at 10:53 PM, Brett Bieber wrote: pear uninstall __uri/phd pear install doc.php.net/phd-beta BINGO! Thanks for the lessons (and for PhD)! Ted S-R

Re: [PHP-DOC] [ANNOUNCE] PhD 0.3.0 Released!

2008-07-24 Thread G. T. Stresen-Reuter
Getting there... see below... Are you sure you want to go down this path with me? Your help is greatly appreciated, but if I poke around enough I'll eventually get it installed... On Jul 24, 2008, at 10:40 PM, Hannes Magnusson wrote: On Thu, Jul 24, 2008 at 23:37, G. T. Stresen-R

Re: [PHP-DOC] [ANNOUNCE] PhD 0.3.0 Released!

2008-07-24 Thread G. T. Stresen-Reuter
On Jul 24, 2008, at 10:20 PM, Hannes Magnusson wrote: I'm pretty sure I'm running either 0.2.6 or 0.2.7... Any way I can find out for sure? phd -V gives you the installed version. /usr/local/php5/bin/phd -V [23:35:40] PhD version: 0.2.3 [23:35:40] Copyright (c) 2008 The PHP Documentation

Re: [PHP-DOC] [ANNOUNCE] PhD 0.3.0 Released!

2008-07-24 Thread G. T. Stresen-Reuter
On Jul 24, 2008, at 9:54 PM, Hannes Magnusson wrote: Hi all! Next minor release of PhD, 0.3.0, has been released! For a full release history, see http://doc.php.net/phd/ To upgrade from previous releases: pear upgrade doc.php.net/phd-beta Hi Hannes, I'm looking forward to trying out the

Re: [PHP-DOC] Machine-readable PHP documentation?

2008-06-03 Thread G. T. Stresen-Reuter
On Jun 4, 2008, at 12:23 AM, Edward Z. Yang wrote: Ben Dilts wrote: I can't seem to find information on how to make complete XML files of the reference docs. The en/reference/*/functions/*.xml files are not actually valid XML, as they don't have a DOCTYPE and don't define all the custom XML en

[PHP-DOC] Generating stripped.xml using new build system

2008-04-23 Thread G. T. Stresen-Reuter
Hi, First, this is only my second time writing to the list so just a quick thanks to those of you who actively participate, translate, and maintain the PHP documentation. It's an amazing project and I can appreciate the amount of work that goes into it. I'm writing because I maintain a st