[PHP-DOC] cvs: phpdoc /nl/functions apache.xml filesystem.xml image.xml sybase.xml From: Derick Rethans (d.rethans <email protected>)
Date: 10/19/00

derick Thu Oct 19 15:01:23 2000 EDT

  Modified files:
    /phpdoc/nl/functions apache.xml filesystem.xml image.xml sybase.xml
  Log:
  - Updated from the English tree
  
  
Index: phpdoc/nl/functions/apache.xml
diff -u phpdoc/nl/functions/apache.xml:1.1 phpdoc/nl/functions/apache.xml:1.2
--- phpdoc/nl/functions/apache.xml:1.1 Tue Oct 10 15:07:53 2000
+++ phpdoc/nl/functions/apache.xml Thu Oct 19 15:01:23 2000
@@ -167,6 +167,58 @@
    </refsect1>
   </refentry>
 
+ <refentry id="function.ascii2ebcdic">
+ <refnamediv>
+ <refname>ascii2ebcdic</refname>
+ <refpurpose>Translate string from ASCII to EBCDIC</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ascii2ebcdic</function></funcdef>
+ <paramdef>string <parameter>ascii_str</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>ASCII2EBCDIC</function> is an Apache-specific function which
+ is available only on EBCDIC based operating systems (OS/390, BS2000).
+ It translates the ASCII encoded string <parameter>ascii_str</parameter>
+ to its equivalent EBCDIC representation (binary safe), and returns
+ the result.
+ </para>
+ <para>
+ See also the reverse function <function>EBCDIC2ASCII</function>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ebcdic2ascii">
+ <refnamediv>
+ <refname>ebcdic2ascii</refname>
+ <refpurpose>Translate string from EBCDIC to ASCII</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ebcdic2ascii</function></funcdef>
+ <paramdef>string <parameter>ebcdic_str</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>EBCDIC2ASCII</function> is an Apache-specific function which
+ is available only on EBCDIC based operating systems (OS/390, BS2000).
+ It translates the EBCDIC encoded string <parameter>ebcdic_str</parameter>
+ to its equivalent ASCII representation (binary safe), and returns
+ the result.
+ </para>
+ <para>
+ See also the reverse function <function>ASCII2EBCDIC</function>
+ </para>
+ </refsect1>
+ </refentry>
+
  </reference>
 
 <!-- Keep this comment at the end of the file
Index: phpdoc/nl/functions/filesystem.xml
diff -u phpdoc/nl/functions/filesystem.xml:1.1 phpdoc/nl/functions/filesystem.xml:1.2
--- phpdoc/nl/functions/filesystem.xml:1.1 Tue Oct 10 15:07:53 2000
+++ phpdoc/nl/functions/filesystem.xml Thu Oct 19 15:01:23 2000
@@ -998,6 +998,15 @@
      <function>Flock</function> returns true on success and false on
      error (e.g. when a lock could not be acquired).
     </simpara>
+ <warning>
+ <para>
+ On most operation systems <function>flock</function> is implemented
+ at the process level. When using a multithreaded server API like
+ ISAPI you cannot rely on <function>flock</function> to protect
+ files against other PHP scripts running in parallel threads of the
+ same server instance!
+ </para>
+ </warning>
    </refsect1>
   </refentry>
 
Index: phpdoc/nl/functions/image.xml
diff -u phpdoc/nl/functions/image.xml:1.1 phpdoc/nl/functions/image.xml:1.2
--- phpdoc/nl/functions/image.xml:1.1 Tue Oct 10 15:07:53 2000
+++ phpdoc/nl/functions/image.xml Thu Oct 19 15:01:23 2000
@@ -1058,8 +1058,56 @@
        <acronym>GD</acronym> library in version 1.6, this function is
        not available if you are using that version of the GD library.
       </para>
+ <para>
+ The following code snippet allows you to write more
+ portable PHP applications by auto-detecting the
+ type of GD support which is available. Replace
+ the sequence <literal>Header("Content-type: image/gif");
+ ImageGif($im);</literal> by the more flexible sequence:
+ <informalexample>
+ <programlisting role="php">
+&lt;?php
+ if (function_exists("imagegif")) {
+ Header("Content-type: image/gif");
+ ImageGif($im);
+ }
+ elseif (function_exists("imagejpeg")) {
+ Header("Content-type: image/jpeg");
+ ImageJpeg($im, "", 0.5);
+ }
+ elseif (function_exists("imagepng")) {
+ Header("Content-type: image/png");
+ ImagePng($im);
+ }
+ else
+ die("No image support in this PHP server");
+?&gt;
+ </programlisting>
+ </informalexample>
+ </para>
+ </note>
+ <note>
+ <para>
+ In PHP4 as of version 4.0.2 you can use the function
+ <function>imagetypes</function> in place of
+ <function>function_exists</function> for checking
+ the presence of the various supported image formats:
+ <informalexample>
+ <programlisting role="php">
+if (ImageTypes() &amp; IMG_GIF) {
+ Header("Content-type: image/gif");
+ ImageGif($im);
+}
+elseif (ImageTypes() &amp; IMG_JPG) {
+... etc.</programlisting>
+ </informalexample>
+ </para>
      </note>
     </para>
+ <para>
+ See also <function>ImagePng</function>,
+ <function>ImageJpeg</function>, <function>ImageTypes</function>.
+ </para>
    </refsect1>
   </refentry>
 
@@ -1095,6 +1143,10 @@
       </programlisting>
      </informalexample>
     </para>
+ <para>
+ See also <function>ImageGif</function>,
+ <function>ImageJpeg</function>, <function>ImageTypes</function>.
+ </para>
    </refsect1>
   </refentry>
 
@@ -1136,6 +1188,10 @@
        against GD-1.8 or later.
       </para>
      </note>
+ </para>
+ <para>
+ See also <function>ImagePng</function>,
+ <function>ImageGif</function>, <function>ImageTypes</function>.
     </para>
    </refsect1>
   </refentry>
Index: phpdoc/nl/functions/sybase.xml
diff -u phpdoc/nl/functions/sybase.xml:1.3 phpdoc/nl/functions/sybase.xml:1.4
--- phpdoc/nl/functions/sybase.xml:1.3 Wed Oct 18 15:19:20 2000
+++ phpdoc/nl/functions/sybase.xml Thu Oct 19 15:01:23 2000
@@ -179,8 +179,9 @@
      <funcprototype>
       <funcdef>object <function>sybase_fetch_field</function></funcdef>
       <paramdef>int <parameter>result</parameter></paramdef>
- <paramdef>int <parameter>
- <optional>field_offset</optional></parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>field_offset</optional></parameter>
+ </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>