From 07631eab810f9f64fa1b26b90c49d75c2cc041b3 Mon Sep 17 00:00:00 2001
From: Logan Buesching <ljbuesch@php.net>
Date: Tue, 8 May 2007 03:47:42 +0000
Subject: [PATCH] Removed shebang's as requested by Nuno. Fixed structure of
 refsects

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@235205 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/posix/functions/posix-ctermid.xml   | 21 ++++++++--------
 .../posix/functions/posix-get-last-error.xml  |  3 +--
 reference/posix/functions/posix-getcwd.xml    | 25 ++++++++++---------
 reference/posix/functions/posix-getegid.xml   | 21 ++++++++--------
 reference/posix/functions/posix-geteuid.xml   |  3 +--
 reference/posix/functions/posix-getgid.xml    | 16 ++++++------
 reference/posix/functions/posix-getpgid.xml   | 24 ++++++++++--------
 reference/posix/functions/posix-getrlimit.xml | 24 ++++++++++--------
 reference/posix/functions/posix-setegid.xml   |  3 +--
 reference/posix/functions/posix-setgid.xml    |  3 +--
 reference/posix/functions/posix-setuid.xml    |  3 +--
 reference/posix/functions/posix-strerror.xml  |  3 +--
 12 files changed, 74 insertions(+), 75 deletions(-)

diff --git a/reference/posix/functions/posix-ctermid.xml b/reference/posix/functions/posix-ctermid.xml
index 0948c94278..077113b31a 100644
--- a/reference/posix/functions/posix-ctermid.xml
+++ b/reference/posix/functions/posix-ctermid.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.posix-ctermid">
  <refnamediv>
   <refname>posix_ctermid</refname>
@@ -19,6 +19,15 @@
   </para>
  </refsect1>
 
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Upon successful completion, returns <type>string</type> of the pathname to 
+   the current controlling terminal.  Otherwise &false; is returned and errno
+   is set, which can be checked with <function>posix_get_last_error</function>.
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -29,7 +38,6 @@
     </para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 echo "I am running from ".posix_ctermid();
 ?>
@@ -39,15 +47,6 @@ echo "I am running from ".posix_ctermid();
   </para>
  </refsect1>
 
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-   Upon successful completion, returns <type>string</type> of the pathname to 
-   the current controlling terminal.  Otherwise &false; is returned and errno
-   is set, which can be checked with <function>posix_get_last_error</function>.
-  </para>
- </refsect1>
-
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/posix/functions/posix-get-last-error.xml b/reference/posix/functions/posix-get-last-error.xml
index de770ad7df..a2e527ff02 100644
--- a/reference/posix/functions/posix-get-last-error.xml
+++ b/reference/posix/functions/posix-get-last-error.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.posix-get-last-error">
  <refnamediv>
   <refname>posix_get_last_error</refname>
@@ -38,7 +38,6 @@
     </para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 posix_kill(999459,SIGKILL);
 echo 'Your error returned was '.posix_get_last_error(); //Your error was ___
diff --git a/reference/posix/functions/posix-getcwd.xml b/reference/posix/functions/posix-getcwd.xml
index e46b6199da..01685ac9b6 100644
--- a/reference/posix/functions/posix-getcwd.xml
+++ b/reference/posix/functions/posix-getcwd.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry id="function.posix-getcwd">
  <refnamediv>
   <refname>posix_getcwd</refname>
@@ -19,6 +19,15 @@
   </para>
  </refsect1>
 
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns a <type>string</type> of the absolute pathname on success.  
+   On error, returns &false; and sets errno which can be checked with
+   <function>posix_get_last_error</function>.
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -30,7 +39,6 @@
     </para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 echo 'My current working directory is '.posix_getcwd();
 ?>
@@ -42,8 +50,9 @@ echo 'My current working directory is '.posix_getcwd();
  
  <refsect1 role="notes">
   &reftitle.notes;
+  <note>
    <para>
-    This function can fail on can fail on
+    This function can fail on
     <itemizedlist>
      <listitem>
       <simpara>Read or Search permission was denied</simpara>
@@ -53,15 +62,7 @@ echo 'My current working directory is '.posix_getcwd();
      </listitem>
     </itemizedlist> 
    </para>
- </refsect1>
-
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-   Returns a <type>string</type> of the absolute pathname on success.  
-   On error, returns &false; and sets errno which can be checked with
-   <function>posix_get_last_error</function>.
-  </para>
+  </note>
  </refsect1>
 
 </refentry>
diff --git a/reference/posix/functions/posix-getegid.xml b/reference/posix/functions/posix-getegid.xml
index a318592248..d6657651ff 100644
--- a/reference/posix/functions/posix-getegid.xml
+++ b/reference/posix/functions/posix-getegid.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.posix-getegid">
  <refnamediv>
   <refname>posix_getegid</refname>
@@ -16,14 +16,7 @@
    Return the numeric effective group ID of the current process. 
   </para>
  </refsect1>
- <refsect1 role="notes">
-  &reftitle.notes;
-  <para>
-   <function>posix_getegid</function> is different than 
-   <function>posix_getgid</function> by you can change the effective group ID of
-   a calling process using the <function>posix_setegid</function>.
-  </para>
- </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -42,7 +35,6 @@
     </para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 echo 'My real group id is '.posix_getgid(); //20
 posix_setegid(40);
@@ -55,6 +47,15 @@ echo 'My effective group id is '.posix_getegid(); //40
   </para>
  </refsect1>
 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <para>
+   <function>posix_getegid</function> is different than 
+   <function>posix_getgid</function> by you can change the effective group ID of
+   a calling process using the <function>posix_setegid</function>.
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/posix/functions/posix-geteuid.xml b/reference/posix/functions/posix-geteuid.xml
index 3f23d0d6ab..b1f89bb9a3 100644
--- a/reference/posix/functions/posix-geteuid.xml
+++ b/reference/posix/functions/posix-geteuid.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.posix-geteuid">
  <refnamediv>
   <refname>posix_geteuid</refname>
@@ -30,7 +30,6 @@
     the real id and the effective id.</para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 echo posix_getuid().'\n'; //10001
 echo posix_geteuid().'\n'; //10001
diff --git a/reference/posix/functions/posix-getgid.xml b/reference/posix/functions/posix-getgid.xml
index ca9647f9b8..c7271237b9 100644
--- a/reference/posix/functions/posix-getgid.xml
+++ b/reference/posix/functions/posix-getgid.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.posix-getgid">
  <refnamediv>
   <refname>posix_getgid</refname>
@@ -17,6 +17,13 @@
   </para>
  </refsect1>
 
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns the real group id, as an <type>integer</type>.
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -28,7 +35,6 @@
     </para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 echo 'My real group id is '.posix_getgid(); //20
 posix_setegid(40);
@@ -57,12 +63,6 @@ echo 'My effective group id is '.posix_getegid(); //40
   </para>
  </refsect1>
 
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-   Returns the real group id, as an <type>integer</type>.
-  </para>
- </refsect1>
 </refentry>
 
 <!-- Keep this comment at the end of the file
diff --git a/reference/posix/functions/posix-getpgid.xml b/reference/posix/functions/posix-getpgid.xml
index bf579cff6a..1d554a5076 100644
--- a/reference/posix/functions/posix-getpgid.xml
+++ b/reference/posix/functions/posix-getpgid.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.posix-getpgid">
  <refnamediv>
   <refname>posix_getpgid</refname>
@@ -41,16 +41,6 @@
   </para>
  </refsect1>
 
- <refsect1 role="notes">
-  &reftitle.notes;
-  <para>
-   This is a not POSIX function, but is common on BSD and System V
-   systems. If your system does not support this function, then it
-   will not be included at compile time.  You may check if this
-   function exists with <function>function_exists</function>.
-  </para>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -67,6 +57,18 @@ echo posix_getpgid(); //35
   </para>
  </refsect1>
 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    This is a not POSIX function, but is common on BSD and System V
+    systems. If your system does not support this function, then it
+    will not be included at compile time.  You may check if this
+    function exists with <function>function_exists</function>.
+   </para>
+  </note>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/posix/functions/posix-getrlimit.xml b/reference/posix/functions/posix-getrlimit.xml
index bbb8814918..cb40ecb2be 100644
--- a/reference/posix/functions/posix-getrlimit.xml
+++ b/reference/posix/functions/posix-getrlimit.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <refentry id="function.posix-getrlimit">
  <refnamediv>
   <refname>posix_getrlimit</refname>
@@ -115,16 +115,6 @@
   </para>
  </refsect1>
 
- <refsect1 role="notes">
-  &reftitle.notes;
-  <para>
-   This is a not POSIX function, but is common on BSD and System V
-   systems. If your system does not support this function, then it
-   will not be included at compile time.  You may check if this
-   function exists with <function>function_exists</function>.
-  </para>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -172,6 +162,18 @@ Array
   </para>
  </refsect1>
 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    This is a not POSIX function, but is common on BSD and System V
+    systems. If your system does not support this function, then it
+    will not be included at compile time.  You may check if this
+    function exists with <function>function_exists</function>.
+   </para>
+  </note>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/posix/functions/posix-setegid.xml b/reference/posix/functions/posix-setegid.xml
index 5bdf8d4ebf..543dc143a1 100644
--- a/reference/posix/functions/posix-setegid.xml
+++ b/reference/posix/functions/posix-setegid.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.posix-setegid">
  <refnamediv>
   <refname>posix_setegid</refname>
@@ -53,7 +53,6 @@
     </para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 echo 'My real group id is '.posix_getgid(); //20
 posix_setegid(40);
diff --git a/reference/posix/functions/posix-setgid.xml b/reference/posix/functions/posix-setgid.xml
index 1704175f7f..c1cbc15528 100644
--- a/reference/posix/functions/posix-setgid.xml
+++ b/reference/posix/functions/posix-setgid.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.posix-setgid">
  <refnamediv>
   <refname>posix_setgid</refname>
@@ -62,7 +62,6 @@
     </para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 echo 'My real group id is '.posix_getgid(); //20
 posix_setgid(40);
diff --git a/reference/posix/functions/posix-setuid.xml b/reference/posix/functions/posix-setuid.xml
index 2690bd2b94..cc8291a28a 100644
--- a/reference/posix/functions/posix-setuid.xml
+++ b/reference/posix/functions/posix-setuid.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.posix-setuid">
  <refnamediv>
   <refname>posix_setuid</refname>
@@ -51,7 +51,6 @@
      it to a different value.</para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 echo posix_getuid().'\n'; //10001
 echo posix_geteuid().'\n'; //10001
diff --git a/reference/posix/functions/posix-strerror.xml b/reference/posix/functions/posix-strerror.xml
index 7125127802..32285ab27f 100644
--- a/reference/posix/functions/posix-strerror.xml
+++ b/reference/posix/functions/posix-strerror.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.posix-strerror">
  <refnamediv>
   <refname>posix_strerror</refname>
@@ -54,7 +54,6 @@
     exist, then will print out the corresponding error message.</para>
     <programlisting role="php">
 <![CDATA[
-#!/usr/local/bin/php
 <?php
 posix_kill(50,SIGKILL);
 echo posix_strerror(posix_get_last_error())."\n";