Re: suggestion: function family names

From: Date: Thu, 10 Mar 2005 17:09:49 +0000
Subject: Re: suggestion: function family names
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969366933@lists.php.net to get a copy of this message
Thx to Sean Coates for his suggestion re. getting synopsized info from the manual. I have a small suggestion after looking at Sean's excellent site phpdoc.info and looking at the schema DocSkel, http://wiki.phpdoc.info/DocSkel/FunctionskeletonDotXml?v=103j At the moment, functions are divided into separate chapters, or sections, of the function reference, with real-language sounding names in the anchortext and [a-z0-9]+ names in the links, which differ from the real-language names. Real language names usually don't make efficient classifiers for automated tasks, w/spaces and alternate spellings and all, but I as yet don't see any officially sanctioned classification names. I'm not familliar with the workings of the docs generation process, but could I suggest, why not just officialize the current [a-z0-9]+ function family names as they're found in the manual links? This would give people who are writing stuff for manipulating/presenting the docs a bit more of a permanent way to refer to them. Otherwise these names are just fairly arbitrary words in the links, which can change without much thought. If there are official classification names floating around somewhere, would appreciate a headsup.
Function names, like mysql_num_rows becomes mysql-num-rows in the URL, this is formalized. What is the problem with this, or what else would you like to have? Would you please provide examples? Goba

« previous php.doc (#969366933) next »