From 0a845714b7fd56f8f68c0135d84d0199108806d8 Mon Sep 17 00:00:00 2001 From: Marcus Boerger Date: Tue, 13 Aug 2002 20:55:42 +0000 Subject: [PATCH] -better use external example -say NULL is intended -correct example #hope this is a bit easier to understand and clears it a bit --- CODING_STANDARDS | 8 ++++---- 1 file 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 -- 2.40.0