[PHP-DOC] cvs: phpdoc /en/reference/phar ini.xml

[Greg Beaver]

cellog          Thu Aug 30 03:28:24 2007 UTC

  Modified files:              
    /phpdoc/en/reference/phar   ini.xml 
  Log:
  fix incorrect documentation on phar.extract_list
  
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/ini.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/phar/ini.xml
diff -u phpdoc/en/reference/phar/ini.xml:1.4 
phpdoc/en/reference/phar/ini.xml:1.5
--- phpdoc/en/reference/phar/ini.xml:1.4        Thu Aug  2 15:07:22 2007
+++ phpdoc/en/reference/phar/ini.xml    Thu Aug 30 03:28:24 2007
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <section xml:id="phar.configuration" xmlns="http://docbook.org/ns/docbook";>
  &reftitle.runtime;
  &extension.runtime;
@@ -101,14 +101,18 @@
     </term>
     <listitem>
      <para>
-      Allows mappings from fixed name to 
<literal>path/to/archive.phar</literal>.
-      The format of the parameter is 
<literal>name=archive:name2=archive2</literal>.
+      Allows mappings from a full path to a phar archive or its alias to
+      the location of its extracted files.
+      The format of the parameter is 
<literal>name=archive,name2=archive2</literal>.
+      This allows extraction of phar files to disk, and allows phar to act as a
+      kind of mapper to extracted disk files.  This is often done for 
performance
+      reasons, or to assist with debugging a phar.
       <example>
        <title>phar.extract_list usage example</title>
        <programlisting role="php">
 <![CDATA[
 in php.ini:
-phar.extract_list = archive=path/to/archive1.phar:arch2=path/to/archive2.phar
+phar.extract_list = archive=/full/path/to/archive/,arch2=/full/path/to/arch2
 <?php
 include "phar://archive/content.php";
 include "phar://arch2/foo.php";