Update dot help pages
[scilab.git] / scilab / modules / core / help / pt_BR / 1_keywords / dot.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
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="en">
3     <refnamediv>
4         <refname>dot</refname>
5         <refpurpose>(.) símbolo de ponto</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title> Seqüência de Chamamento </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>Descrição</title>
24         <variablelist>
25             <varlistentry>
26                 <term>.</term>
27                 <listitem>
28                     <para>É usado para marcar pontos (vírgulas) decimais em números:
29                         3.25 e 0.001
30                     </para>
31                 </listitem>
32             </varlistentry>
33             <varlistentry>
34                 <term>.&lt;op&gt;</term>
35                 <listitem>
36                     <para>usado em conjunto com outros símbolos de operadores ( *, /, \,
37                         ^, ' ), forma outros operadores. Operações multiplicativas elemento
38                         a elemento são obtidas utilizando-se .* , .^ , ./ , .\ ou .' . Por
39                         exemplo, C = A ./ B é a matriz com elementos c(i,j) = a(i,j)/b(i,j).
40                         O produto de Kronecker é notado por.*. . Note que quando o ponto
41                         segue um número, é sempre parte deste 2.*x é avaliado como 2.0*x e 2
42                         .*x (há um espaço entre 2 e .) é avaliado como (2).*x
43                     </para>
44                 </listitem>
45             </varlistentry>
46             <varlistentry>
47                 <term>..</term>
48                 <listitem>
49                     <para>Marca de continuação. Dois ou mais pontos ao fim de uma linha
50                         (ou seguidos por um comentário) indicam que a próxima linha será uma
51                         continuação.
52                     </para>
53                     <para>Linhas de continuação são manipuladas por um processador que
54                         constrói uma linha lógica longa de uma dada seqüência de linhas de
55                         continuação. Então, marcas de continuação podem ser usadas para
56                         cortar uma linha em qualquer ponto.
57                     </para>
58                     <para>
59                         The following function <literal>foo</literal>:
60                     </para>
61                     <programlisting role=""><![CDATA[
62 function foo()
63     plot2d()
64     xtitle(["General title"; "It can be multiline, so quite long"], ..
65             "This is the X-axis title", "Y title")
66 endfunction
67  ]]></programlisting>
68                     <para>is equivalent to:</para>
69                     <programlisting role=""><![CDATA[
70 function foo()
71     plot2d()
72
73     xtitle(["General title"; "It can be multiline, so quite long"], "This is the X-axis title", "Y title")
74 endfunction
75  ]]></programlisting>
76                     <para>The logical line formed by physical line 3 and physical line 4
77                         is built as if it was entirely written in the physical line 4 while
78                         physical line 3 would be empty. This is done this way because
79                         continuation marks can be put anywhere even inside an
80                         expression.
81                         <note>The difference between logical and physical
82                         lines is of importance when dealing with edition (scinotes, edit), with
83                         profiling (profile, showprofile, plotprofile), and within error messages
84                         (whereami), when the line number is provided or displayed.
85                         </note>
86                     </para>
87                 </listitem>
88             </varlistentry>
89             <varlistentry>
90                 <term>".." parameter</term>
91                 <listitem>
92                     <para>When functions are used in a console-oriented way, <literal>..</literal>
93                         is not considered as a continuation mark but as a simple argument. The most
94                         common usage is with <literal>cd ..</literal>, <literal>dir ..</literal>
95                         or <literal>ls ..</literal> actually standing for <literal>cd("..")</literal>,
96                         etc.
97                     </para>
98                 </listitem>
99             </varlistentry>
100         </variablelist>
101     </refsection>
102     <refsection>
103         <title>Exemplos</title>
104         <programlisting role="example"><![CDATA[ 
105 //ponto decimal
106 1.345
107
108 //usado como parte de um operador
109 x=[1 2 3];x.^2 .*x // um espaço é requerido entre 2 e o ponto
110
111 // When writing rows of a matrix on different lines, ".." can be used but are not mandatory.
112 N = [   ..
113     63.    89.    3.   ..
114     91.    56.    22.  ..
115     15.    64.    40.  ..
116     ]
117 // It can be more simply entered as (or copied/pasted from/to console or script), without appending ".."
118 N = [
119     63.    89.    3.
120     91.    56.    22.
121     15.    64.    40.
122     ]
123
124 // Within very long instructions like when creating uicontrol where many properties must be set,
125 // continuation marks are almost mandatory and allow to write and set one property per line
126 // in a readable way. A single huge line would not comply with Scilab coding style:
127 fig = figure("figure_name", "FIGURE", ..
128              "dockable",    "off", ..
129              "axes_size",   [990,670], ..
130              "infobar_visible", "off", ..
131              "toolbar",     "none", ..
132              "menubar_visible", "on", ..
133              "menubar",     "none", ..
134              "default_axes","off", ..
135              "layout",      "border", ..
136              "background",  color(244,244,244), ..
137              "tag",         "figure_1", ..
138              "visible",     "on");
139
140 // Console-oriented calls with some ".." argument
141 d = pwd(); cd SCI/contrib
142 cd ..   // stands for cd("..") and expects nothing on the next line
143 cd(d)   // Go back to your working directory
144
145 // This expression does not work anymore in Scilab 6
146 a = "here I start a very long string...  //but I'm not in the mood of continuing
147      - and here I go on"
148 // This one is the correct expression now
149 a = "here I start a very long string"+...  //but I'm not in the mood of continuing
150     "    - and here I go on"
151 // This expression is not allowed anymore in Scilab 6: scalar number must be written on one line
152 y = 12..
153 45
154  ]]></programlisting>
155     </refsection>
156     <refsection>
157         <title> Ver Também </title>
158         <simplelist type="inline">
159             <member>
160                 <link linkend="star">star</link>
161             </member>
162             <member>
163                 <link linkend="hat">hat</link>
164             </member>
165             <member>
166                 <link linkend="slash">slash</link>
167             </member>
168             <member>
169                 <link linkend="backslash">backslash</link>
170             </member>
171             <member>
172                 <link linkend="whereami">whereami</link>
173             </member>
174             <member>
175                 <link linkend="showprofile">showprofile</link>
176             </member>
177             <member>
178                 <link linkend="edit">edit</link>
179             </member>
180         </simplelist>
181     </refsection>
182     <refsection>
183         <title>History</title>
184         <revhistory>
185             <revision>
186                 <revnumber>6.0.0</revnumber>
187                 <revremark>
188                     <para>
189                         It is not possible anymore to cut a scalar number.
190                     </para>
191                     <para>
192                         To cut a single string, "+.." operators must be used.
193                     </para>
194                     <para>In console-oriented calls, <literal>myfun ..</literal> no longer expects
195                         a continuation on the next line.
196                     </para>
197                 </revremark>
198             </revision>
199         </revhistory>
200     </refsection>
201 </refentry>