From f11d245be370db9eb915833c5ba18c5e4c79d9d7 Mon Sep 17 00:00:00 2001
From: Mehdi Achour <didou@php.net>
Date: Thu, 22 Jul 2004 22:23:36 +0000
Subject: [PATCH] document xslt_getopt() and xslt_setopt()

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@164044 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/xslt/functions/xslt-getopt.xml | 13 +++--
 reference/xslt/functions/xslt-setopt.xml | 61 ++++++++++++++++++++++--
 2 files changed, 67 insertions(+), 7 deletions(-)

diff --git a/reference/xslt/functions/xslt-getopt.xml b/reference/xslt/functions/xslt-getopt.xml
index 57935885ec..2d3e6353f6 100755
--- a/reference/xslt/functions/xslt-getopt.xml
+++ b/reference/xslt/functions/xslt-getopt.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id="function.xslt-getopt">
    <refnamediv>
     <refname>xslt_getopt</refname>
@@ -13,9 +13,14 @@
      <type>int</type><methodname>xslt_getopt</methodname>
      <methodparam><type>resource</type><parameter>processor</parameter></methodparam>
     </methodsynopsis>
-
-     &warn.undocumented.func;
-
+    <para>
+     <function>xslt_getopt</function> returns the options on the given 
+     <parameter>processor</parameter>.
+    </para>
+    <para>
+     See also:
+     <function>xslt_setopt</function>.
+    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/xslt/functions/xslt-setopt.xml b/reference/xslt/functions/xslt-setopt.xml
index 9a5d679da3..b9504f8648 100755
--- a/reference/xslt/functions/xslt-setopt.xml
+++ b/reference/xslt/functions/xslt-setopt.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id="function.xslt-setopt">
    <refnamediv>
     <refname>xslt_setopt</refname>
@@ -14,9 +14,64 @@
      <methodparam><type>resource</type><parameter>processor</parameter></methodparam>
      <methodparam><type>int</type><parameter>newmask</parameter></methodparam>
     </methodsynopsis>
+    <para>
+     <function>xslt_setopt</function> sets the options specified by 
+     <parameter>newmask</parameter> on the given <parameter>processor</parameter>.
+    </para>
+    <para>
+     <parameter>newmask</parameter> is a bitmask constructed with the following
+     constants: 
+     <itemizedlist>
+      <listitem>
+       <para>
+        <constant>XSLT_SABOPT_PARSE_PUBLIC_ENTITIES</constant> - Tell the processor
+        to parse public entities. By default this has been turned off.
+       </para>
+      </listitem>
+      <listitem>
+       <para>
+        <constant>XSLT_SABOPT_DISABLE_ADDING_META</constant> - Do not add the meta
+        tag "Content-Type" for HTML output. The default is set during the compilation
+        of the processor.
+       </para>
+      </listitem>
+      <listitem>
+       <para>
+        <constant>XSLT_SABOPT_DISABLE_STRIPPING</constant> - Suppress the whitespace
+        stripping (on data files only). 
+       </para>
+      </listitem>
+      <listitem>
+       <para>
+        <constant>XSLT_SABOPT_IGNORE_DOC_NOT_FOUND</constant> - Consider unresolved
+        documents (the document() function) non-lethal. 
+       </para>
+      </listitem>
+     </itemizedlist>
+    </para>
+    <para>
+     <example>
+      <programlisting role="php">
+<![CDATA[
+<?php
 
-     &warn.undocumented.func;
+$xh = xslt_create();
 
+// Tell Sablotron to process public entities
+xslt_setopt($xh, XSLT_SABOPT_PARSE_PUBLIC_ENTITIES);
+
+// Let's also ask him to suppress whitespace stripping
+xslt_setopt($xh, xslt_getopt($xh) | XSLT_SABOPT_PARSE_PUBLIC_ENTITIES);
+
+?>
+]]>
+      </programlisting>     
+     </example>
+    </para>
+    <para>
+     See also:
+     <function>xslt_getopt</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -39,4 +94,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->
\ No newline at end of file