Doc #53349 [NEW]: Break out the two pages on magic methods/overloading

From: Operating system: PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:Break out the two pages on magic methods/overloading Description: ------------ Suggest breaking /language.oop5.overloading.php and /language.oop5.magic.php manual pages into a group of sub pages, dedicating one page per magic method. There is quite a lot of information missing in the docs on the behavior of magic methods, such as __get()'s special involvement with objects and arrays that are locked properties, __set()'s lack of involvement with objects and arrays that are locked properties, being able to define magic method function signatures in interfaces, being able to use __toString() to do something like 'echo new Test;', being able to define '&__get()' to return a locked property by reference, etc. It would help to expand on the special behavior of each magic method, but the current pair of pages are getting too long and duplicating information, especially with all the user comments. Test script: --------------- n/a - involves manual pages -- Edit bug report at http://bugs.php.net/bug.php?id=53349&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=53349&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=53349&r=trysnapshot53 Try a snapshot (trunk): http://bugs.php.net/fix.php?id=53349&r=trysnapshottrunk Fixed in SVN: http://bugs.php.net/fix.php?id=53349&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=53349&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=53349&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=53349&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=53349&r=needscript Try newer version: http://bugs.php.net/fix.php?id=53349&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=53349&r=support Expected behavior: http://bugs.php.net/fix.php?id=53349&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=53349&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=53349&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=53349&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=53349&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=53349&r=dst IIS Stability: http://bugs.php.net/fix.php?id=53349&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=53349&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=53349&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=53349&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=53349&r=mysqlcfg