summaryrefslogtreecommitdiff
path: root/CODING_STANDARDS
diff options
context:
space:
mode:
authorMarcus Boerger <helly@php.net>2002-08-13 20:55:42 +0000
committerMarcus Boerger <helly@php.net>2002-08-13 20:55:42 +0000
commit0a845714b7fd56f8f68c0135d84d0199108806d8 (patch)
tree9415fc279d0522d0f9852bb088df31fc8cccc05a /CODING_STANDARDS
parent17d1c75b8be22b83f4d75e7f5ba8e3954977e94d (diff)
downloadphp-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_STANDARDS8
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