suggestion: function family names
| From: | J.M. Coder | Date: | Thu, 10 Mar 2005 16:44:30 +0000 |
| Subject: | suggestion: function family names | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969366931@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.
Regards,
James