From: Ron Chmara Date: Wed, 18 Oct 2000 07:34:56 +0000 (+0000) Subject: As per andi, similar names are for legacy reasons only. X-Git-Tag: php-4.0.4RC3~638 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d47e48329b80e8e4721a9ee62b184378185ba7db;p=php As per andi, similar names are for legacy reasons only. --- diff --git a/CODING_STANDARDS b/CODING_STANDARDS index e53ee4f95a..5e4a7b7ae6 100644 --- a/CODING_STANDARDS +++ b/CODING_STANDARDS @@ -162,23 +162,17 @@ Optional arguments are written like this: And yes, please keep everything on a single line, even if that line is massive. -User Aliases --------------------- -You may also have some user-level aliases with close to duplicate +Aliases & Legacy Documentation +----------------------------------- +You may also have some deprecated aliases with close to duplicate names, for example, somedb_select_result and somedb_selectresult. For documentation puposes, these will only be documented by the most -clearly separated name, with the aliases listed in the documentation for +current name, with the aliases listed in the documentation for the parent function. For ease of reference, user-functions with completely different names, that alias to the same function (such as highlight_file and show_source), will be separately documented. The proto should still be included, describing which function is aliased. - -Legacy Documentation --------------------- -In order to retire older function naming conventions, older -function name variants, when changed, will only be documented under -their current function name, as aliases. Backwards compatible functions -and names should be maintained as long as the code can be reasonably -be kept as part of the codebase. See /phpdoc/README for me information -on documentation. +Backwards compatible functions and names should be maintained as long +as the code can be reasonably be kept as part of the codebase. See +/phpdoc/README for me information on documentation.