Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-10-12 Thread Julien Pauli
I'am absolutly +1 with these ideas, that are very clear. Regards, J.Pauli On Mon, Oct 11, 2010 at 9:45 PM, Philip Olson wrote: > > On Oct 11, 2010, at 12:20 PM, Julien Pauli wrote: > >> My example was http://www.php.net/manual/en/language.variables.predefined.php >> >> I have other examples of w

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-10-11 Thread Philip Olson
On Oct 11, 2010, at 12:20 PM, Julien Pauli wrote: > My example was http://www.php.net/manual/en/language.variables.predefined.php > > I have other examples of what I globally mean, these kinds are recurrent : > > - "Note: The null type was introduced in PHP 4." > - "Warning : Before PHP 4.3

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-10-11 Thread Julien Pauli
My example was http://www.php.net/manual/en/language.variables.predefined.php I have other examples of what I globally mean, these kinds are recurrent : - "Note: The null type was introduced in PHP 4." - "Warning : Before PHP 4.3.0, appending to an array in which the current maximum key was n

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-10-11 Thread Philip Olson
On Oct 11, 2010, at 1:38 AM, Julien Pauli wrote: > Ok, so we put away all PHP4 terms from docs which mix PHP4 ans PHP5 ? Not sure what you mean. If decided, we'll remove them. Maybe you have an example or three? > What to do for docs like "Predifined Variables" which highly rely on PHP 4 > (r

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-10-11 Thread Philip Olson
On Oct 11, 2010, at 3:51 AM, Richard Quadling wrote: > On 23 January 2010 07:25, Philip Olson wrote: >> Hello everyone, >> >> What do people think about making PHP 5 a first class citizen? If done, we'd >> no longer have phrases like: >> >> - As of PHP 5 >> - Since PHP 5 >> - Added in PHP

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-10-11 Thread Richard Quadling
On 23 January 2010 07:25, Philip Olson wrote: > Hello everyone, > > What do people think about making PHP 5 a first class citizen? If done, we'd > no longer have phrases like: > >  - As of PHP 5 >  - Since PHP 5 >  - Added in PHP 5 > > Because readers are expected to be using PHP 5. However, I'm

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-10-11 Thread Julien Pauli
Ok, so we put away all PHP4 terms from docs which mix PHP4 ans PHP5 ? What to do for docs like "Predifined Variables" which highly rely on PHP 4 (register globals switch) ? J.Pauli On Sat, Oct 9, 2010 at 6:37 PM, Philip Olson wrote: > > On Oct 8, 2010, at 10:30 AM, Julien Pauli wrote: > > > I'

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-10-09 Thread Philip Olson
On Oct 8, 2010, at 10:30 AM, Julien Pauli wrote: > I'm just putting back the subject here ;-) > > Actually translating French doc, I noticed that few days ago, a change to the > original (en) source from PCRE had a huge diff deleting all the "available > since PHP4.X.Y". Same inside other sour

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-10-08 Thread Julien Pauli
I'm just putting back the subject here ;-) Actually translating French doc, I noticed that few days ago, a change to the original (en) source from PCRE had a huge diff deleting all the "available since PHP4.X.Y". Same inside other sources from En doc. So, what to do ? I'm +1 to put away all the

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-24 Thread Daniel Convissor
Hi Hannes: On Sun, Jan 24, 2010 at 12:25:53PM +0100, Hannes Magnusson wrote: > > If we can create a standardized changelog for all features, I think > that would solve everything. Yes. Excellent. Thanks, --Dan -- T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-24 Thread Gwynne Raskind
On Jan 24, 2010, at 11:39 AM, Hannes Magnusson wrote: >> Another great example that shows how difficult it can be to read >> documentation that's littered with version history. The CLI docs border on >> being unreadable. >> >> We don't have a nice way to list changelog history yet (for non-funct

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-24 Thread Hannes Magnusson
On Sun, Jan 24, 2010 at 17:12, Philip Olson wrote: > > On Jan 24, 2010, at 3:25 AM, Hannes Magnusson wrote: > >> On Sun, Jan 24, 2010 at 07:09, Daniel Convissor >>> Personally, I like the history being there.  It is interesting to see how >>> things evolve.  Having this data there does no harm to

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-24 Thread Philip Olson
On Jan 24, 2010, at 3:25 AM, Hannes Magnusson wrote: > On Sun, Jan 24, 2010 at 07:09, Daniel Convissor > wrote: >> Hi Folks: >> >>> we'd no longer have phrases like: >>> >>> - As of PHP 5 >> ... >> >> There was a discussion about this a month or so ago. (I can't find it >> now.) > > It was

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-24 Thread Hannes Magnusson
On Sun, Jan 24, 2010 at 07:09, Daniel Convissor wrote: > Hi Folks: > >> we'd no longer have phrases like: >> >>  - As of PHP 5 > ... > > There was a discussion about this a month or so ago.  (I can't find it > now.) It was about the OOP4 docs (which got moved to an appendix). > Personally, I li

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-23 Thread Daniel Convissor
Hi Folks: > we'd no longer have phrases like: > > - As of PHP 5 ... There was a discussion about this a month or so ago. (I can't find it now.) Personally, I like the history being there. It is interesting to see how things evolve. Having this data there does no harm to anyone. Let alone

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-23 Thread Philip Olson
On Jan 23, 2010, at 11:40 AM, Hannes Magnusson wrote: > On Sat, Jan 23, 2010 at 19:34, Philip Olson wrote: >> > [..] >> Summary: Only changing the writing style would be simplest, and would still >> increase readability of the PHP manual. > > What about changelog entries? > Should those still

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-23 Thread Hannes Magnusson
On Sat, Jan 23, 2010 at 19:34, Philip Olson wrote: > [..] > Summary: Only changing the writing style would be simplest, and would still > increase readability of the PHP manual. What about changelog entries? Should those still say "parameter abc became available in PHP5.0.0" for functions that h

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-23 Thread Philip Olson
On Jan 23, 2010, at 5:46 AM, Hannes Magnusson wrote: > On Sat, Jan 23, 2010 at 08:25, Philip Olson wrote: >> Hello everyone, >> >> What do people think about making PHP 5 a first class citizen? If done, we'd >> no longer have phrases like: >> >> - As of PHP 5 >> - Since PHP 5 >> - Added in

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-23 Thread Hannes Magnusson
On Sat, Jan 23, 2010 at 08:25, Philip Olson wrote: > Hello everyone, > > What do people think about making PHP 5 a first class citizen? If done, we'd > no longer have phrases like: > >  - As of PHP 5 >  - Since PHP 5 >  - Added in PHP 5 What about extensions, features and language things? http:

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-23 Thread Philip Olson
On Jan 23, 2010, at 12:05 AM, Karoly Negyesi wrote: >> And because nobody really uses 5.0.x, we could easily make 5.1.0 the base. >> And we could tag the current manual and have it available somewhere, in case >> some pour soul really wants it. What do people think? > > http://gophp5.org/ 5.2.

Re: [PHP-DOC] Making PHP 5 a first class citizen

2010-01-23 Thread Karoly Negyesi
> And because nobody really uses 5.0.x, we could easily make 5.1.0 the base. > And we could tag the current manual and have it available somewhere, in case > some pour soul really wants it. What do people think? http://gophp5.org/ 5.2.0 I would hope. Regards NK

[PHP-DOC] Making PHP 5 a first class citizen

2010-01-22 Thread Philip Olson
Hello everyone, What do people think about making PHP 5 a first class citizen? If done, we'd no longer have phrases like: - As of PHP 5 - Since PHP 5 - Added in PHP 5 Because readers are expected to be using PHP 5. However, I'm against version (x.X.x) specific manuals for two main reason