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 <phi...@roshambo.org> wrote:

>
> 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 sources from En doc.
> >
> > So, what to do ?
> >
> > I'm +1 to put away all the references with "PHP4" inside. We all know
> PHP4 is not supported any more, it should just move to the museum.
> > Actually, I'm reading and correcting typos in the Fr doc, should I go to
> remove everything talking about PHP4 (obviously except the specific chapter
> about PHP4 objects) ?
> >
> > Exemple from session : "PHP_INI_ALL in PHP <= 4.2.3. PHP_INI_PERDIR in
> PHP < 5. Available since PHP 4.0.3"
> > That is something really boring to read, confusing, and completly out of
> date.
>
> Greetings Julien,
>
> Okay, let's do it. Creating changelog entries everywhere is one option but
> the work involved no longer feels worth it. Let's consider the current
> manual as "The PHP 4/5 Manual" and finally remove all PHP 4 specific
> references from SVN. Well, except for a few exceptions like the dom page
> should mention the domxml vs dom issue.
>
> The topic of version specific manuals comes up occasionally but I don't see
> it working. I won't go into detail with my feelings now, but lean towards
> thinking it's a bad idea even if it could be done with a magic wand.
>
> As for which version of PHP 5 to go with, that's a tougher question. I
> forget most of the proposed solutions but think there are several and will
> search the archives this week. Solutions that limit the inline versioning
> text (e.g., "As of PHP 5.1.0, Foo and Bar...") are ideal. I think version
> specific XML attributes was one thought, where PhD would handle it and
> output something useful.
>
> And lastly, the INI version information is/was generated by
> doc-base/scripts/iniupdate/* but in reality, it no longer works and people
> have been editing the XML by hand. However, it's something to keep in mind.
>
> What do people think about all of this? :)
>
> Regards,
> Philip
>
>

Reply via email to