From a44bbd952f3068ceac6fb1148fcf4b22bef6fec2 Mon Sep 17 00:00:00 2001
From: Sara Golemon <pollita@php.net>
Date: Tue, 7 Jan 2003 01:57:08 +0000
Subject: [PATCH] Document optional parameters

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@110842 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/stream/functions/stream-filter-append.xml  |  6 ++++--
 reference/stream/functions/stream-filter-prepend.xml |  6 ++++--
 reference/stream/functions/stream-get-filters.xml    | 10 ++++++----
 3 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/reference/stream/functions/stream-filter-append.xml b/reference/stream/functions/stream-filter-append.xml
index 03eee77bd2..041ce54416 100644
--- a/reference/stream/functions/stream-filter-append.xml
+++ b/reference/stream/functions/stream-filter-append.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id="function.stream-filter-append">
    <refnamediv>
     <refname>stream_filter_append</refname>
@@ -11,11 +11,13 @@
       <type>bool</type><methodname>stream_filter_append</methodname>
       <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
       <methodparam><type>string</type><parameter>filtername</parameter></methodparam>
+      <methodparam choice="opt"><type>string</type><parameter>params</parameter></methodparam>
      </methodsynopsis>
     <para>
      Adds <parameter>filtername</parameter> to the list of filters 
      attached to <parameter>stream</parameter>.  This filter will be
-     added to the <emphasis>end</emphasis> of the list and
+     added with the specified <parameter>params</parameter>
+     to the <emphasis>end</emphasis> of the list and
      will therefore be called last during stream opperations.  To
      add a filter to the beginning of the list, use 
      <function>stream_filter_prepend</function>.
diff --git a/reference/stream/functions/stream-filter-prepend.xml b/reference/stream/functions/stream-filter-prepend.xml
index 0b10ae10ed..3f9e393e36 100644
--- a/reference/stream/functions/stream-filter-prepend.xml
+++ b/reference/stream/functions/stream-filter-prepend.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id="function.stream-filter-prepend">
    <refnamediv>
     <refname>stream_filter_prepend</refname>
@@ -11,11 +11,13 @@
       <type>bool</type><methodname>stream_filter_prepend</methodname>
       <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
       <methodparam><type>string</type><parameter>filtername</parameter></methodparam>
+      <methodparam choice="opt"><type>string</type><parameter>params</parameter></methodparam>
      </methodsynopsis>
     <para>
      Adds <parameter>filtername</parameter> to the list of filters 
      attached to <parameter>stream</parameter>.  This filter will be
-     added to the <emphasis>beginning</emphasis> of the list and
+     added with the specified <parameter>params</parameter>
+     to the <emphasis>beginning</emphasis> of the list and
      will therefore be called first during stream opperations.  To
      add a filter to the end of the list, use 
      <function>stream_filter_append</function>.
diff --git a/reference/stream/functions/stream-get-filters.xml b/reference/stream/functions/stream-get-filters.xml
index f3d8589f1e..5848c5b3f3 100644
--- a/reference/stream/functions/stream-get-filters.xml
+++ b/reference/stream/functions/stream-get-filters.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id="function.stream-get-filters">
    <refnamediv>
     <refname>stream_get_filters</refname>
@@ -9,11 +9,13 @@
     <title>Description</title>
      <methodsynopsis>
       <type>array</type><methodname>stream_get_filters</methodname>
-      <void/>
+      <methodparam choice="opt"><type>bool</type><parameter>system</parameter></methodparam>
      </methodsynopsis>
     <para>
-     Returns an indexed array containing the name of all stream filters
-     available on the running system.
+     Returns an indexed array containing the name of all user-defined stream filters
+     available on the running system.  If the <parameter>system</parameter> 
+     parameter is set to true, then system defined filters will be included in the returned
+     array as well.
     </para>
     <para>
      See Also: