Re: [PHP-DOC] Remove delete()

2008-11-26 Thread Daniel Brown
2008/11/26 Jakub Vrána <[EMAIL PROTECTED]>:
> Hello!
>
> Would you agree with removal of delete() dummy entry from PHP
> documentation? The problem is that tools using the documentation
> (several IDEs) think that delete() is a real function and highlight it
> as other functions.

I definitely wouldn't agree.  Keeping in mind that this is the
official manual, we have a duty and obligation to newbies who are just
looking at their first "Hello World" script as well as those who are
developing mission-critical web systems for corporate and government
agencies.  Removing an entry from the online manual would be
tantamount to ripping out the pages in the Yellow Pages that tell you
which category to see when trying to find something specific.  Unless
the reader is familiar with programming and/or POSIX systems, they've
probably never heard of 'unlink.'

I understand your angle, Jakub, but I don't think it would be the
proper course of action in this particular case.

-- 

http://www.parasane.net/
[EMAIL PROTECTED] || [EMAIL PROTECTED]
1 LEFT: $149/mo. $0 Setup - Dual-Core/320GB HDD/1GB RAM/3TB
100Mbps/cPanel - SAME-DAY SETUP! Contact me to buy.


Re: [PHP-DOC] Remove delete()

2008-11-26 Thread Brandon Savage
Absolutely not.

delete() is how I found out about unlink() in the first place when I was a
newbie developer.

IDEs that use the PHP documentation may highlight it as a function, but
that's poor work on their part, not on the documentation.

My 0.02.

Brandon

2008/11/26 Jakub Vrána <[EMAIL PROTECTED]>

> Hello!
>
> Would you agree with removal of delete() dummy entry from PHP
> documentation? The problem is that tools using the documentation
> (several IDEs) think that delete() is a real function and highlight it
> as other functions.
>
> Jakub Vrána
>
>


[PHP-DOC] Remove delete()

2008-11-26 Thread Jakub Vrána
Hello!

Would you agree with removal of delete() dummy entry from PHP
documentation? The problem is that tools using the documentation
(several IDEs) think that delete() is a real function and highlight it
as other functions.

Jakub Vrána