* Bug 15615: datatipToggle() declared obsolete 66/20166/5
Samuel GOUGEON [Tue, 19 Jun 2018 12:38:38 +0000 (14:38 +0200)]
  http://bugzilla.scilab.org/15615

Change-Id: Iaff0d7cbbb4711c84dbb6b3250c24f9a18f6faff

scilab/CHANGES.md
scilab/modules/graphics/help/en_US/datatips/datatipManagerMode.xml
scilab/modules/graphics/help/en_US/datatips/datatipToggle.xml
scilab/modules/graphics/help/en_US/datatips/datatips.xml
scilab/modules/graphics/help/ja_JP/datatips/datatipManagerMode.xml
scilab/modules/graphics/help/ja_JP/datatips/datatipToggle.xml
scilab/modules/graphics/help/ja_JP/datatips/datatips.xml
scilab/modules/graphics/tests/nonreg_tests/bug_8163.dia.ref [deleted file]
scilab/modules/graphics/tests/nonreg_tests/bug_8163.tst
scilab/modules/gui/sci_gateway/cpp/sci_datatip_toggle.cpp
scilab/modules/slint/src/cpp/DeprecatedChecker.cpp

index 8ee0f68..4911433 100644 (file)
@@ -336,7 +336,7 @@ Obsolete functions or features
 * `maxfiles` is now obsolete.
 * `isoview(xmin,xmax,ymin,ymax)` is deprecated. Please use `isoview("on"), replot(..)` instead.
 * `eval3d` will be removed from Scilab 6.1. Please use `ndgrid` instead.
-* `strcmpi` is deprecated. Please use `strcmp(..,"i")`instead.
+* `strcmpi` is deprecated. Please use `strcmp(..,"i")` instead.
 * `square` will be removed from Scilab 6.1. Please use `gcf().axes_size` and `replot` instead.
 * `nanmin` is obsolete and will be removed in Scilab 6.1. Please use `min` instead.
 * `nanmax` is obsolete and will be removed in Scilab 6.1. Please use `max` instead.
@@ -347,7 +347,11 @@ Obsolete functions or features
 * `dgettext` is obsolete and will be removed in Scilab 6.1. Please use `gettext(domain, text)` instead.
 * `denom` is obsolete and will be removed in Scilab 6.1. Please use the `.den` rational attribute instead.
 * `numer` is obsolete and will be removed in Scilab 6.1. Please use the `.num` rational attribute instead.
+<<<<<<< HEAD
 * `with_tk` is obsolete and will be removed in Scilab 6.1. Please use the `with_module` instead.
+=======
+* `datatipToggle` is obsolete and will be removed in Scilab 6.1. Please use the `datatipManagerMode` instead.
+>>>>>>> 08a3f51... * Bug 15615: datatipToggle() declared obsolete
 
 
 Removed Functions
@@ -480,6 +484,7 @@ Known issues
 * [#15598](http://bugzilla.scilab.org/show_bug.cgi?id=15598): `string(handle)` returned "" instead of calling `%h_string()`
 * [#15599](http://bugzilla.scilab.org/show_bug.cgi?id=15599): degree of zero polynomial was 0 instead of -Inf.
 * [#15609](http://bugzilla.scilab.org/show_bug.cgi?id=15609): (1:1):2 crashed Scilab.
+* [#15615](http://bugzilla.scilab.org/show_bug.cgi?id=15615): `datatipToggle()` was a duplicate of `datatipManagerMode()`.
 * [#15621](http://bugzilla.scilab.org/show_bug.cgi?id=15621): polynomial exponentiation silently truncated exponent (regression).
 * [#15625](http://bugzilla.scilab.org/show_bug.cgi?id=15625): `delip(1,1)=0` instead of `Inf`
 * [#15626](http://bugzilla.scilab.org/show_bug.cgi?id=15626): clicking on its icon did not give focus to a docked Scinotes.
index ce70a11..cfb5c46 100644 (file)
@@ -78,7 +78,7 @@
         <title>See also</title>
         <simplelist type="inline">
             <member>
-                <link linkend="datatipToggle">datatipToggle</link>
+                <link linkend="datatips">datatips</link>
             </member>
         </simplelist>
     </refsection>
index 3b56bd3..086f4d9 100644 (file)
@@ -14,7 +14,7 @@
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en_US" xml:id="datatipToggle">
     <refnamediv>
         <refname>datatipToggle</refname>
-        <refpurpose>toggles the data tips mode.</refpurpose>
+        <refpurpose>toggles the data tips mode (<emphasis role="bold">obsolete</emphasis>)</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
     </refsection>
     <refsection>
         <title>Description</title>
+        <warning>
+            This function is obsolete and must be replaced with <literal>datatipManagerMode()</literal>.
+            It will be removed from Scilab 6.1.0.
+        </warning>
         <para>
             When enabled, the data tips mode allow
             to add and edit tips at selected points of curve. The selection is
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.2</revnumber>
+                <revdescription>
+                    datatipToggle() is declared obsolete to be removed from Scilab 6.1.0.
+                    It is replaced with datatipManagerMode().
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 9ae7ef0..3aaaa35 100644 (file)
@@ -14,7 +14,7 @@
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en_US" xml:id="datatips">
     <refnamediv>
         <refname>datatips</refname>
-        <refpurpose>Tool for placing and editing tips along the plotted curves.</refpurpose>
+        <refpurpose>Tool for placing and editing tips along the plotted curves</refpurpose>
     </refnamediv>
     <refsection>
         <title>Description</title>
@@ -24,8 +24,8 @@
             commonly used mode is the interactive one:
         </para>
         <para>
-            The datatips mode can be enabled by <link linkend="datatipToggle">datatipToggle()</link> or using the
-            <literal>Edit/Start datatip manager</literal> or clicking on the
+            The datatips mode can be enabled by <link linkend="datatipManagerMode">datatipManagerMode()</link>
+            or using the <literal>Edit/Start datatip manager</literal> or clicking on the
             toolbar icon
             <inlinemediaobject>
                 <imageobject>
@@ -66,8 +66,8 @@
     datatipSetOrientation(t,"upper left")
 
     function str=myfmt(h)
-               pt = h.data;
-               str = msprintf('sinc\n%s', sci2exp(round(pt*10)/10))
+        pt = h.data;
+        str = msprintf('sinc\n%s', sci2exp(round(pt*10)/10))
     endfunction
     datatipSetDisplay(t,"myfmt")
 
         <title>See also</title>
         <simplelist type="inline">
             <member>
-                <link linkend="datatipToggle">datatipToggle</link>
+                <link linkend="datatipManagerMode">datatipManagerMode</link>
             </member>
             <member>
                 <link linkend="datatipCreate">datatipCreate</link>
index 9683a3f..21d77c9 100644 (file)
 
             <member>
 
-                <link linkend="datatipToggle">datatipToggle</link>
+                <link linkend="datatips">datatips</link>
 
             </member>
 
index 0d182d7..88ddc0b 100644 (file)
 
 -->
 
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="datatipToggle">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+        xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+        xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+        xml:lang="ja" xml:id="datatipToggle">
 
     <refnamediv>
 
         <refname>datatipToggle</refname>
 
-        <refpurpose>data tipsモードをトグルする.</refpurpose>
+        <refpurpose>data tipsモードをトグルする (<emphasis role="bold">時代遅れ</emphasis>).</refpurpose>
 
     </refnamediv>
 
     <refsection>
 
         <title>説明</title>
-
+        <warning>
+            This function is obsolete and must be replaced with <literal>datatipManagerMode()</literal>.
+            It will be removed from Scilab 6.1.0.
+        </warning>
         <para>
 
             有効にした場合,
         </simplelist>
 
     </refsection>
+    <refsection role="history">
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.2</revnumber>
+                <revdescription>
+                    datatipToggle() is declared obsolete for a removal from Scilab 6.1.0.
+                    It is replaced with datatipManagerMode().
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 
 </refentry>
 
index c4d33d3..e582ff3 100644 (file)
@@ -44,7 +44,7 @@
 
         <para>
 
-            datatipsモードは <link linkend="datatipToggle">datatipToggle()</link> または
+            datatipsモードは <link linkend="datatipManagerMode">datatipManagerMode()</link> または
 
             <literal>Edit/Start datatip manager</literal> または指定するグラフィックウインドウの
 
 
       pt = h.data;
 
-         str = msprintf('sinc\n%s', sci2exp(round(pt*10)/10))
+      str = msprintf('sinc\n%s', sci2exp(round(pt*10)/10))
 
     endfunction
 
 
             <member>
 
-                <link linkend="datatipToggle">datatipToggle</link>
+                <link linkend="datatipToggle">datatipManagerMode</link>
 
             </member>
 
diff --git a/scilab/modules/graphics/tests/nonreg_tests/bug_8163.dia.ref b/scilab/modules/graphics/tests/nonreg_tests/bug_8163.dia.ref
deleted file mode 100644 (file)
index 1f33c88..0000000
+++ /dev/null
@@ -1,16 +0,0 @@
-// =============================================================================
-// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-// Copyright (C) 2010 - INRIA - Serge Steer
-//
-//  This file is distributed under the same license as the Scilab package.
-// =============================================================================
-// <-- TEST WITH GRAPHIC -->
-// <-- Non-regression test for bug 8163 -->
-//
-// <-- Bugzilla URL -->
-// http://bugzilla.scilab.org/show_bug.cgi?id=8163
-//
-// <-- Short Description -->
-// datatipToggle cannot be called without argument as stated in the help page
-plot(1:10)
-if execstr('datatipToggle()','errcatch')<>0 then bugmes();quit;end
index 5a6d7df..157f072 100644 (file)
@@ -6,6 +6,7 @@
 // =============================================================================
 
 // <-- TEST WITH GRAPHIC -->
+// <-- NO CHECK REF -->
 
 // <-- Non-regression test for bug 8163 -->
 //
@@ -14,7 +15,8 @@
 //
 // <-- Short Description -->
 // datatipToggle cannot be called without argument as stated in the help page
+// datatipToggle replaced by datatipManagerMode in Scilab 6.1
 
 plot(1:10)
-if execstr('datatipToggle()','errcatch')<>0 then pause,end
+datatipManagerMode()
 
index 61db699..ac283fb 100644 (file)
@@ -24,12 +24,16 @@ extern "C"
 #include "gw_gui.h"
 #include "HandleManagement.h"
 #include "CurrentFigure.h"
+#include "sciprint.h"
 }
 
 using namespace org_scilab_modules_gui_datatip;
 
 int sci_datatip_toggle(char *fname, void* pvApiCtx)
 {
+    sciprint(_("%s: %s is obsolete and will be removed from Scilab %s\n"), _("Warning"), fname, "6.1");
+    sciprint(_("%s: Please use %s instead.\n"), _("Warning"), "datatipManagerMode()");
+
     int iFigureUID      = 0;
 
     int iErr            = 0;
index 4f7fd52..9fc3255 100644 (file)
@@ -95,6 +95,7 @@ std::unordered_map<std::wstring, std::wstring> DeprecatedChecker::initDep()
     // Scilab 6.0.x => 6.1.0
     map.emplace(L"_d", L"_");
     map.emplace(L"dgettext", L"gettext");
+    map.emplace(L"datatipToggle", L"datatipManagerMode");
     map.emplace(L"denom", L".den");
     map.emplace(L"lstsize", L"size");
     map.emplace(L"nanmin", L"min");