diff options
author | Marcus Boerger <helly@php.net> | 2002-08-13 20:55:42 +0000 |
---|---|---|
committer | Marcus Boerger <helly@php.net> | 2002-08-13 20:55:42 +0000 |
commit | 0a845714b7fd56f8f68c0135d84d0199108806d8 (patch) | |
tree | 9415fc279d0522d0f9852bb088df31fc8cccc05a /CODING_STANDARDS | |
parent | 17d1c75b8be22b83f4d75e7f5ba8e3954977e94d (diff) | |
download | php-git-0a845714b7fd56f8f68c0135d84d0199108806d8.tar.gz |
-better use external example
-say NULL is intended
-correct example
#hope this is a bit easier to understand and clears it a bit
Diffstat (limited to 'CODING_STANDARDS')
-rw-r--r-- | CODING_STANDARDS | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/CODING_STANDARDS b/CODING_STANDARDS index abdfbb7092..b588a88f3b 100644 --- a/CODING_STANDARDS +++ b/CODING_STANDARDS @@ -64,21 +64,21 @@ Exceptions: This can be done automatically using php_error_docref(). The first parameter, docref, is either NULL or the URL of a page describing the - error in detail. If you pass NULL, the reference is generated from - the name of the function being executed: + error in detail. In most cases you will pass NULL, to generate the URL + from the name of the function being executed: php_error_docref(NULL TSRMLS_CC, E_WHATEVER, "Desc."); If you pass a URL, it can either be a full URL beginning with "http://": - php_error_docref("http://www.php.net/manual/en/function.fopen#error" + php_error_docref("http://externalsite.tld/page.ext#error" TSRMLS_CC, E_WHATEVER, "Desc."); Or the name of a manual page without file extension, but with an optional target anchor. Or simply the anchor within the manual page of the current function. When using function names you must replace '_' by '-': - php_error_docref("function.ext_func#error" TSRMLS_CC, E_WHATEVER, "Desc."); + php_error_docref("function.ext-func#error" TSRMLS_CC, E_WHATEVER, "Desc."); To display one or two important parameters after the function name, use php_error_docref1() or php_error_docref2(). For example, file functions |