#34789 [Opn]: userland naming guide

ID: 34789 Updated by: nlopess@php.net Reported By: lsmith@php.net Status: Open Bug Type: Documentation problem Operating System: irrlevant PHP Version: Irrelevant New Comment: (sorry for double post) about your first question, if you feel unconfortable with commiting the patch, just ask one of us in the IRC to review it or post a link here and we'll review and commit it. Previous Comments: ------------------------------------------------------------------------ [2006-07-23 18:18:30] nlopess@php.net I think a good place is the appendix. And link it from the oop5 page. ------------------------------------------------------------------------ [2006-07-21 08:38:14] lsmith@php.net OK, I think I have phpdoc karma. However I do not have a way to test changes, nor experience with phpdoc (though I am sure I will be able to figure out the xml syntax). I would however like to add the updated document. How should I best go about doing this? Where should I add the document? ------------------------------------------------------------------------ [2005-11-25 13:01:55] lsmith@php.net I have begun writing a guide over here: http://oss.backendmedia.com/UserlandNamingGuide ------------------------------------------------------------------------ [2005-11-25 09:57:37] lsmith@php.net actually we probably need to say that anything that goes into the global namespace needs to be prefixed by a fairly random (hopefully unique within the php community) 3-4 letter prefix or breakage is to be expected .. see the recent issues with the File and Date objects ------------------------------------------------------------------------ [2005-10-13 11:49:53] vrana@php.net In language/oop.xml is already mentioned this: "PHP reserves all function names starting with __ as magical. It is recommended that you do not use function names with __ in PHP unless you want some documented magic functionality." ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/34789 -- Edit this bug report at http://bugs.php.net/?id=34789&edit=1