[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions fopen.xml

[Noel Forbes]

nforbes         Mon Nov 29 18:15:35 2004 EDT

  Modified files:              
    /phpdoc/en/reference/filesystem/functions   fopen.xml 
  Log:
  Moved important emphasized text to separate notes; moved compatibility notice 
to above the table.
  
http://cvs.php.net/diff.php/phpdoc/en/reference/filesystem/functions/fopen.xml?r1=1.24&r2=1.25&ty=u
Index: phpdoc/en/reference/filesystem/functions/fopen.xml
diff -u phpdoc/en/reference/filesystem/functions/fopen.xml:1.24 
phpdoc/en/reference/filesystem/functions/fopen.xml:1.25
--- phpdoc/en/reference/filesystem/functions/fopen.xml:1.24     Fri Apr 23 
14:23:08 2004
+++ phpdoc/en/reference/filesystem/functions/fopen.xml  Mon Nov 29 18:15:35 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.24 $ -->
+<!-- $Revision: 1.25 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.fopen">
    <refnamediv>
@@ -56,6 +56,15 @@
      </simpara>
     </note>
     &note.context-support;
+    <note>
+     <simpara>
+      As of PHP 4.3.2, the default mode is set to binary for all
+      platforms that distinguish between binary and text mode.  If you are
+      having problems with your scripts after upgrading, try using the
+      <literal>'t'</literal> flag as a workaround until you have made your
+      script more portable as mentioned below.
+     </simpara>
+    </note>
     <para>
      The <parameter>mode</parameter> parameter specifies the type of access
      you require to the stream.  It may be any of the following:
@@ -185,25 +194,19 @@
       may experience strange problems with your data, including broken image
       files and strange problems with <literal>\r\n</literal> characters.
      </para>
+    </note>
+    <note>
      <para>
-      <emphasis>For portability, it is strongly recommended that you always
-       use the 'b' flag when opening files with <function>fopen</function>.
-      </emphasis>
-     </para>
-     <para>
-      <emphasis>Again, for portability, it is also strongly recommended that
-       you re-write code that uses or relies upon the <literal>'t'</literal>
-       mode so that it uses the correct line endings and
-       <literal>'b'</literal> mode instead.
-      </emphasis>
+      For portability, it is strongly recommended that you always
+      use the 'b' flag when opening files with <function>fopen</function>.
      </para>
+    </note>
+    <note>
      <para>
-      <emphasis>As of PHP 4.3.2, the default mode is set to binary for all
-       platforms that distinguish between binary and text mode.  If you are
-       having problems with your scripts after upgrading, try using the
-       <literal>'t'</literal> flag as a workaround until you have made your
-       script more portable as mentioned above.
-      </emphasis>
+      Again, for portability, it is also strongly recommended that
+      you re-write code that uses or relies upon the <literal>'t'</literal>
+      mode so that it uses the correct line endings and
+      <literal>'b'</literal> mode instead.
      </para>
     </note>
     <para>