where to make observations about current PHP manual?

i don't see a separate mailing list for documentation so is this
where i would point at oddities in the manual? as in, here:

http://www.php.net/manual/en/language.variables.external.php

we read:

"// Unavailable since PHP 6."

that just looks weird, no?

rday
--

============================================================ ============
Robert P. J. Day Waterloo, Ontario, CANADA

Linux Consulting, Training and Kernel Pedantry.

Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
============================================================ ============

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Re: where to make observations about current PHP manual?

Robert P. J. Day wrote:
> i don't see a separate mailing list for documentation so is this
> where i would point at oddities in the manual? as in, here:
>
> http://www.php.net/manual/en/language.variables.external.php
>
> we read:
>
> "// Unavailable since PHP 6."
>
> that just looks weird, no?
>
> rday
> --
>
> ============================================================ ============
> Robert P. J. Day Waterloo, Ontario, CANADA
>
> Linux Consulting, Training and Kernel Pedantry.
>
> Web page: http://crashcourse.ca
> Twitter: http://twitter.com/rpjday
> ============================================================ ============

$HTTP_POST_VARS was the way to access post vars in PHP before 4.1. Since
then it is $_POST, and $HTTP_POST_VARS is only available if you set
register_long_arrays = On in php.ini. As of PHP 6 $HTTP_POST_VARS will
not be available, you must use $_POST.

--
Thanks!
-Shawn
http://www.spidean.com

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Re: where to make observations about current PHP manual?

On Fri, 19 Mar 2010, Shawn McKenzie wrote:

> Robert P. J. Day wrote:
> > i don't see a separate mailing list for documentation so is this
> > where i would point at oddities in the manual? as in, here:
> >
> > http://www.php.net/manual/en/language.variables.external.php
> >
> > we read:
> >
> > "// Unavailable since PHP 6."
> >
> > that just looks weird, no?
> >
> > rday
>
> $HTTP_POST_VARS was the way to access post vars in PHP before 4.1.
> Since then it is $_POST, and $HTTP_POST_VARS is only available if
> you set register_long_arrays = On in php.ini. As of PHP 6
> $HTTP_POST_VARS will not be available, you must use $_POST.

i'm not sure that addresses my post -- it doesn't make grammatical
sense to state that something is unavailable "since" something that is
yet to be officially released.

rday
--


============================================================ ============
Robert P. J. Day Waterloo, Ontario, CANADA

Linux Consulting, Training and Kernel Pedantry.

Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
============================================================ ============

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Re: where to make observations about current PHP manual?

On Fri, Mar 19, 2010 at 16:59, Robert P. J. Day wro=
te:
>
> =A0i don't see a separate mailing list for documentation so is this
> where i would point at oddities in the manual? =A0as in, here:
>
> http://www.php.net/manual/en/language.variables.external.php
>
> we read:
>
> "// Unavailable since PHP 6."
>
> that just looks weird, no?

Indeed. It would probably be better to read, "Unavailable as of
PHP 6." I'll patch that in the XML sources now, and the next time the
manual rebuilds, the changes will take effect.

For the future, please report such things as Documentation
Problems at http://bugs.php.net/.

Thanks for the report, Rob!

--=20

daniel.brown@parasane.net || danbrown@php.net
http://www.parasane.net/ || http://www.pilotpig.net/
Looking for hosting or dedicated servers? Ask me how we can fit your budge=
t!

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Re: Re: where to make observations about current PHP manual?

On Fri, Mar 19, 2010 at 20:57, Robert P. J. Day wro=
te:
>
> =A0i'm not sure that addresses my post -- it doesn't make grammatical
> sense to state that something is unavailable "since" something that is
> yet to be officially released.

In most cases, you'd be absolutely correct.... but PHP is a
developer-focused open source project, so some folks in the community
do use PHP 6. If you'd like to be one of them, we'd certainly welcome
the extra help in finding and reporting bugs! You can always download
the latest snapshot builds at:

http://snaps.php.net/

--=20

daniel.brown@parasane.net || danbrown@php.net
http://www.parasane.net/ || http://www.pilotpig.net/
Looking for hosting or dedicated servers? Ask me how we can fit your budge=
t!

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Re: where to make observations about current PHP manual?

On Fri, Mar 19, 2010 at 21:04, Daniel Brown wrote:
>
> =A0 =A0Indeed. =A0It would probably be better to read, "Unavailable as of
> PHP 6." =A0I'll patch that in the XML sources now, and the next time the
> manual rebuilds, the changes will take effect.

Future builds will appear as hinted in the following SVN commit log:

http://news.php.net/php.doc.cvs/6235

Thanks again for the suggestion, Rob.

--=20

daniel.brown@parasane.net || danbrown@php.net
http://www.parasane.net/ || http://www.pilotpig.net/
Looking for hosting or dedicated servers? Ask me how we can fit your budge=
t!

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Re: where to make observations about current PHP manual?

--8323328-1688471319-1269074394=:19758
Content-Type: TEXT/PLAIN; charset=ISO-8859-1
Content-Transfer-Encoding: QUOTED-PRINTABLE

On Fri, 19 Mar 2010, Daniel Brown wrote:

> On Fri, Mar 19, 2010 at 16:59, Robert P. J. Day w=
rote:
> >
> > =A0i don't see a separate mailing list for documentation so is this
> > where i would point at oddities in the manual? =A0as in, here:
> >
> > http://www.php.net/manual/en/language.variables.external.php
> >
> > we read:
> >
> > "// Unavailable since PHP 6."
> >
> > that just looks weird, no?
>
> Indeed. It would probably be better to read, "Unavailable as of
> PHP 6." I'll patch that in the XML sources now, and the next time
> the manual rebuilds, the changes will take effect.

precisely the point i was trying to make, but i might avoid the use
of the word "unavailable" since that's still slightly ambiguous. it
makes it seem like it's still there somehow, you just can't get to it.
i would be more direct, something like "*removed* as of PHP 6." then
there's no confusion.

> For the future, please report such things as Documentation
> Problems at http://bugs.php.net/.

ok, will do.

rday
--

==================== =====3D=
==================== =====3D=
==================== ==
Robert P. J. Day Waterloo, Ontario, CANADA

Linux Consulting, Training and Kernel Pedantry.

Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
==================== =====3D=
==================== =====3D=
==================== ==

--8323328-1688471319-1269074394=:19758
Content-Type: text/plain; charset=us-ascii

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
--8323328-1688471319-1269074394=:19758--

Re: Re: where to make observations about current PHP manual?

--8323328-1708135091-1269081224=:3243
Content-Type: TEXT/PLAIN; charset=ISO-8859-1
Content-Transfer-Encoding: QUOTED-PRINTABLE

On Fri, 19 Mar 2010, Daniel Brown wrote:

> On Fri, Mar 19, 2010 at 20:57, Robert P. J. Day w=
rote:
> >
> > =A0i'm not sure that addresses my post -- it doesn't make grammatical
> > sense to state that something is unavailable "since" something that is
> > yet to be officially released.
>
> In most cases, you'd be absolutely correct.... but PHP is a
> developer-focused open source project, so some folks in the community
> do use PHP 6. If you'd like to be one of them, we'd certainly welcome
> the extra help in finding and reporting bugs! You can always download
> the latest snapshot builds at:
>
> http://snaps.php.net/

surely there's a svn checkout for the ongoing php 6, yes?

rday
--

==================== =====3D=
==================== =====3D=
==================== ==
Robert P. J. Day Waterloo, Ontario, CANADA

Linux Consulting, Training and Kernel Pedantry.

Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
==================== =====3D=
==================== =====3D=
==================== ==

--8323328-1708135091-1269081224=:3243
Content-Type: text/plain; charset=us-ascii

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
--8323328-1708135091-1269081224=:3243--