diff --git a/reference/sem/functions/sem-acquire.xml b/reference/sem/functions/sem-acquire.xml
index e73672cb83..fb3d6cbbf5 100644
--- a/reference/sem/functions/sem-acquire.xml
+++ b/reference/sem/functions/sem-acquire.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/sem.xml, last change in rev 1.2 -->
   <refentry id="function.sem-acquire">
    <refnamediv>
@@ -12,9 +12,6 @@
       <type>bool</type><methodname>sem_acquire</methodname>
       <methodparam><type>int</type><parameter>sem_identifier</parameter></methodparam>
      </methodsynopsis>
-    <para>
-     Returns: &true; on success, &false; on error.
-    </para>
     <para>
      <function>sem_acquire</function> blocks (if necessary) until the
      semaphore can be acquired.  A process attempting to acquire a
@@ -22,6 +19,9 @@
      if acquiring the semaphore would cause its max_acquire value to
      be exceeded.
     </para>
+    <para>
+     &return.success;
+    </para>
     <para>
      After processing a request, any semaphores acquired by the
      process but not explicitly released will be released automatically
diff --git a/reference/sem/functions/sem-get.xml b/reference/sem/functions/sem-get.xml
index 1da83c9e6f..0c93d12e46 100644
--- a/reference/sem/functions/sem-get.xml
+++ b/reference/sem/functions/sem-get.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/sem.xml, last change in rev 1.2 -->
   <refentry id="function.sem-get">
    <refnamediv>
@@ -14,10 +14,6 @@
       <methodparam choice="opt"><type>int</type><parameter>max_acquire</parameter></methodparam>
       <methodparam choice="opt"><type>int</type><parameter>perm</parameter></methodparam>
      </methodsynopsis>
-    <para>
-     Returns: A positive semaphore identifier on success, or &false; on
-     error.
-    </para>
     <para>
      <function>sem_get</function> returns an id that can be used to
      access the System V semaphore with the given key.  The semaphore
@@ -27,6 +23,10 @@
      (defaults to 1).  Actually this value is set only if the process
      finds it is the only process currently attached to the semaphore.
     </para>
+    <para>
+     Returns: A positive semaphore identifier on success, or &false; on
+     error.
+    </para>
     <para>
      A second call to <function>sem_get</function> for the same key
      will return a different semaphore identifier, but both
diff --git a/reference/sem/functions/sem-release.xml b/reference/sem/functions/sem-release.xml
index c19b47946e..d9b1e347bf 100644
--- a/reference/sem/functions/sem-release.xml
+++ b/reference/sem/functions/sem-release.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/sem.xml, last change in rev 1.2 -->
   <refentry id="function.sem-release">
    <refnamediv>
@@ -12,20 +12,21 @@
       <type>bool</type><methodname>sem_release</methodname>
       <methodparam><type>int</type><parameter>sem_identifier</parameter></methodparam>
      </methodsynopsis>
-    <para>
-     Returns: &true; on success, &false; on error.
-    </para>
     <para>
      <function>sem_release</function> releases the semaphore if it
      is currently acquired by the calling process, otherwise
      a warning is generated.
     </para>
+    <para>
+     &return.success;
+    </para>
     <para>
       After releasing the semaphore, <function>sem_acquire</function>
       may be called to re-acquire it.
     </para>
     <para> 
-     See also: <function>sem_get</function> and
+     See also
+     <function>sem_get</function> and
      <function>sem_acquire</function>.
     </para>
     <note>
diff --git a/reference/sem/functions/sem-remove.xml b/reference/sem/functions/sem-remove.xml
index d1d9e60c1e..76b81907b4 100644
--- a/reference/sem/functions/sem-remove.xml
+++ b/reference/sem/functions/sem-remove.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/sem.xml, last change in rev 1.7 -->
   <refentry id="function.sem-remove">
    <refnamediv>
@@ -12,16 +12,15 @@
       <type>bool</type><methodname>sem_remove</methodname>
       <methodparam><type>int</type><parameter>sem_identifier</parameter></methodparam>
      </methodsynopsis>
-    <para>
-     Returns: &true; on success, &false;
-     on error.
-    </para>
     <para>
      <function>sem_remove</function> removes the semaphore
      <parameter>sem_identifier</parameter> if it
      has been created by <function>sem_get</function>, 
      otherwise generates a warning.
     </para>
+    <para>
+     &return.success;
+    </para>
     <para>
       After removing the semaphore, it is no more accessible.
     </para>
diff --git a/reference/sem/functions/shm-attach.xml b/reference/sem/functions/shm-attach.xml
index d3e428bf79..9143aa0b20 100644
--- a/reference/sem/functions/shm-attach.xml
+++ b/reference/sem/functions/shm-attach.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/sem.xml, last change in rev 1.2 -->
   <refentry id="function.shm-attach">
    <refnamediv>
@@ -17,10 +17,10 @@
     <para>
      <function>shm_attach</function> returns an id that that can be
      used to access the System V shared memory with the given key, the
-     first call creates the shared memory segment with mem_size
-     (default: sysvshm.init_mem in the <link
-     linkend="configuration.file">configuration file</link>, otherwise
-     10000 bytes) and the optional perm-bits (default: 0666).
+     first call creates the shared memory segment with <parameter>memsize</parameter>
+     (default: sysvshm.init_mem in the &php.ini, otherwise
+     10000 bytes) and the optional perm-bits <parameter>perm</parameter>
+     (default: 0666).
     </para>
     <para>
      A second call to <function>shm_attach</function> for the same