From 17fa318f1468d3c0bd1771696418d3a27ca1f1d4 Mon Sep 17 00:00:00 2001
From: Jeroen van Wolffelaar <jeroen@php.net>
Date: Sun, 24 Jun 2001 15:27:22 +0000
Subject: [PATCH] Added a warning about the experimental status of some
 modules.

Updated TODO


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@50102 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/ctype.xml     | 1 +
 functions/dbx.xml       | 1 +
 functions/domxml.xml    | 1 +
 functions/fbsql.xml     | 1 +
 functions/ingres_ii.xml | 1 +
 functions/mbstring.xml  | 3 ++-
 functions/ming.xml      | 1 +
 functions/openssl.xml   | 1 +
 functions/satellite.xml | 3 ++-
 functions/sockets.xml   | 3 ++-
 functions/xslt.xml      | 1 +
 language-snippets.ent   | 1 +
 12 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/functions/ctype.xml b/functions/ctype.xml
index 42dcb7285a..428d947bdb 100644
--- a/functions/ctype.xml
+++ b/functions/ctype.xml
@@ -3,6 +3,7 @@
   <titleabbrev>ctype</titleabbrev>
 
   <partintro>
+   &warn.experimental;
    <para>
     These functions check whether a character or string
     falls into a certain character class according to the
diff --git a/functions/dbx.xml b/functions/dbx.xml
index 94e3ae63e6..3e364943bd 100644
--- a/functions/dbx.xml
+++ b/functions/dbx.xml
@@ -2,6 +2,7 @@
   <title>dbx functions</title>
   <titleabbrev>dbx</titleabbrev>
   <partintro>
+   &warn.experimental;
    <simpara>
     The dbx module is a database abstraction layer (db 'X', where 'X'
     is a supported database). The dbx functions allow you to access
diff --git a/functions/domxml.xml b/functions/domxml.xml
index 4c97d2e208..f64b4fc9ee 100644
--- a/functions/domxml.xml
+++ b/functions/domxml.xml
@@ -3,6 +3,7 @@
   <titleabbrev>DOM XML</titleabbrev>
 
   <partintro>
+   &warn.experimental;
    <simpara>
     This documentation is not finished yet. Don't start to translate it
     or use it as a programming reference (steinm@php.net).
diff --git a/functions/fbsql.xml b/functions/fbsql.xml
index 40d87fd31a..6c5f76fdc7 100644
--- a/functions/fbsql.xml
+++ b/functions/fbsql.xml
@@ -2,6 +2,7 @@
   <title>FrontBase functions</title>
   <titleabbrev>FrontBase</titleabbrev>
   <partintro>
+   &warn.experimental;
    <simpara>
     These functions allow you to access FrontBase database servers. In
     order to have these functions available, you must compile php
diff --git a/functions/ingres_ii.xml b/functions/ingres_ii.xml
index aa4cd306c3..657ffa1030 100755
--- a/functions/ingres_ii.xml
+++ b/functions/ingres_ii.xml
@@ -2,6 +2,7 @@
   <title>Ingres II functions</title>
   <titleabbrev>Ingres II</titleabbrev>
   <partintro>
+   &warn.experimental;
    <simpara>
     These functions allow you to access Ingres II database servers.
    </simpara>
diff --git a/functions/mbstring.xml b/functions/mbstring.xml
index a231fc4234..4843317bf8 100644
--- a/functions/mbstring.xml
+++ b/functions/mbstring.xml
@@ -2,6 +2,7 @@
   <title>Multi-Byte String Functions</title> 
   <titleabbrev>Multi-Byte String</titleabbrev>
   <partintro>
+   &warn.experimental;
    <sect1 id="mb-intro">
     <title>Introduction</title>
     <warning>
@@ -1399,4 +1400,4 @@ $convmap = array (
  -->
  <!-- Keep this comment for vi/vim/gvim
  vi: et:ts=1:sw=1
- -->
\ No newline at end of file
+ -->
diff --git a/functions/ming.xml b/functions/ming.xml
index dc0f808a0c..e427d92ad3 100755
--- a/functions/ming.xml
+++ b/functions/ming.xml
@@ -3,6 +3,7 @@
   <titleabbrev>Ming (flash)</titleabbrev>
 
   <partintro>
+	   &warn.experimental;
    <sect1 id="ming.intro">
     <title>Introduction</title>
     <simpara>
diff --git a/functions/openssl.xml b/functions/openssl.xml
index 2970ae4831..857fbac8ea 100644
--- a/functions/openssl.xml
+++ b/functions/openssl.xml
@@ -2,6 +2,7 @@
   <title>OpenSSL functions</title>
   <titleabbrev>OpenSSL</titleabbrev>
   <partintro>
+	   &warn.experimental;
   <sect1 id="openssl.intro">
   <title>Introduction</title>
   <para>
diff --git a/functions/satellite.xml b/functions/satellite.xml
index 93af089079..37f33c35a1 100644
--- a/functions/satellite.xml
+++ b/functions/satellite.xml
@@ -1,6 +1,6 @@
 <!-- 
 
-	$Id: satellite.xml,v 1.4 2000-09-05 08:29:49 eriksson Exp $
+	$Id: satellite.xml,v 1.5 2001-06-24 15:27:21 jeroen Exp $
 
 	Author: David Eriksson <david@2good.com> 
 
@@ -11,6 +11,7 @@
   <titleabbrev>Satellite</titleabbrev>
 
   <partintro>
+	   &warn.experimental;
    <para>
     The Satellite extension is used for accessing CORBA objects.  You
     will need to set the idl_directory= entry in php.ini to a path
diff --git a/functions/sockets.xml b/functions/sockets.xml
index f6677836a4..31d3794133 100644
--- a/functions/sockets.xml
+++ b/functions/sockets.xml
@@ -3,6 +3,7 @@
   <titleabbrev>Sockets</titleabbrev>
 
   <partintro>
+	   &warn.experimental;
    <simpara>
     The socket extension implements a low-level interface to the
     socket communication functions, providing the possibility to act
@@ -622,4 +623,4 @@ sgml-local-catalogs:nil
 sgml-local-ecat-files:nil
 End:
 -->
- 
\ No newline at end of file
+ 
diff --git a/functions/xslt.xml b/functions/xslt.xml
index b4c1a783cc..4dda9362fd 100644
--- a/functions/xslt.xml
+++ b/functions/xslt.xml
@@ -4,6 +4,7 @@
   <titleabbrev>XSLT</titleabbrev>
 
   <partintro>
+	   &warn.experimental;
    <sect1 id="xslt.partintro">
     <title>Introduction</title>
 
diff --git a/language-snippets.ent b/language-snippets.ent
index a0d1fbbd39..097f6926eb 100644
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -1,3 +1,4 @@
+<!ENTITY warn.experimental '<warning><simpara>This module is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of these functions, these function names, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this module at your own risk.</simpara></warning>'>
 
 <!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result directly to the browser, you can use the <link linkend="ref.outcontrol">output-control functions</link> to capture the output of this function, and save it - for example - in a <type>string</type>.</simpara></tip>'>