PHP参考手册中的openlog函数说明误导

PHP参考手册中的openlog函数说明如下：

openlog — Open connection to system logger

Description
bool openlog ( string $ident, int $option, int $facility )
openlog() opens a connection to the system logger for a program.
......
Return Values
Returns TRUE on success or FALSE on failure.
手册里面对openlog这样介绍，让人误认为如果"system logger"没有正常工作或者
停止，则openlog会打开失败，但是实际测试情况是openlog永远返回true!

因为，openlog对C的包装是这样的：
PHP_FUNCTION(openlog)
{
char *ident;
long option, facility;
int ident_len;

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sll",
&ident,
&ident_len,
&option, &facility) == FAILURE) {
return;
}
if (BG(syslog_device)) {
efree(BG(syslog_device));
}
BG(syslog_device) = estrndup(ident, ident_len);
openlog(BG(syslog_device), option, facility);
RETURN_TRUE;
}
该函数永远RETURN_TRUE！不知道php手册中还有那些函数存在这种情况？如果只根
据手册来决定处理策略，没有对程序各分支流程进行测试，则可能想当然的情况与
真实情况有较大出入。

该函数出现这种情况，可能和C的标准函数：

man openlog..
SYNOPSIS
#include <syslog.h>

void openlog(const char *ident, int option, int facility);
void syslog(int priority, const char *format, ...);
void closelog(void);
openlog也没有返回值相关


继续看openlog的一个实现版本：
void openlog(char *ident, int option, int facility)
{
struct job *job = gettib()->job;

if (ident && strlen(ident) < 64)
{
if (job->ident)
{
char *oldident = job->ident;
job->ident = strdup(ident);
free(oldident);
}
else
job->ident = strdup(ident);
}

job->facility = facility;
}
该函数只做设置，不会返回成功与否。
linux的glibc的openlog实现也类似，没有相应的返回值。


故php的openlog永远返回true，是符合逻辑但是手册会令人误解的!