File: dot.xml

package info (click to toggle)
scilab 5.2.2-9
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 334,832 kB
  • ctags: 52,586
  • sloc: xml: 526,945; ansic: 223,590; fortran: 163,080; java: 56,934; cpp: 33,840; tcl: 27,936; sh: 20,397; makefile: 9,908; ml: 9,451; perl: 1,323; cs: 614; lisp: 30
file content (132 lines) | stat: -rw-r--r-- 3,678 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<?xml version="1.0" encoding="UTF-8"?>
<refentry version="5.0-subset Scilab" xml:id="dot" xml:lang="en"
          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">
  <info>
    <pubdate>$LastChangedDate$</pubdate>
  </info>

  <refnamediv>
    <refname>dot</refname>

    <refpurpose>(.) symbol</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <title>Calling Sequence</title>

    <synopsis>123.33
a.*b
[123,..
456]</synopsis>
  </refsynopsisdiv>

  <refsection>
    <title>Description</title>

    <variablelist>
      <varlistentry>
        <term>.</term>

        <listitem>
          <para>Dot is used to mark decimal point for numbers : 3.25 and
          0.001</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>.&lt;op&gt;</term>

        <listitem>
          <para>used in conjunction with other operator symbols (<literal>* /
          \ ^ '</literal>) to form other operators. Element-by-element
          multiplicative operations are obtained using <literal> .* , .^ , ./
          , .\</literal> or <literal>.'</literal>. For example, C = A ./ B is
          the matrix with elements c(i,j) = a(i,j)/b(i,j). Kronecker product
          is noted .*. . Note that when dot follows a number it is alway prt
          of the number so 2.*x is evaluated as 2.0*x and 2 .*x is evaluated
          as (2).*x</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>..</term>

        <listitem>
          <para>Continuation mark. Two or more decimal points at the end of a
          line (or followed by a comment) causes the following line to be a
          continuation.</para>

          <para>Continuation lines are handled by a preprocessor which builds
          a long logical line from a sequence of continuation lines. So the
          continuation marks can be used to cut a line at any point.</para>

          <para>The following function foo:</para>

          <programlisting role = ""><![CDATA[ 
function foo
  a=1
  disp(a),..
  disp('ok')
endfunction
 ]]></programlisting>

          <para>is equivalent to:</para>

          <programlisting role = ""><![CDATA[ 
function foo 
  a=1

  disp(a),disp('ok') 
endfunction
 ]]></programlisting>

          <para>The logical line formed by physical line 3 and physical line 4
          is built as if it was entirely written in the physical line 4 while
          physical line 3 would be empty. This is done this way because
          continuation marks can be put anywhere even inside an
          expression.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>

  <refsection>
    <title>Examples</title>

    <programlisting role="example"><![CDATA[ 
//decimal point
1.345

//used as part of an operator
x=[1 2 3];x.^2 .*x // a space is required between 2 and dot

// used to enter continuation lines
T=[123,..//first element
   456] //second one

a="here I start a very long string...  //but I'm not in the mood of continuing
     - and here I go on"
y=12..
45
 ]]></programlisting>
  </refsection>

  <refsection>
    <title>See Also</title>

    <simplelist type="inline">
      <member><link linkend="star">star</link></member>

      <member><link linkend="hat">hat</link></member>

      <member><link linkend="slash">slash</link></member>

      <member><link linkend="backslash">backslash</link></member>
    </simplelist>
  </refsection>
</refentry>