From 7d8389d5bd38ceabc1703ad1a8c1a69988d84385 Mon Sep 17 00:00:00 2001
From: Nuno Lopes <nlopess@php.net>
Date: Sat, 25 Sep 2004 09:27:26 +0000
Subject: [PATCH] initial docs

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@169153 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/math/functions/expm1.xml            | 22 +++++++++++++------
 reference/math/functions/log1p.xml            | 18 ++++++++++-----
 .../pgsql/functions/pg-parameter-status.xml   | 16 +++++++++-----
 reference/pgsql/functions/pg-version.xml      | 10 +++++----
 4 files changed, 44 insertions(+), 22 deletions(-)

diff --git a/reference/math/functions/expm1.xml b/reference/math/functions/expm1.xml
index e535e35d58..f20c968301 100644
--- a/reference/math/functions/expm1.xml
+++ b/reference/math/functions/expm1.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/math.xml, last change in rev 1.63 -->
   <refentry id='function.expm1'>
    <refnamediv>
@@ -11,15 +11,23 @@
    </refnamediv>
    <refsect1>
     <title>Description</title>
-     <methodsynopsis>
-      <type>float</type><methodname>expm1</methodname>
-      <methodparam><type>float</type><parameter>number</parameter></methodparam>
-     </methodsynopsis>
-     &warn.experimental.func;
+    <methodsynopsis>
+     <type>float</type><methodname>expm1</methodname>
+     <methodparam><type>float</type><parameter>number</parameter></methodparam>
+    </methodsynopsis>
+    &warn.experimental.func;
     <para>
-     &warn.undocumented.func;
+     <function>expm1</function> returns the equivalent to
+     'exp(<parameter>number</parameter>) -  1' computed in a way that is
+     accurate even if the value of <parameter>number</parameter> is near zero,
+     a case where 'exp (<parameter>number</parameter>) - 1' would be
+     inaccurate due to subtraction of two numbers that are nearly equal.
     </para>
     &note.no-windows;
+    <para>
+     See also <function>log1p</function> and
+     <function>exp</function>.
+    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/math/functions/log1p.xml b/reference/math/functions/log1p.xml
index e65e7382dd..9d37dd363f 100644
--- a/reference/math/functions/log1p.xml
+++ b/reference/math/functions/log1p.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/math.xml, last change in rev 1.63 -->
   <refentry id='function.log1p'>
    <refnamediv>
@@ -11,15 +11,21 @@
    </refnamediv>
    <refsect1>
     <title>Description</title>
-     <methodsynopsis>
-      <type>float</type><methodname>log1p</methodname>
-      <methodparam><type>float</type><parameter>number</parameter></methodparam>
-     </methodsynopsis>
+    <methodsynopsis>
+     <type>float</type><methodname>log1p</methodname>
+     <methodparam><type>float</type><parameter>number</parameter></methodparam>
+    </methodsynopsis>
     &warn.experimental.func;
     <para>
-     &warn.undocumented.func;
+     <function>log1p</function> returns log(1 +
+     <parameter>number</parameter>) computed in a way that is accurante even
+     when the value of <parameter>number</parameter> is close to zero.
     </para>
     &note.no-windows;
+    <para>
+     See also <function>expm1</function> and
+     <function>log</function>.
+    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/pgsql/functions/pg-parameter-status.xml b/reference/pgsql/functions/pg-parameter-status.xml
index 73b32b0dc4..68d752aa71 100644
--- a/reference/pgsql/functions/pg-parameter-status.xml
+++ b/reference/pgsql/functions/pg-parameter-status.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <refentry id="function.pg-parameter-status">
  <refnamediv>
   <refname>pg_parameter_status</refname>
@@ -12,11 +12,17 @@
   <methodsynopsis>
    <type>string</type><methodname>pg_parameter_status</methodname>
    <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>param_name</parameter></methodparam>
+   <methodparam><type>string</type><parameter>param_name</parameter></methodparam>
   </methodsynopsis>
-
-   &warn.undocumented.func;
-
+  <para>
+   <function>pg_parameter_status</function> returns a string with the
+   current <parameter>param_name</parameter> value. Returns &false; on
+   failure.
+  </para>
+  <para>
+   The parameters currently avaliable include: server_version,
+   client_encoding, is_superuser, session_authorization, and DateStyle.
+  </para>  
  </refsect1>
 </refentry>
 
diff --git a/reference/pgsql/functions/pg-version.xml b/reference/pgsql/functions/pg-version.xml
index 645df47626..5c7c603196 100644
--- a/reference/pgsql/functions/pg-version.xml
+++ b/reference/pgsql/functions/pg-version.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <refentry id="function.pg-version">
  <refnamediv>
   <refname>pg_version</refname>
@@ -13,9 +13,11 @@
    <type>array</type><methodname>pg_version</methodname>
    <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam>
   </methodsynopsis>
-
-   &warn.undocumented.func;
-
+  <para>
+   <function>pg_version</function> returns an array with the client, protocol
+   and server version. Protocol and server versions are only avaliable if PHP
+   was compiled with PostgreSQL 7.4 or later.
+  </para>
  </refsect1>
 </refentry>