* Bug #14105 fixed - New block comments /*...*/ feature was not documented.
[scilab.git] / scilab / modules / core / help / ru_RU / 1_keywords / comments.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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="comments">
3     <refnamediv>
4         <refname>комментарии</refname>
5         <refpurpose>(// or /*...*/) comments</refpurpose>
6     </refnamediv>
7     <refsection>
8         <title>Описание</title>
9         <para>
10             Два последовательных слэша <literal>//</literal> за пределами определения 
11             строкового значения обозначают начало комментария. Слэши, как и все последующие
12             символы вплоть до конца строки, не интерпретируются.
13         </para>
14         <para>
15             Another way to comment a block of code is to use /* at the beginning
16             and */ at the end. It is more useful than // which must be positioned at the
17             beginning of each line to comment.
18         </para>
19         <para>
20             Внутри функции первые строки, вплоть до первой инструкции или пустой строки
21             могут использоваться для указания содержимого для функции <literal>help</literal>.
22         </para>
23     </refsection>
24     <refsection>
25         <title>Примеры</title>
26         <programlisting role="example"><![CDATA[ 
27 g=9.81// ускорение свободного падения
28
29 text='a//b'
30
31 /* As this comment is quite long to be on many lines,
32 the symbols slash and star to start the comment
33 and star and slash to end the comment are used */
34
35 function y=myfunction(x)
36   // myfunction вычисляет y=x^2+1
37   // x должен быть вектором или матрицей
38   y=x^2+1
39 endfunction
40
41 help myfunction
42  ]]></programlisting>
43     </refsection>
44     <refsection role="see also">
45         <title>Смотрите также</title>
46         <simplelist type="inline">
47             <member>
48                 <link linkend="slash">слэш</link>
49             </member>
50             <member>
51                 <link linkend="backslash">обратный слэш</link>
52             </member>
53         </simplelist>
54     </refsection>
55 </refentry>