Update dot help pages
[scilab.git] / scilab / modules / core / help / ja_JP / 1_keywords / dot.xml
index 6c1281a..fcf5624 100644 (file)
@@ -6,10 +6,17 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>
-        <synopsis>123.33
+        <synopsis>
+            123.33
+
             a.*b
-            [123,..
-            456]
+            a .*. b
+
+            %pi * (%e + ..
+            %i)
+
+            cd ..
+            dir ..
         </synopsis>
     </refsynopsisdiv>
     <refsection>
                     </para>
                     <para>以下の関数 foo:</para>
                     <programlisting role=""><![CDATA[ 
-function foo
-  a=1
-  disp(a),..
-  disp('ok')
+function foo()
+    plot2d()
+    xtitle(["General title"; "It can be multiline, so quite long"], ..
+            "This is the X-axis title", "Y title")
 endfunction
  ]]></programlisting>
                     <para>は次の関数と等価です:</para>
                     <programlisting role=""><![CDATA[ 
-function foo 
-  a=1
+function foo()
+    plot2d()
 
-  disp(a),disp('ok') 
+    xtitle(["General title"; "It can be multiline, so quite long"], "This is the X-axis title", "Y title")
 endfunction
  ]]></programlisting>
                     <para>物理行3行目と物理行4行目からなる論理行は
                         物理行4行目に全体が書かれ,物理行3行目が空の時と
                         同じとなります.このようなことが可能なのは,
                         継続記号を式の中の任意の場所に置く事ができるためです.
+                        <note>The difference between logical and physical
+                        lines is of importance when dealing with edition (scinotes, edit), with
+                        profiling (profile, showprofile, plotprofile), and within error messages
+                        (whereami), when the line number is provided or displayed.
+                        </note>
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>".." parameter</term>
+                <listitem>
+                    <para>When functions are used in a console-oriented way, <literal>..</literal>
+                        is not considered as a continuation mark but as a simple argument. The most
+                        common usage is with <literal>cd ..</literal>, <literal>dir ..</literal>
+                        or <literal>ls ..</literal> actually standing for <literal>cd("..")</literal>,
+                        etc.
                     </para>
                 </listitem>
             </varlistentry>
@@ -89,15 +112,50 @@ endfunction
 1.345
 
 //used as part of an operator
-x=[1 2 3];x.^2 .*x // a space is required between 2 and dot
+x = [1 2 3];x.^2 .*x // a space is required between 2 and dot
+
+// When writing rows of a matrix on different lines, ".." can be used but are not mandatory.
+N = [   ..
+    63.    89.    3.   ..
+    91.    56.    22.  ..
+    15.    64.    40.  ..
+    ]
+// It can be more simply entered as (or copied/pasted from/to console or script), without appending ".."
+N = [
+    63.    89.    3.
+    91.    56.    22.
+    15.    64.    40.
+    ]
 
-// used to enter continuation lines
-T=[123,..//first element
-   456] //second one
+// Within very long instructions like when creating uicontrol where many properties must be set,
+// continuation marks are almost mandatory and allow to write and set one property per line
+// in a readable way. A single huge line would not comply with Scilab coding style:
+fig = figure("figure_name", "FIGURE", ..
+             "dockable",    "off", ..
+             "axes_size",   [990,670], ..
+             "infobar_visible", "off", ..
+             "toolbar",     "none", ..
+             "menubar_visible", "on", ..
+             "menubar",     "none", ..
+             "default_axes","off", ..
+             "layout",      "border", ..
+             "background",  color(244,244,244), ..
+             "tag",         "figure_1", ..
+             "visible",     "on");
 
-a="here I start a very long string...  //but I'm not in the mood of continuing
+// Console-oriented calls with some ".." argument
+d = pwd(); cd SCI/contrib
+cd ..   // stands for cd("..") and expects nothing on the next line
+cd(d)   // Go back to your working directory
+
+// This expression does not work anymore in Scilab 6
+a = "here I start a very long string...  //but I'm not in the mood of continuing
      - and here I go on"
-y=12..
+// This one is the correct expression now
+a = "here I start a very long string"+...  //but I'm not in the mood of continuing
+    "    - and here I go on"
+// This expression is not allowed anymore in Scilab 6: scalar number must be written on one line
+y = 12..
 45
  ]]></programlisting>
     </refsection>
@@ -116,6 +174,34 @@ y=12..
             <member>
                 <link linkend="backslash">backslash</link>
             </member>
+            <member>
+                <link linkend="whereami">whereami</link>
+            </member>
+            <member>
+                <link linkend="showprofile">showprofile</link>
+            </member>
+            <member>
+                <link linkend="edit">edit</link>
+            </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        It is not possible anymore to cut a scalar number.
+                    </para>
+                    <para>
+                        To cut a single string, "+.." operators must be used.
+                    </para>
+                    <para>In console-oriented calls, <literal>myfun ..</literal> no longer expects
+                        a continuation on the next line.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>