philip Wed Feb 28 05:36:08 2007 UTC
Modified files:
/phpdoc/en/reference/fdf configure.xml
/phpdoc/en/reference/ibase configure.xml
/phpdoc/en/reference/ldap configure.xml
/phpdoc/en/reference/msql configure.xml
/phpdoc/en/reference/openssl configure.xml
/phpdoc/en/reference/pspell configure.xml
/phpdoc/en/reference/xslt configure.xml
/phpdoc/en language-snippets.ent
Log:
Removed information about copying files into the Windows system directory and
instead discussed our preferred method: Putting the PHP directory in PATH.
# At some point have other extensions use the new &ext.windows.path.dll; too
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/fdf/configure.xml?r1=1.5&r2=1.6&diff_format=u
Index: phpdoc/en/reference/fdf/configure.xml
diff -u phpdoc/en/reference/fdf/configure.xml:1.5
phpdoc/en/reference/fdf/configure.xml:1.6
--- phpdoc/en/reference/fdf/configure.xml:1.5 Thu Feb 15 09:24:35 2007
+++ phpdoc/en/reference/fdf/configure.xml Wed Feb 28 05:36:07 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<section id="fdf.installation">
&reftitle.install;
<simpara>
@@ -23,12 +23,10 @@
</note>
<note>
<title>Note to Win32 Users</title>
- <simpara>
- In order to enable this module on a Windows environment, you must copy
- <filename>fdftk.dll</filename> from the DLL folder of the PHP/Win32 binary
- package to the SYSTEM32 folder of your Windows machine. (Ex: <filename
class="directory">C:\WINNT\SYSTEM32</filename>
- or <filename class="directory">C:\WINDOWS\SYSTEM32</filename>)
- </simpara>
+ <para>
+ &ext.windows.path.dll;
+ <filename>fdftk.dll</filename>
+ </para>
</note>
</section>
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/ibase/configure.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/ibase/configure.xml
diff -u phpdoc/en/reference/ibase/configure.xml:1.4
phpdoc/en/reference/ibase/configure.xml:1.5
--- phpdoc/en/reference/ibase/configure.xml:1.4 Thu Feb 15 09:24:36 2007
+++ phpdoc/en/reference/ibase/configure.xml Wed Feb 28 05:36:07 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<section id="ibase.installation">
&reftitle.install;
<para>
@@ -10,14 +10,16 @@
</para>
<note>
<title>Note to Win32 Users</title>
- <simpara>
- In order to enable this module on a Windows environment, you must copy
- <filename>gds32.dll</filename> from the DLL folder of the PHP/Win32 binary
- package to the SYSTEM32 folder of your Windows machine. (Ex: <filename
class="directory">C:\WINNT\SYSTEM32</filename>
- or <filename class="directory">C:\WINDOWS\SYSTEM32</filename>). In case you
installed the InterBase database server on the
+ <para>
+ &ext.windows.path.dll;
+ <filename>gds32.dll</filename>
+ </para>
+ <para>
+ In case you installed the InterBase database server on the
same machine PHP is running on, you will have this DLL already. Therefore
you don't
- need to copy <filename>gds32.dll</filename> from the DLL folder.
- </simpara>
+ need to worry because <filename>gds32.dll</filename> will already be in
+ the <literal>PATH</literal>.
+ </para>
</note>
</section>
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/ldap/configure.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc/en/reference/ldap/configure.xml
diff -u phpdoc/en/reference/ldap/configure.xml:1.9
phpdoc/en/reference/ldap/configure.xml:1.10
--- phpdoc/en/reference/ldap/configure.xml:1.9 Thu Feb 15 09:24:36 2007
+++ phpdoc/en/reference/ldap/configure.xml Wed Feb 28 05:36:07 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
<section id="ldap.installation">
&reftitle.install;
<para>
@@ -12,14 +12,13 @@
</para>
<note>
<title>Note to Win32 Users</title>
+ <para>
+ &ext.windows.path.dll;
+ <filename>libeay32.dll</filename> and
+ <filename>ssleay32.dll</filename>
+ </para>
<simpara>
- In order to enable this module on a Windows environment, you must copy
- several files from the DLL folder of the PHP/Win32 binary package to the
- SYSTEM folder of your Windows machine. (Ex: <filename
class="directory">C:\WINNT\SYSTEM32</filename>,
- or <filename class="directory">C:\WINDOWS\SYSTEM</filename>). For PHP <=
4.2.0 copy
- <filename>libsasl.dll</filename>, for PHP >= 4.3.0 copy
- <filename>libeay32.dll</filename> and <filename>ssleay32.dll</filename> to
- your SYSTEM folder.
+ Versions before PHP 4.3.0 additionally require
<filename>libsasl.dll</filename>.
</simpara>
</note>
<para>
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/msql/configure.xml?r1=1.7&r2=1.8&diff_format=u
Index: phpdoc/en/reference/msql/configure.xml
diff -u phpdoc/en/reference/msql/configure.xml:1.7
phpdoc/en/reference/msql/configure.xml:1.8
--- phpdoc/en/reference/msql/configure.xml:1.7 Thu Feb 15 09:24:36 2007
+++ phpdoc/en/reference/msql/configure.xml Wed Feb 28 05:36:07 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
<section id="msql.installation">
&reftitle.install;
<para>
@@ -10,13 +10,10 @@
</para>
<note>
<title>Note to Win32 Users</title>
- <simpara>
- In order to enable this module on a Windows environment, you must copy
- <filename>msql.dll</filename> from the DLL folder of the PHP/Win32
- binary package to the SYSTEM32 folder of your Windows machine.
- (Ex: <filename class="directory">C:\WINNT\SYSTEM32</filename> or
- <filename class="directory">C:\WINDOWS\SYSTEM32</filename>)
- </simpara>
+ <para>
+ &ext.windows.path.dll;
+ <filename>msql.dll</filename>
+ </para>
</note>
</section>
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/openssl/configure.xml?r1=1.6&r2=1.7&diff_format=u
Index: phpdoc/en/reference/openssl/configure.xml
diff -u phpdoc/en/reference/openssl/configure.xml:1.6
phpdoc/en/reference/openssl/configure.xml:1.7
--- phpdoc/en/reference/openssl/configure.xml:1.6 Thu Feb 15 09:24:36 2007
+++ phpdoc/en/reference/openssl/configure.xml Wed Feb 28 05:36:07 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
<section id="openssl.installation">
&reftitle.install;
<para>
@@ -8,13 +8,10 @@
</para>
<note>
<title>Note to Win32 Users</title>
- <simpara>
- In order to enable this module on a Windows environment, you must copy
- <filename>libeay32.dll</filename> from the DLL folder of the PHP/Win32
binary
- package to the SYSTEM32 folder of your Windows machine. (Ex:
- <filename class="directory">C:\WINNT\SYSTEM32</filename>
- or <filename class="directory">C:\WINDOWS\SYSTEM32</filename>)
- </simpara>
+ <para>
+ &ext.windows.path.dll;
+ <filename>libeay32.dll</filename>
+ </para>
<simpara>
Additionally, if you are planning to use the key generation and certificate
signing functions, you will need to install a valid <filename>openssl.cnf
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/pspell/configure.xml?r1=1.6&r2=1.7&diff_format=u
Index: phpdoc/en/reference/pspell/configure.xml
diff -u phpdoc/en/reference/pspell/configure.xml:1.6
phpdoc/en/reference/pspell/configure.xml:1.7
--- phpdoc/en/reference/pspell/configure.xml:1.6 Thu Feb 15 09:24:36 2007
+++ phpdoc/en/reference/pspell/configure.xml Wed Feb 28 05:36:07 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
<section id="pspell.installation">
&reftitle.install;
<para>
@@ -9,17 +9,15 @@
</para>
<note>
<title>Note to Win32 Users</title>
- <simpara>
- win32 support is available only in PHP 4.3.3 and later versions.
- Also, you must have aspell 0.50 or newer installed.
- In order to enable this module under Windows, you must copy
- <filename>aspell-15.dll</filename> from the <filename>bin</filename> folder
- of your aspell installation to a folder where PHP will be able to find it.
- <filename class="directory">C:\PHP</filename> or the SYSTEM32 folder of
- your Windows machine (Ex: <filename
- class="directory">C:\WINNT\SYSTEM32</filename> or <filename
- class="directory">C:\WINDOWS\SYSTEM32</filename>) are good choices.
- </simpara>
+ <para>
+ &ext.windows.path.dll;
+ <filename>aspell-15.dll</filename> from the
+ <filename>bin</filename> folder of the aspell installation.
+ </para>
+ <para>
+ Win32 support is available only in PHP 4.3.3 and later versions. Also, at
+ least aspell version 0.50 is required.
+ </para>
</note>
</section>
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/xslt/configure.xml?r1=1.7&r2=1.8&diff_format=u
Index: phpdoc/en/reference/xslt/configure.xml
diff -u phpdoc/en/reference/xslt/configure.xml:1.7
phpdoc/en/reference/xslt/configure.xml:1.8
--- phpdoc/en/reference/xslt/configure.xml:1.7 Thu Feb 15 09:24:37 2007
+++ phpdoc/en/reference/xslt/configure.xml Wed Feb 28 05:36:07 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
<section id="xslt.installation">
&reftitle.install;
<para>
@@ -36,16 +36,16 @@
</note>
<note>
<title>Note to Win32 Users</title>
- <simpara>
- In order to enable this module on a Windows environment, you must copy
- several files from the DLL folder of the PHP/Win32 binary package to the
- SYSTEM32 folder of your Windows machine. (Ex: <filename
class="directory">C:\WINNT\SYSTEM32</filename> or
- <filename class="directory">C:\WINDOWS\SYSTEM32</filename>). For PHP <=
4.2.0 copy <filename>sablot.dll</filename>
- and <filename>expat.dll</filename> to your SYSTEM32 folder. For
- PHP >= 4.2.1 copy <filename>sablot.dll</filename>,
- <filename>expat.dll</filename> and <filename>iconv.dll</filename> to your
- SYSTEM32 folder.
- </simpara>
+ <para>
+ &ext.windows.path.dll;
+ <filename>sablot.dll</filename>,
+ <filename>expat.dll</filename>, and
+ <filename>iconv.dll</filename>
+ </para>
+ <para>
+ For PHP <= 4.2.0, the file <filename>iconv.dll</filename> is
+ not required.
+ </para>
</note>
</section>
http://cvs.php.net/viewvc.cgi/phpdoc/en/language-snippets.ent?r1=1.190&r2=1.191&diff_format=u
Index: phpdoc/en/language-snippets.ent
diff -u phpdoc/en/language-snippets.ent:1.190
phpdoc/en/language-snippets.ent:1.191
--- phpdoc/en/language-snippets.ent:1.190 Wed Feb 7 06:51:54 2007
+++ phpdoc/en/language-snippets.ent Wed Feb 28 05:36:07 2007
@@ -1,4 +1,4 @@
-<!-- $Revision: 1.190 $ -->
+<!-- $Revision: 1.191 $ -->
<!-- Keep 'em sorted -->
@@ -191,6 +191,17 @@
recommended to not use this function as one day it may be removed from
PHP.</simpara>'>
+<!ENTITY ext.windows.path.dll 'In order for this extension to work, there are
+<acronym>DLL</acronym> files that must be available to the Windows
+system <literal>PATH</literal>. See the <acronym>FAQ</acronym> titled "<link
+linkend="faq.installation.addtopath">How do I add my PHP directory to the PATH
+on Windows</link>" for information on how to do this. Although copying DLL
+files from the PHP folder into the Windows system directory also works
+(because the system directory is by default in the systems
+<literal>PATH</literal>), it is not recommended.
+<emphasis>This extension requires the following files to be in the
+<literal>PATH</literal>:</emphasis> '>
+
<!-- Returns -->
<!ENTITY return.success 'Returns &true; on success or &false; on failure.'>
