[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

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

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.

-- 
/Daniel P. Brown
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.