Update dot help pages
[scilab.git] / scilab / modules / core / help / ja_JP / 1_keywords / dot.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <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="dot" xml:lang="ja">
3     <refnamediv>
4         <refname>dot</refname>
5         <refpurpose>(.) 記号</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>呼び出し手順</title>
9         <synopsis>
10             123.33
11
12             a.*b
13             a .*. b
14
15             %pi * (%e + ..
16             %i)
17
18             cd ..
19             dir ..
20         </synopsis>
21     </refsynopsisdiv>
22     <refsection>
23         <title>説明</title>
24         <variablelist>
25             <varlistentry>
26                 <term>.</term>
27                 <listitem>
28                     <para>ドットは以下のように数字の小数点を示すために使用されます : 3.25 および
29                         0.001
30                     </para>
31                 </listitem>
32             </varlistentry>
33             <varlistentry>
34                 <term>.&lt;op&gt;</term>
35                 <listitem>
36                     <para>
37                         は他の演算記号 (<literal>* /
38                             \ ^ '
39                         </literal>
40                         )と組み合わせて別の演算子を作成するために
41                         使用されます.
42                         要素毎の複合演算子は<literal> .* , .^ , ./
43                             , .\
44                         </literal>
45                         または <literal>.'</literal>により
46                         得られます.
47                         例えば, C = A ./ B は c(i,j) = a(i,j)/b(i,j) を要素とする
48                         行列となります.
49                         クロネッカー積は .*. と表記されます.
50                         ドットの後に数字が続く場合,このドットは数字の一部とみなされる
51                         ことに注意してください.
52                         このため, 2.*x は 2.0*x として評価され,
53                         2 .*x は (2).*x として評価されます.
54                     </para>
55                 </listitem>
56             </varlistentry>
57             <varlistentry>
58                 <term>..</term>
59                 <listitem>
60                     <para>継続記号. 2つ以上の小数点が行の末尾(あるいはコメントの前)にあると,
61                         次の行は継続されます.
62                     </para>
63                     <para>継続行は, プリプロセッサにより処理され,
64                         一連の継続行から一つの長い論理行が作成されます.
65                         このため,継続記号は,行を任意の点で分割するために使用することができます..
66                     </para>
67                     <para>以下の関数 foo:</para>
68                     <programlisting role=""><![CDATA[ 
69 function foo()
70     plot2d()
71     xtitle(["General title"; "It can be multiline, so quite long"], ..
72             "This is the X-axis title", "Y title")
73 endfunction
74  ]]></programlisting>
75                     <para>は次の関数と等価です:</para>
76                     <programlisting role=""><![CDATA[ 
77 function foo()
78     plot2d()
79
80     xtitle(["General title"; "It can be multiline, so quite long"], "This is the X-axis title", "Y title")
81 endfunction
82  ]]></programlisting>
83                     <para>物理行3行目と物理行4行目からなる論理行は
84                         物理行4行目に全体が書かれ,物理行3行目が空の時と
85                         同じとなります.このようなことが可能なのは,
86                         継続記号を式の中の任意の場所に置く事ができるためです.
87                         <note>The difference between logical and physical
88                         lines is of importance when dealing with edition (scinotes, edit), with
89                         profiling (profile, showprofile, plotprofile), and within error messages
90                         (whereami), when the line number is provided or displayed.
91                         </note>
92                     </para>
93                 </listitem>
94             </varlistentry>
95             <varlistentry>
96                 <term>".." parameter</term>
97                 <listitem>
98                     <para>When functions are used in a console-oriented way, <literal>..</literal>
99                         is not considered as a continuation mark but as a simple argument. The most
100                         common usage is with <literal>cd ..</literal>, <literal>dir ..</literal>
101                         or <literal>ls ..</literal> actually standing for <literal>cd("..")</literal>,
102                         etc.
103                     </para>
104                 </listitem>
105             </varlistentry>
106         </variablelist>
107     </refsection>
108     <refsection>
109         <title>例</title>
110         <programlisting role="example"><![CDATA[ 
111 //decimal point
112 1.345
113
114 //used as part of an operator
115 x = [1 2 3];x.^2 .*x // a space is required between 2 and dot
116
117 // When writing rows of a matrix on different lines, ".." can be used but are not mandatory.
118 N = [   ..
119     63.    89.    3.   ..
120     91.    56.    22.  ..
121     15.    64.    40.  ..
122     ]
123 // It can be more simply entered as (or copied/pasted from/to console or script), without appending ".."
124 N = [
125     63.    89.    3.
126     91.    56.    22.
127     15.    64.    40.
128     ]
129
130 // Within very long instructions like when creating uicontrol where many properties must be set,
131 // continuation marks are almost mandatory and allow to write and set one property per line
132 // in a readable way. A single huge line would not comply with Scilab coding style:
133 fig = figure("figure_name", "FIGURE", ..
134              "dockable",    "off", ..
135              "axes_size",   [990,670], ..
136              "infobar_visible", "off", ..
137              "toolbar",     "none", ..
138              "menubar_visible", "on", ..
139              "menubar",     "none", ..
140              "default_axes","off", ..
141              "layout",      "border", ..
142              "background",  color(244,244,244), ..
143              "tag",         "figure_1", ..
144              "visible",     "on");
145
146 // Console-oriented calls with some ".." argument
147 d = pwd(); cd SCI/contrib
148 cd ..   // stands for cd("..") and expects nothing on the next line
149 cd(d)   // Go back to your working directory
150
151 // This expression does not work anymore in Scilab 6
152 a = "here I start a very long string...  //but I'm not in the mood of continuing
153      - and here I go on"
154 // This one is the correct expression now
155 a = "here I start a very long string"+...  //but I'm not in the mood of continuing
156     "    - and here I go on"
157 // This expression is not allowed anymore in Scilab 6: scalar number must be written on one line
158 y = 12..
159 45
160  ]]></programlisting>
161     </refsection>
162     <refsection role="see also">
163         <title>参照</title>
164         <simplelist type="inline">
165             <member>
166                 <link linkend="star">star</link>
167             </member>
168             <member>
169                 <link linkend="hat">hat</link>
170             </member>
171             <member>
172                 <link linkend="slash">slash</link>
173             </member>
174             <member>
175                 <link linkend="backslash">backslash</link>
176             </member>
177             <member>
178                 <link linkend="whereami">whereami</link>
179             </member>
180             <member>
181                 <link linkend="showprofile">showprofile</link>
182             </member>
183             <member>
184                 <link linkend="edit">edit</link>
185             </member>
186         </simplelist>
187     </refsection>
188     <refsection>
189         <title>History</title>
190         <revhistory>
191             <revision>
192                 <revnumber>6.0.0</revnumber>
193                 <revremark>
194                     <para>
195                         It is not possible anymore to cut a scalar number.
196                     </para>
197                     <para>
198                         To cut a single string, "+.." operators must be used.
199                     </para>
200                     <para>In console-oriented calls, <literal>myfun ..</literal> no longer expects
201                         a continuation on the next line.
202                     </para>
203                 </revremark>
204             </revision>
205         </revhistory>
206     </refsection>
207 </refentry>