* bug #14558: square() is obsolete 64/18464/4
Samuel GOUGEON [Mon, 15 Aug 2016 20:36:17 +0000 (22:36 +0200)]
  http://bugzilla.scilab.org/14558
  All files containing "square"|'square'|square(|>square< have been visited.
  All relevant references processed.
  To be removed in 6.1: square.xml, square.sci
  To be updated in 6.1: scilab_macros.txt

Change-Id: Ia4c1d8ddd0c7a0d849f43859cf3a896fcfa66680

23 files changed:
scilab/CHANGES.md
scilab/CHANGES_6.0.0 [deleted file]
scilab/modules/graphics/demos/textrendering/latex/fulltest.dem.sce
scilab/modules/graphics/help/en_US/Graphics.xml
scilab/modules/graphics/help/en_US/axes_operations/isoview.xml
scilab/modules/graphics/help/en_US/axes_operations/square.xml
scilab/modules/graphics/help/en_US/xsetech.xml
scilab/modules/graphics/help/fr_FR/Graphics.xml
scilab/modules/graphics/help/fr_FR/axes_operations/isoview.xml
scilab/modules/graphics/help/fr_FR/axes_operations/square.xml
scilab/modules/graphics/help/fr_FR/xsetech.xml
scilab/modules/graphics/help/ja_JP/Graphics.xml
scilab/modules/graphics/help/ja_JP/axes_operations/isoview.xml
scilab/modules/graphics/help/ja_JP/axes_operations/square.xml
scilab/modules/graphics/help/ja_JP/xsetech.xml
scilab/modules/graphics/help/pt_BR/Graphics.xml
scilab/modules/graphics/help/pt_BR/axes_operations/isoview.xml
scilab/modules/graphics/help/pt_BR/axes_operations/square.xml
scilab/modules/graphics/help/pt_BR/xsetech.xml
scilab/modules/graphics/help/ru_RU/Graphics.xml
scilab/modules/graphics/macros/square.sci
scilab/modules/graphics/tests/nonreg_tests/bug_3753.dia.ref
scilab/modules/graphics/tests/nonreg_tests/bug_3753.tst

index c09eb0a..627c0fd 100644 (file)
@@ -280,7 +280,7 @@ Obsolete functions or features
 * `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.
-
+* `square` will be removed from Scilab 6.1. Please use `gcf().axes_size` and `replot` instead.
 
 Removed Functions
 -----------------
@@ -380,6 +380,7 @@ Bug Fixes
 * [#14527](http://bugzilla.scilab.org/show_bug.cgi?id=14527): Calling pathconvert function without parameters crashed Scilab.
 * [#14553](http://bugzilla.scilab.org/show_bug.cgi?id=14553): find(a=b) crashed Scilab.
 * [#14557](http://bugzilla.scilab.org/show_bug.cgi?id=14557): `csim` failed when the system has no state.
+* [#14558](http://bugzilla.scilab.org/show_bug.cgi?id=14558): fixed - `square` was poor, clumsy and too specific. It is tagged as obsolete.
 * [#14564](http://bugzilla.scilab.org/show_bug.cgi?id=14564): fieldnames failed for empty structs.
 * [#14571](http://bugzilla.scilab.org/show_bug.cgi?id=14571): The type of input argument of `figure`function was not checked.
 * [#14578](http://bugzilla.scilab.org/show_bug.cgi?id=14578): LaTeX string used for text uicontrol was not updated.
diff --git a/scilab/CHANGES_6.0.0 b/scilab/CHANGES_6.0.0
deleted file mode 100644 (file)
index 17fac6a..0000000
+++ /dev/null
@@ -1,8 +0,0 @@
-                     Changes between version 5.5.2 and 6.0.0-beta-1
-                     ==============================================
-
-Xcos
-====
-
-* Optimal - new link style for avoiding links crossing the blocks.
-
index 279d788..eb27e9d 100644 (file)
@@ -13,7 +13,8 @@ function demo_fulltest()
     // DEMO START
     my_handle.figure_name="LaTeX Math";
     //grosse chaine latex
-    square(0,0,15,15);
+    my_handle.axes_size = [610 610];
+    replot([0 0 15 15]);
     xtitle("$\scalebox{1.6}\JLaTeXMath$");
     str="$\newcommand{\oa}{\left|}\newcommand{\fa}{\right|}\scalebox{1.6}{\begin{split}"+...
     "|I_2| &= \oa\int_0^T\psi(t)\left\{ u(a,t)-\int_{\gamma(t)}^a \frac{d\theta}{k} (\theta,t) \int_a^\theta c(\xi) u_t (\xi,t)\,d\xi\right\}dt\fa\\&\\&\mathrm{Produced\ with\ Java\ and\ \textcolor{OliveGreen}{\LaTeX}\ by\ }\mathscr{C}\mathcal{A}\mathfrak{L}\mathbf{I}\mathtt{X}\mathbb{T}\mathsf{E}.\\&\mbox{It handles accents (éàçèêïö\oe\ae) or cyrillic (привет мир)}\\&\mbox{or greek (γειά κόσμο) for our international users.}\\&\begin{pmatrix}\alpha&\beta&\gamma\\\aleph&\beth&\gimel\\\mathfrak{A}&\mathfrak{B}&\mathfrak{C}\\\end{pmatrix}\quad{(a+b)}^{\frac{n}{2}}=\sqrt{\sum_{k=0}^n\tbinom{n}{k}a^kb^{n-k}}\quad\\&\forall\varepsilon\in\mathbb{R}_+^*\ \exists\eta>0\ |x-x_0|\leq\eta\Longrightarrow|f(x)-f(x_0)|\leq\varepsilon\\&\det\begin{bmatrix}a_{11}&a_{12}&\cdots&a_{1n}\\a_{21}&\ddots&&\vdots\\\vdots&&\ddots&\vdots\\a_{n1}&\cdots&\cdots&a_{nn}\end{bmatrix}\overset{\mathrm{def}}{=}\sum_{\sigma\in\mathfrak{S}_n}\varepsilon(\sigma)\prod_{k=1}^n a_{k\sigma(k)}\\&\Delta f(x,y)=\frac{\partial^2f}{\partial x^2}+\frac{\partial^2f}{\partial y^2}\qquad\qquad \boxed{n!\underset{n\rightarrow+\infty}{\sim} {\left(\frac{n}{e}\right)}^n\sqrt{2\pi n}}\\&\fcolorbox{black}{Bittersweet}{\sideset{_\alpha^\beta}{_\gamma^\delta}{\begin{pmatrix}a&b\\c&d\end{pmatrix}}}\xrightarrow[T]{n\pm i-j}\sideset{^t}{}A\xleftarrow{\overrightarrow{u}\wedge\overrightarrow{v}}\underleftarrow{\iint_{\mathds{R}^2}e^{-\left(x^2+y^2\right)}\,\mathrm{d}x\mathrm{d}y}\end{split}}$";
index 64f4e59..8bc6147 100644 (file)
             </varlistentry>
             <varlistentry>
                 <term>
-                    <link linkend="square">square</link>
-                </term>
-                <listitem>
-                    <para>Set scales for isometric plot (change the size of the window)</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>
                     <link linkend="scaling">scaling</link>
                 </term>
                 <listitem>
index 0afebe5..6d9eeea 100644 (file)
@@ -16,7 +16,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" xml:id="isoview">
     <refnamediv>
         <refname>isoview</refname>
-        <refpurpose>tunes isometric rendering of graphical axes (window size unchanged)
+        <refpurpose>tunes isometric rendering of graphical axes
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
@@ -230,9 +230,6 @@ xtitle("with frameflag=4")
         <title>See also</title>
         <simplelist type="inline">
             <member>
-                <link linkend="square">square</link>
-            </member>
-            <member>
                 <link linkend="replot">replot</link>
             </member>
             <member>
index ed1d1a5..b270471 100644 (file)
@@ -17,7 +17,7 @@
     <refnamediv>
         <refname>square</refname>
         <refpurpose>
-            set scales for isometric plot (change the size of the window)
+            set scales for isometric plot (change the size of the window) <emphasis role="bold">(function obsolete)</emphasis>
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
     </refsection>
     <refsection>
         <title>Description</title>
+        <warning>
+            This function is obsolete. It will be removed in Scilab 6.1.
+        </warning>
+        <warning>
+            Please replace <literal>square(a,b,c,d)</literal> with
+            <literal>gcf().axes_size = [n n]; replot([a b c d])</literal>
+            where <literal>n</literal> is the size in pixels of the desired
+            graphic square window. This replacement can be extended to any
+            existing graphic window, not only the current one.
+        </warning>
         <para>
             <function>square</function> is used to have isometric scales on the x
             and y axes. The requested values <literal>xmin</literal>,
@@ -71,4 +81,15 @@ plot2d(sin(t),cos(t))
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0</revnumber>
+                <revdescription>
+                    square() is tagged as obsolete. It will be removed from Scilab 6.1
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 84e3900..68bb52d 100644 (file)
@@ -189,7 +189,7 @@ clf()
                 <link linkend="isoview">isoview</link>
             </member>
             <member>
-                <link linkend="square">square</link>
+                <link linkend="replot">replot</link>
             </member>
         </simplelist>
     </refsection>
index 0375369..39e99e7 100644 (file)
             </varlistentry>
             <varlistentry>
                 <term>
-                    <link linkend="square">square</link>
-                </term>
-                <listitem>
-                    <para>échelle isométrique (par changement de la taille de la fenêtre)</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>
                     <link linkend="scaling">scaling</link>
                 </term>
                 <listitem>
index e63806d..c0ba51d 100644 (file)
@@ -16,7 +16,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="fr" xml:id="isoview">
     <refnamediv>
         <refname>isoview</refname>
-        <refpurpose>Règle la vue isométrique des repères graphiques (taille de fenêtre fixe)
+        <refpurpose>Règle la vue isométrique des repères graphiques
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
@@ -235,9 +235,6 @@ xtitle("with frameflag=4")
         <title>Voir aussi</title>
         <simplelist type="inline">
             <member>
-                <link linkend="square">square</link>
-            </member>
-            <member>
                 <link linkend="replot">replot</link>
             </member>
             <member>
index c00d23a..71ec35c 100644 (file)
@@ -2,7 +2,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="fr" xml:id="square">
     <refnamediv>
         <refname>square</refname>
-        <refpurpose>échelle isométrique 2D (change la taille de la fenêtre)  </refpurpose>
+        <refpurpose>échelle isométrique 2D (change la taille de la fenêtre)  <emphasis role="bold">(fonction obsolète)</emphasis> </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Séquence d'appel</title>
     </refsection>
     <refsection>
         <title>Description</title>
+        <warning>
+            Cette fonction est obsolète. Elle sera retirée de Scilab 6.1.
+        </warning>
+        <warning>
+            SVP remplacer <literal>square(a,b,c,d)</literal> par
+            <literal>gcf().axes_size = [n n]; replot([a b c d])</literal>
+            où <literal>n</literal> est la taille en pixels de la fenêtre graphique
+            carrée désirée. Cette méthode peut être utilisée pour toutes les
+            fenêtres graphiques existantes, pas uniquement la fenêtre active.
+        </warning>
         <para>
             <literal>square</literal> est utilisée pour avoir une échelle identique sur les axes x et y.
             Les valeurs
@@ -52,4 +62,15 @@ plot2d(sin(t),cos(t))
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>Historique</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0</revnumber>
+                <revdescription>
+                    square() est indiquée comme obsolète. Elle sera retirée de Scilab 6.1.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index af7ad20..bcfc16b 100644 (file)
@@ -160,7 +160,7 @@ xset("default")
                 <link linkend="isoview">isoview</link>
             </member>
             <member>
-                <link linkend="square">square</link>
+                <link linkend="replot">replot</link>
             </member>
         </simplelist>
     </refsection>
index ef82474..3dc3471 100644 (file)
             </varlistentry>
             <varlistentry>
                 <term>
-                    <link linkend="square">square</link>
-                </term>
-                <listitem>
-                    <para>等軸プロットにスケールを設定 (ウインドウの大きさを変更)</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>
                     <link linkend="scaling">scaling</link>
                 </term>
                 <listitem>
index 49515a8..b6e557f 100644 (file)
@@ -17,7 +17,7 @@
 
     <refnamediv>
         <refname>isoview</refname>
-        <refpurpose>等軸プロットにスケールを設定 (ウインドウの大きさを変更しない)  </refpurpose>
+        <refpurpose>等軸プロットにスケールを設定</refpurpose>
     </refnamediv>
 
     <refsynopsisdiv>
@@ -241,9 +241,6 @@ xtitle("with frameflag=4")
         <title>参照</title>
         <simplelist type="inline">
             <member>
-                <link linkend="square">square</link>
-            </member>
-            <member>
                 <link linkend="replot">replot</link>
             </member>
             <member>
index ecfc4a1..e316808 100644 (file)
@@ -1,14 +1,15 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <!--
-
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-
  * Copyright (C) INRIA - Serge Steer
+<<<<<<< HEAD
 
  *
 
 
+=======
+ *
+>>>>>>> 7f4fe15... * bug #14558: square() is obsolete
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * and continues to be available under such terms.
  * For more information, see the COPYING file which you should have received
  * along with this program.
-
  *
-
  -->
-
 <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="square">
+<<<<<<< HEAD
 
     <refnamediv>
 
 
         <programlisting role="example"><![CDATA[
 
+=======
+    <refnamediv>
+        <refname>square</refname>
+        <refpurpose>
+            等軸プロットのスケールを設定 (ウインドウの大きさを変更)   <emphasis role="bold">(function obsolete)</emphasis>
+        </refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>呼び出し手順</title>
+        <synopsis>square(xmin, ymin, xmax, ymax)</synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>引数</title>
+        <variablelist>
+            <varlistentry>
+                <term>xmin, xmax, ymin, ymax</term>
+                <listitem>
+                    <para>実数値</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>説明</title>
+        <warning>
+            This function is obsolete. It will be removed in Scilab 6.1.
+        </warning>
+        <warning>
+            Please replace <literal>square(a,b,c,d)</literal> with
+            <literal>gcf().axes_size = [n n]; replot([a b c d])</literal>
+            where <literal>n</literal> is the size in pixels of the desired
+            graphic square window. This replacement can be extended to any
+            existing graphic window, not only the current one.
+        </warning>
+        <para>
+            <function>square</function> は, xおよびy軸に等軸スケールを
+            適用する際に使用されます.
+            指定された値 <literal>xmin</literal>,
+            <literal>xmax</literal>, <literal>ymin</literal>,
+            <literal>ymax</literal> は
+            グラフィックフレームの境界で, <function>square</function>  は
+            等軸プロットとなるようにグラフィックウインドウの次元を変更します.
+            <function>square</function> は,
+            カレントのグラフィックスケールを設定し,
+            カレントのグラフィックスケールを指定する
+            グラフィックルーチン
+            (例えば, <function>plot2d</function>の
+            <code>strf="x0z"</code>)
+            と組み合わせて使用することができます.
+        </para>
+    </refsection>
+    <refsection>
+        <title>例</title>
+        <programlisting role="example"><![CDATA[
+>>>>>>> 7f4fe15... * bug #14558: square() is obsolete
 t=[0:0.1:2*%pi]';
-
 plot2d(sin(t),cos(t))
-
 clf()
-
 square(-1,-1,1,1)
-
 plot2d(sin(t),cos(t))
-
  ]]></programlisting>
-
     </refsection>
-
     <refsection role="see also">
-
         <title>参照</title>
-
         <simplelist type="inline">
-
             <member>
-
                 <link linkend="isoview">isoview</link>
-
             </member>
-
             <member>
-
                 <link linkend="xsetech">xsetech</link>
-
             </member>
-
         </simplelist>
-
     </refsection>
-
+    <refsection role="history">
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0</revnumber>
+                <revdescription>
+                    square() is tagged as obsolete. It will be removed from Scilab 6.1
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
-
index 98d2f30..fc52cc4 100644 (file)
@@ -374,7 +374,7 @@ clf()
 
             <member>
 
-                <link linkend="square">square</link>
+                <link linkend="replot">replot</link>
 
             </member>
 
index d344934..86e32a7 100644 (file)
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>square</term>
-                <listitem>
-                    <para>ajusta escalas para esboço isométrico (muda o tamanho da
-                        janela)
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
                 <term>scaling</term>
                 <listitem>
                     <para>transformação afim de um conjunto de pontos</para>
index d193da0..d4d3804 100644 (file)
@@ -16,7 +16,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:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="isoview" xml:lang="pt">
     <refnamediv>
         <refname>isoview</refname>
-        <refpurpose>ajusta escalas para esboço isométrico (não muda o tamanho da janela)
+        <refpurpose>ajusta escalas para esboço isométrico
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
@@ -233,9 +233,6 @@ xtitle("with frameflag=4")
         <title>Ver Também</title>
         <simplelist type="inline">
             <member>
-                <link linkend="square">square</link>
-            </member>
-            <member>
                 <link linkend="replot">replot</link>
             </member>
             <member>
index bf301cc..f827932 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Serge Steer
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="square" xml:lang="pt">
     <refnamediv>
         <refname>square</refname>
-        <refpurpose>ajusta escalas para esboço isométrico (muda o tamanho da
-            janela)
+        <refpurpose>ajusta escalas para esboço isométrico (muda o tamanho da
+            janela)  <emphasis role="bold">(function obsolete)</emphasis>
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
-        <title>Seqüência de Chamamento</title>
+        <title>Seqüência de Chamamento</title>
         <synopsis>square(xmin,ymin,xmax,ymax)</synopsis>
     </refsynopsisdiv>
     <refsection>
-        <title>Parâmetros</title>
+        <title>Parâmetros</title>
         <variablelist>
             <varlistentry>
                 <term>xmin,xmax,ymin,ymax</term>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Descrição</title>
+        <title>Descrição</title>
+        <warning>
+            This function is obsolete. It will be removed in Scilab 6.1.
+        </warning>
+        <warning>
+            Please replace <literal>square(a,b,c,d)</literal> with
+            <literal>gcf().axes_size = [n n]; replot([a b c d])</literal>
+            where <literal>n</literal> is the size in pixels of the desired
+            graphic square window. This replacement can be extended to any
+            existing graphic window, not only the current one.
+        </warning>
         <para>
-            <literal>square</literal> é usado para definir escalas isométricas
+            <literal>square</literal> é usado para definir escalas isométricas
             nos eixos x e y. Os valores requeridos <literal>xmin, xmax, ymin,
                 ymax
             </literal>
-            são os limites da moldura de gráficos e
-            <literal>square</literal> muda as dimensões da janela de gráficos para se
-            obter um esboço isométrico. <literal>square</literal> ajusta as escalas
-            gráficas correntes e pode ser usado em conjunção com rotinas de gráfico
-            que requerem a escala de gráficos corrente (por exemplo
+            são os limites da moldura de gráficos e
+            <literal>square</literal> muda as dimensões da janela de gráficos para se
+            obter um esboço isométrico. <literal>square</literal> ajusta as escalas
+            gráficas correntes e pode ser usado em conjunção com rotinas de gráfico
+            que requerem a escala de gráficos corrente (por exemplo
             <literal>fstrf="x0z"</literal> em <literal>plot2d</literal>).
         </para>
     </refsection>
@@ -61,7 +71,7 @@ plot2d(sin(t),cos(t))
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
-        <title>Ver Também</title>
+        <title>Ver Também</title>
         <simplelist type="inline">
             <member>
                 <link linkend="isoview">isoview</link>
@@ -71,4 +81,15 @@ plot2d(sin(t),cos(t))
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>Histórico</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0</revnumber>
+                <revdescription>
+                    square() is tagged as obsolete. It will be removed from Scilab 6.1
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 3689df2..edbe10d 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:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="xsetech" xml:lang="pt">
     <refnamediv>
         <refname>xsetech</refname>
-        <refpurpose>ajusta a sub-janela de uma janela de gráficos para
-            esboço
+        <refpurpose>ajusta a sub-janela de uma janela de gráficos para
+            esboço
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
-        <title>Seqüência de Chamamento</title>
+        <title>Seqüência de Chamamento</title>
         <synopsis>xsetech(wrect,[frect,logflag])
             xsetech(wrect=[...],frect=[..],logflag="..", arect=[...])
             xsetech()
         </synopsis>
     </refsynopsisdiv>
     <refsection>
-        <title>Parâmetros</title>
+        <title>Parâmetros</title>
         <variablelist>
             <varlistentry>
                 <term>wrect</term>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Descrição </title>
+        <title>Descrição </title>
         <para>
-            <literal>xsetech</literal> é principalmente utilizado para ajustar a
-            sub-janela da janela de gráficos que será utilizada para esboço. A
-            sub-janela é especificada através do parâmetro
+            <literal>xsetech</literal> é principalmente utilizado para ajustar a
+            sub-janela da janela de gráficos que será utilizada para esboço. A
+            sub-janela é especificada através do parâmetro
             <literal>wrect=[x,y,w,h]</literal> (ponto superior esquerdo, largura,
-            altura). Os valores em <literal>wrect</literal> a são especificados
-            utilizando-se a proporção de largura ou altura da janela de gráficos
+            altura). Os valores em <literal>wrect</literal> a são especificados
+            utilizando-se a proporção de largura ou altura da janela de gráficos
             corrente. Por exemplo, <literal>wrect=[0,0,1,1]</literal> significa que
-            toda a janela será utilizada e <literal>wrect=[0.5,0,0.5,1]</literal>
-            significa que a região gráfica será a metade direita da janela de
-            gráficos.
+            toda a janela será utilizada e <literal>wrect=[0.5,0,0.5,1]</literal>
+            significa que a região gráfica será a metade direita da janela de
+            gráficos.
         </para>
         <para>
-            <literal>xsetech</literal> também ajusta as escalas gráficas
-            correntes para esboço 2d e pode ser utilizada juntamente a rotinas
-            gráficas que requerem a escala de gráficos corrente (por exemplo
+            <literal>xsetech</literal> também ajusta as escalas gráficas
+            correntes para esboço 2d e pode ser utilizada juntamente a rotinas
+            gráficas que requerem a escala de gráficos corrente (por exemplo
             <literal>strf="x0z"</literal> ou <literal>frameflag=0</literal> em
             <literal>plot2d</literal>).
         </para>
         <para>
-            <literal>frect=[xmin,ymin,xmax,ymax]</literal> é utilizado para
-            ajustar a escala gráfica e é igual ao argumento <literal>rect</literal> de
-            <literal>plot2d</literal>. Se <literal>frect</literal> não for fornecido,
-            o valor corrente da escala de gráficos permanece inalterado. O valor
-            padrão de <literal>rect</literal> é <literal>[0,0,1,1]</literal> (na
-            criação de janelas, quando se volta para o valor padrão com
-            <literal>xset('default')</literal> ou quando se limpa eventos gráficos
+            <literal>frect=[xmin,ymin,xmax,ymax]</literal> é utilizado para
+            ajustar a escala gráfica e é igual ao argumento <literal>rect</literal> de
+            <literal>plot2d</literal>. Se <literal>frect</literal> não for fornecido,
+            o valor corrente da escala de gráficos permanece inalterado. O valor
+            padrão de <literal>rect</literal> é <literal>[0,0,1,1]</literal> (na
+            criação de janelas, quando se volta para o valor padrão com
+            <literal>xset('default')</literal> ou quando se limpa eventos gráficos
             gravados <literal>clf()</literal>).
         </para>
         <para>
-            <literal>arect=[x_left, x_right,y_up,y_down]</literal> é utilizado
-            para ajustar a moldura gráfica dentro da sub-janela. A moldura gráfica é
-            especificada (como <literal>wrect</literal>) utilizando-se a proporção de
-            largura ou altura da sub-janela de gráficos corrente. O valor padrão é
-            <literal>1/8*[1,1,1,1]</literal>. Se <literal>arect</literal> não for
-            fornecido, o valor padrão permanece inalterado.
+            <literal>arect=[x_left, x_right,y_up,y_down]</literal> é utilizado
+            para ajustar a moldura gráfica dentro da sub-janela. A moldura gráfica é
+            especificada (como <literal>wrect</literal>) utilizando-se a proporção de
+            largura ou altura da sub-janela de gráficos corrente. O valor padrão é
+            <literal>1/8*[1,1,1,1]</literal>. Se <literal>arect</literal> não for
+            fornecido, o valor padrão permanece inalterado.
         </para>
     </refsection>
     <refsection>
         <title>Exemplos</title>
+<<<<<<< HEAD
         <programlisting role="example"><![CDATA[
 // para obter uma explanação gráfica dos parâmetros de xsetech entre com:
 exec('SCI/modules/graphics/demos/xsetechfig.sce');
@@ -112,22 +113,43 @@ exec('SCI/modules/graphics/demos/xsetechfig.sce');
 xsetech([0,0,1.0,0.5],[-5,-3,5,3])
 // chamamos plot2d com a opção "001" para utilizar a escala de gráficos
 // ajustada por xsetech
+=======
+        <programlisting role="example"><![CDATA[ 
+// para obter uma explanação gráfica dos parâmetros de xsetech entre com:
+exec('SCI/modules/graphics/demos/xsetechfig.sce');
+
+// aqui xsetech é usado para dividir a janela de gráficos em duas partes
+// o primeiro xsetech é usado para se ajustar a primeira sub-janela 
+// e a escala de gráficos corrente
+xsetech([0,0,1.0,0.5],[-5,-3,5,3])
+// chamamos plot2d com a opção "001" para utilizar a escala de gráficos
+// ajustada por xsetech 
+>>>>>>> 7f4fe15... * bug #14558: square() is obsolete
 plot2d([1:10]',[1:10]',1,"001"," ")
-// então xsetech é usado para ajustar a segunda sub-janela
+// então xsetech é usado para ajustar a segunda sub-janela
 xsetech([0,0.5,1.0,0.5])
+<<<<<<< HEAD
 // a escala de gráficos é ajustada por xsetech para [0,0,1,1] por padrão
 // e nós a modificamos utilizando o argumento rect em plot2d
+=======
+// a escala de gráficos é ajustada por xsetech para [0,0,1,1] por padrão
+// e nós a modificamos utilizando o argumento rect em plot2d 
+>>>>>>> 7f4fe15... * bug #14558: square() is obsolete
 plot2d([1:10]',[1:10]',1,"011"," ",[-6,-6,6,6])
-// quatro esboços em uma única janela de gráficos
+// quatro esboços em uma única janela de gráficos
 clf()
 xset("font",2,0)
 xsetech([0,0,0.5,0.5]); plot3d()
 xsetech([0.5,0,0.5,0.5]); plot2d()
 xsetech([0.5,0.5,0.5,0.5]); grayplot()
 xsetech([0,0.5,0.5,0.5]); histplot()
-// de volta aos valores padrões para a sub-janela
+// de volta aos valores padrões para a sub-janela
 xsetech([0,0,1,1])
+<<<<<<< HEAD
 // um esboço com arect modificado
+=======
+// um esboço com arect modificado 
+>>>>>>> 7f4fe15... * bug #14558: square() is obsolete
 clf()
 xset("default")
 xsetech(arect=[0,0,0,0])
@@ -140,7 +162,7 @@ xset("default")
  ]]></programlisting>
     </refsection>
     <refsection>
-        <title>Ver Também </title>
+        <title>Ver Também </title>
         <simplelist type="inline">
             <member>
                 <link linkend="xgetech">xgetech</link>
@@ -152,7 +174,7 @@ xset("default")
                 <link linkend="isoview">isoview</link>
             </member>
             <member>
-                <link linkend="square">square</link>
+                <link linkend="replot">replot</link>
             </member>
         </simplelist>
     </refsection>
index 67f6cbf..d0fcf03 100644 (file)
             </varlistentry>
             <varlistentry>
                 <term>
-                    <link linkend="square">square</link>
-                </term>
-                <listitem>
-                    <para>
-                        Установка равного масштаба осей графика (меняет размер окна)
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>
                     <link linkend="scaling">scaling</link>
                 </term>
                 <listitem>
index 1a7d416..2f40f3b 100644 (file)
@@ -9,7 +9,7 @@
 // For more information, see the COPYING file which you should have received
 // along with this program.
 
-function []=square(xmin,ymin,xmax,ymax)
+function square(xmin,ymin,xmax,ymax)
 
     //definit un  environnement  graphique
     //permettant un trace isometrique.
@@ -21,7 +21,11 @@ function []=square(xmin,ymin,xmax,ymax)
     //meme taille de dessin, utiliser plutot la macro isoview. Les extrema
     //sont imposes.
     //!
-
+    msg = ["square(xmin,ymin,xmax,ymax) is obsolete."
+           "square() will be removed from Scilab 6.1"
+           "Please use ""gcf().axes_size=[n,n]; replot([xmin ymin xmax ymax])"" instead."
+           ]
+    warning(msg)
     [lhs,rhs]=argn(0);
 
     if (rhs>0) & (rhs<>4) then
index 9cb6737..2313ac1 100644 (file)
@@ -14,7 +14,8 @@
 // Using draw axes in range mode ('r') produces labels are completely unreadable and show strange characters.
 //
 SC=3.2;
-square(-SC,-SC,SC,SC)
+gcf().axes_size  = [610 610];
+replot([-SC,-SC,SC,SC]);
 drawaxis(x=[SC,-SC,8],y=-SC,dir="d",tics="r",format_n="%1.1f");
 axis = gce();
 if (axis.tics_labels <> ["3.2"  "2.4"  "1.6"  "0.8"  "0.0"  "-0.8"  "-1.6"  "-2.4"  "-3.2"]) then bugmes();quit;end
index e7788a9..ea1b0e8 100644 (file)
@@ -17,7 +17,8 @@
 //
 
 SC=3.2;
-square(-SC,-SC,SC,SC)
+gcf().axes_size  = [610 610];
+replot([-SC,-SC,SC,SC]);
 drawaxis(x=[SC,-SC,8],y=-SC,dir="d",tics="r",format_n="%1.1f");
 
 axis = gce();