fprintf, fscanf & sscanf: Clearly tag them as obsolete 88/9888/4
Sylvestre Ledru [Fri, 30 Nov 2012 12:58:02 +0000 (13:58 +0100)]
Change-Id: I0d826706be95e37c129cb860c1a03a836d65922f

scilab/modules/fileio/help/en_US/fprintf.xml
scilab/modules/fileio/help/en_US/fscanf.xml
scilab/modules/fileio/help/en_US/sscanf.xml
scilab/modules/fileio/macros/fprintf.sci
scilab/modules/fileio/macros/fscanf.sci
scilab/modules/fileio/macros/sscanf.sci

index b290196..7d66d00 100644 (file)
@@ -56,7 +56,7 @@
         <title>Description</title>
         <para>
             <caution>
-                This function is obsolete, use preferabily the <link
+                This function is obsolete and will be removed in Scilab 5.5.0, use preferabily the <link
         linkend="mfprintf">mfprintf</link> function which is much more
                 compatible with the C <function>fprintf</function> functionalities.
             </caution>
@@ -104,6 +104,15 @@ file('close',u) //close the result file
 fprintf(0,'My error which is going to be displayed on the stderr') 
  ]]></programlisting>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.1</revnumber>
+                <revremark>Function tagged as obsolete. Will be removed in 5.5.0.</revremark>
+            </revision>
+        </revhistory>
+    </refsection>
     <refsection role="see also">
         <title>See Also</title>
         <simplelist type="inline">
index a57e876..a9fff0a 100644 (file)
@@ -47,7 +47,7 @@
         <title>Description</title>
         <para>
             <warning>
-                This function is obsolete, use preferably the <function>mfscanf</function>
+                This function is obsolete and will be removed in Scilab 5.5.0, use preferably the <link linkend="mfscanf">mfscanf</link>
                 function which is more efficient and is more compatible with the C
                 <function>fscanf</function> procedure.
             </warning>
             </listitem>
         </itemizedlist>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.1</revnumber>
+                <revremark>Function tagged as obsolete. Will be removed in 5.5.0.</revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+    
     <refsection role="see also">
         <title>See Also</title>
         <simplelist type="inline">
index 369f934..fc62dee 100644 (file)
@@ -48,8 +48,8 @@
         <title>Description</title>
         <para>
             <caution>
-                This function is obsolete, use preferably the 
-                <function>msscanf</function> function which is more efficient and 
+                This function is obsolete and will be removed in Scilab 5.5.0, use preferably the 
+                <link linkend="msscanf">msscanf</link> function which is more efficient and 
                 is more compatible with the C <function>sscanf</function> 
                 procedure.
             </caution>
             </listitem>
         </itemizedlist>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.1</revnumber>
+                <revremark>Function tagged as obsolete. Will be removed in 5.5.0.</revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+    
     <refsection role="see also">
         <title>See Also</title>
         <simplelist type="inline">
index c06d42f..81f1f90 100644 (file)
@@ -13,6 +13,8 @@ function fprintf(fil, frmt, varargin)
 // fprintf - Emulator of C language fprintf
 //
 
+  warnobsolete("mfprintf","5.5.0");
+
   [lhs, rhs] = argn(0);
   if rhs < 2 then
     error(999, msprintf(gettext("%s: Wrong number of input argument(s).\n"), "fprintf"));
index a07eb09..2f692a8 100644 (file)
@@ -13,6 +13,7 @@ function varargout = fscanf(fil, frmt)
 
 // fscanf - Emulator of C language fscanf
 //!
+  warnobsolete("mfscanf","5.5.0");
 
   [lhs, rhs] = argn(0);
 
index f57515e..32857c3 100644 (file)
@@ -13,10 +13,12 @@ function varargout = sscanf(buf, frmt)
 
   // sscanf - Emulator of C language sscanf
 
+  warnobsolete("msscanf","5.5.0");
+
   [lhs,rhs]  = argn(0);
   MAXLHS = 50;
   if lhs > MAXLHS then
-    error(999, msprintf(gettext("%s: Wrong number of output argument(s).\n"),"sscanf"));
+    error(999, msprintf(gettext("%s: Wrong number of output argument(s).\n"),"sscanf"));x
   end
 
   hexdigits  = [string(0:9),'a','b','c','d','e','f','A','B','C','D','E','F']