From 88c0308f1a245d48e4f8f7d9835e3066be3e50e9 Mon Sep 17 00:00:00 2001
From: Friedhelm Betz <betz@php.net>
Date: Thu, 8 Sep 2005 16:03:16 +0000
Subject: [PATCH] move session_pgsql from peardoc to phpdoc

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@195481 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/session_pgsql/configure.xml         | 60 ++++++++++++++
 .../functions/session-pgsql-status.xml        | 41 ++++++++++
 reference/session_pgsql/ini.xml               | 32 ++++++++
 reference/session_pgsql/reference.xml         | 81 +++++++++++++++++++
 4 files changed, 214 insertions(+)
 create mode 100644 reference/session_pgsql/configure.xml
 create mode 100644 reference/session_pgsql/functions/session-pgsql-status.xml
 create mode 100644 reference/session_pgsql/ini.xml
 create mode 100644 reference/session_pgsql/reference.xml

diff --git a/reference/session_pgsql/configure.xml b/reference/session_pgsql/configure.xml
new file mode 100644
index 0000000000..619ea7a7e9
--- /dev/null
+++ b/reference/session_pgsql/configure.xml
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.1 $ -->
+<section id="session-pgsql.installation">
+ &reftitle.install;
+ <para>
+  Short installation note:
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     Untar the <literal>tar.gz</literal> archive into
+     <filename class="directory">php4/ext</filename> (Latest official releases
+     can be found at SourceForge
+     <ulink url="&url.phpform;">PHP Form Extension Project</ulink>)
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     If the new directory is now called something like
+     <literal>session_pgsql</literal>. You should name it to
+     <literal>session_pgsql</literal> (except you only want to build it as
+     self-contained php-module).
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>Run <userinput>./buildconf</userinput> in php4</simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     Run <userinput>configure</userinput>
+     <option role="configure">--with-session-pgsql</option> (and your other
+     options)
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara><userinput>make; make install</userinput></simpara>
+   </listitem>
+  </itemizedlist>
+ </para>
+</section>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/session_pgsql/functions/session-pgsql-status.xml b/reference/session_pgsql/functions/session-pgsql-status.xml
new file mode 100644
index 0000000000..10840ba6c8
--- /dev/null
+++ b/reference/session_pgsql/functions/session-pgsql-status.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.1 $ -->
+<!-- splitted from ./en/functions/session-pgsql.xml, last change in rev 1.2 -->
+<refentry id="function.session-pgsql-status">
+ <refnamediv>
+  <refname>session_pgsql_status</refname>
+  <refpurpose>Get current save handler status</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>array</type><methodname>session_pgsql_status</methodname>
+   <methodparam><parameter>void</parameter></methodparam>
+  </methodsynopsis>
+  &warn.experimental.func;
+  &warn.undocumented.func;
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
diff --git a/reference/session_pgsql/ini.xml b/reference/session_pgsql/ini.xml
new file mode 100644
index 0000000000..49ad19fb50
--- /dev/null
+++ b/reference/session_pgsql/ini.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.1 $ -->
+<section id="session-pgsql.configuration">
+ &reftitle.runtime;
+ &extension.runtime;
+ <para>
+  PostgreSQL session save handler is still under development. Refer to the
+  <filename>README</filename> file in the source distribution for
+  configuration details.
+ </para>
+</section>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/session_pgsql/reference.xml b/reference/session_pgsql/reference.xml
new file mode 100644
index 0000000000..4defb39380
--- /dev/null
+++ b/reference/session_pgsql/reference.xml
@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.1 $ -->
+<!-- Purpose: basic.session -->
+<!-- Membership: pecl, external -->
+<!-- State: experimental-->
+<!-- Author: Yasuo Ohgaki <yohgaki@php.net> -->
+<reference id="ref.session-pgsql">
+ <title>PostgreSQL Session Save Handler</title>
+ <titleabbrev>Session PgSQL</titleabbrev>
+
+  <partintro>
+   <section id="session-pgsql.intro">
+    &reftitle.intro;
+    &warn.experimental;
+    &note.no-windows.extension;
+    <para>
+     This module provide additional session save handler for session module
+     using PostgreSQL as a storage. <literal>user</literal> session save
+     handler may be used, but this module is written in C. Therefore, this
+     module is roughly 2 times faster than save handler written in PHP script.
+    </para>
+    <para>
+     Fail-over and load balance is planned to be implemented, but they are not
+     available now.
+    </para>
+    <note>
+     <simpara>
+      There will be functions for this module, but it is not available now.
+     </simpara>
+    </note>
+   </section>
+
+   <section id="session-pgsql.requirements">
+    &reftitle.required;
+    <para>
+     You need at least PHP 4.1, PostgreSQL 7.1 and MM 1.1.3
+    </para>
+   </section>
+
+   &reference.session-pgsql.configure;
+
+   &reference.session-pgsql.ini;
+
+
+   <section id="session-pgsql.contact">
+    <title>Contact Information</title>
+    <para>
+     I have at the moment not very much time to further develop this
+     extension. I will implement more and more features in the near future.
+    </para>
+    <para>
+     If you have comments, bug fixes, enhancements or want to help developing
+     this, you can drop me a mail at
+     <ulink url="mailto:yohgaki@php.net">yohgaki@php.net</ulink>. Any help is
+     very welcome.
+    </para>
+   </section>
+  </partintro>
+
+&reference.session-pgsql.functions;
+
+ </reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->