_please_ use the webinterface for feedback... I missed this mail in my
reply.
--jeroen
"Robert J Sherman" <[EMAIL PROTECTED]> wrote in message
[EMAIL PROTECTED]">news:[EMAIL PROTECTED]...
> That's nice -- but.. since the manual states that it is "not" a good idea
> to use
> the alias.. I would think the manual should at the very least, indicate
> which is which..
>
> In addition, there is a lot of "duplicates" in the alias list..
>
> To say that it doesn't matter which is which, and then to say "not a good
idea"
> is sorta silly... After all the whole reason in listing what aliases to
> what, is to let
> developers no which functions are now obsolete, while still allowing the
> older functions
> in older scripts to operate..
>
> So, in short, It does matter how it's documented.. if function x was
> removed (all together)
> and this was documented "backward" or "unclearly" you have a lot scripts
> that just quit
> functioning.. and this then falls back on those who maintain the
documentation.
>
> As a developer, good clear and more importantly "correct" documentation is
> important.
>
> Now as for chop and rtrim.. the function definition for chop() indicates
> the "exact" opposite
>
> --- according the chop function information "it" is the alias.. while the
> appendix states it's the
> master ---
>
> For those who have been authoring PHP for sometime, this is no "big
deal"..
> but for the new user
> it becomes important that they know the difference..
>
>
> At 05:28 AM 8/21/01 +0000, you wrote:
> >ID: 12868
> >Updated by: joey
> >Reported By: [EMAIL PROTECTED]
> >Status: Open
> >Bug Type: Documentation problem
> >Operating System: win32
> >PHP Version: 4.0.6
> >New Comment:
> >
> >I don't understand why it matters which is the 'master'
> >and which is the alias? I would guess that the reason for
> >the inconsistency in the documentation is that it really
> >doesn't matter which is which, so the doc team is not all
> >that careful about it. But that's just a guess...this
> >wouldn't be all that hard to clear up.
> >
> >FWIW, rtrim() is an alias to chop() and fputs() is an alias
> >to fwrite().
> >
> >Previous Comments:
> >------------------------------------------------------------------------
> >
> >[2001-08-21 00:12:18] [EMAIL PROTECTED]
> >
> >This is truly a followup to my previous post - message about what appears
> >to be "descrepancies" in Appendix G.. which has further some confusion as
> >to "which" functions are "truly" an alias and which is the "master
function"..
> >
> >I guess I need to "understand" what the master function is supposed to
be,
> >and what an alias is supposed to be.
> >
> >Perhaps I have these backwards, and thus the confusion, but
> >some of this doesn't quite set right..
> >
> >The first function in the list (chop) is labeled as the master function,
> >and it's alias as (rtrim).. but when you go to the master function,
(chop)
> >it's documentation indicates it's the alias. and to see rtrim for
details.
> >
> >There are some functions in this list like - fwrite() and fputs() - where
> >fwrite is labled as the master and fputs the alias.. while the
> >documentaion for both functions do not indicate either as an alias..
> >
> >This goes on.. naturally some of these make perfect sense, if you looke
at
> >is_double() marked as a master - having aliases of is_float() and
> >is_real().. the documentation corresponds perfectly..
> >
> >i.e. if you call up is_float() or is_real() it directs you to
> >is_double().. which brings "some" understanding back.
> >
> >and jives with what "I" would preceive as the relationship between a
> >"master function" and an alias.
> >
> >Input on this matter would "greatly" be appreciated..
> >
> >thanks a bunch.
> >
> >------------------------------------------------------------------------
> >
> >
> >
> >ATTENTION! Do NOT reply to this email!
> >To reply, use the web interface found at
http://bugs.php.net/?id=12868&edit=2
>
> Kind Regards
>
> Robert J Sherman
> DBA SnR Graphics
> 827 W 13th St
> Joplin, MO 64804
> 417.626.7759 ph
> 877.626.9876 toll free (US and Canada)
>
> [EMAIL PROTECTED]
>
> SnR Graphics
> Low Cost Solutions to Web Development
> http://www.snr-graphics.com/
>
--
PHP Development Mailing List <http://www.php.net/>
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]
