Massive indent of all codes:
[scilab.git] / scilab / modules / core / help / ru_RU / scilab.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:ns4="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="scilab" xml:lang="ru">
3         <refnamediv>
4             <refname>scilab</refname>
5             <refpurpose>
6                 главный файл-сценарий для запуска Scilab'а и различных инструментов(GNU/Linux, Unix и Mac OS X)
7             </refpurpose>
8         </refnamediv>
9         <refsynopsisdiv>
10             <title>Последовательность вызова</title>
11             <synopsis>
12                 scilab &lt;Options&gt;
13                 scilab-adv-cli &lt;Options&gt;
14                 scilab-cli &lt;Options&gt;
15             </synopsis>
16         </refsynopsisdiv>
17         <refsection>
18             <title>Описание</title>
19             <variablelist>
20                 <varlistentry>
21                     <term>-args Arguments</term>
22                     <listitem>
23                         <para>
24                             Если есть эта опция, то в Scilab передаются аргументы <literal>Arguments</literal>.
25                             Они могут затем быть получены с помощью функции 
26                             <link linkend="sciargs">sciargs</link>. Для множества передаваемых 
27                             аргументов используйте кавычки и разделяйте слова пробелами. Например, 
28                             <literal>scilab -args 'foo1 foo2'</literal>. Без этого неизвестные 
29                             аргументы не будут приняты.
30                         </para>
31                     </listitem>
32                 </varlistentry>
33                 <varlistentry>
34                     <term>-display Display</term>
35                     <listitem>
36                         <para>
37                             Только для использования в системах Xwindow для установки специфичного
38                             дисплея X-сервера. Дисплей по умолчанию -- unix:0.0.
39                         </para>
40                         <para>
41                             <literal>-display</literal> можно сократить как <literal>-d</literal>.
42                         </para>
43                     </listitem>
44                 </varlistentry>
45                 <varlistentry>
46                     <term>-debug</term>
47                     <listitem>
48                         <para>
49                             Запуск Scilab'а в отладчике gdb (только Unix/Linux/Mac OS X).
50                         </para>
51                         <para>
52                             Определите переменную  <literal>SCILAB_GDB_OPT</literal> для добавления 
53                             пользовательских настроек в gdb.
54                         </para>
55                         <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
56                     </listitem>
57                 </varlistentry>
58                 <varlistentry>
59                     <term>-debug-kdbg</term>
60                     <listitem>
61                         <para>Запуск Scilab'а в kdbg (только Unix/Linux/Mac OS X).</para>
62                         <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
63                     </listitem>
64                 </varlistentry>
65                 <varlistentry>
66                     <term>-profiling</term>
67                     <listitem>
68                         <para>Запуск Scilab'а в valgrind (только Unix/Linux/Mac OS X).</para>
69                         <para>
70                             Определите переменную  <literal>SCILAB_VALGRIND_OPT</literal>  для 
71                             добавления пользовательских настроек в valgrind (и отмены существующих 
72                             опций valgrind).
73                         </para>
74                         <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
75                     </listitem>
76                 </varlistentry>
77                 <varlistentry>
78                     <term>-profiling-visu</term>
79                     <listitem>
80                         <para>Запуск Scilab'а в callgrind (только Unix/Linux/Mac OS X).</para>
81                         <para>
82                             Определите переменную <literal>SCILAB_VALGRIND_OPT</literal> для 
83                             добавления пользовательских настроек в callgrind (и отмены существующих 
84                             опций callgrind).
85                         </para>
86                         <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
87                     </listitem>
88                 </varlistentry>
89                 <varlistentry>
90                     <term>-electric-fence</term>
91                     <listitem>
92                         <para>Запуск Scilab'а в Electric Fence (только Unix/Linux/Mac OS X).</para>
93                         <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
94                     </listitem>
95                 </varlistentry>
96                 <varlistentry>
97                     <term>-e Instruction</term>
98                     <listitem>
99                         <para>
100                             Если есть эта опция, то инструкция <literal>Instruction</literal> выполняется 
101                             первой (сразу же после исполнения файла запуска) в Scilab'e. Опции <literal>-e</literal> 
102                             и <literal>-f</literal> взаимоисключающие.
103                         </para>
104                         <para>
105                             Заметьте, что с <literal>-e</literal> можно использовать несколько инструкций.
106                         </para>
107                         <programlisting role="no-scilab-exec">scilab-cli -e  "a=1+%i; aPlusPi=a+%pi; disp(aPlusPi);exit;" -nb</programlisting>
108                     </listitem>
109                 </varlistentry>
110                 <varlistentry>
111                     <term>-f file</term>
112                     <listitem>
113                         <para>
114                             Если есть эта опция, то файл-сценарий Scilab'a <literal>file</literal> исполняется
115                             первым (сразу же после  исполнения файла запуска) в Scilab'e. <literal>-e</literal> и
116                             <literal>-f</literal>  взаимоисключающие.
117                         </para>
118                         <para>Файл с расширением .xcos будет открыт в Xcos.</para>
119                     </listitem>
120                 </varlistentry>
121                 <varlistentry>
122                     <term>-l lang</term>
123                     <listitem>
124                         <para>
125                             Если есть эта опция, то она фиксирует язык пользователя.
126                             <emphasis>lang</emphasis> может быть: <emphasis>ca_ES de_DE en_US es_ES
127                                 fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW
128                             </emphasis>
129                             (начиная с Scilab 5.2).
130                         </para>
131                         <para>
132                             Другими возможными значениями <literal>lang</literal> (для совместимости) являются <literal>'fr'</literal> 
133                             для французского и <literal>'en'</literal> для английского языка. По умолчанию язык английский.
134                             Это значение по умолчанию зафиксировано в файле <literal>scilab.start</literal>.
135                         </para>
136                         <para>
137                             В некоторых системах для правильного отображения шрифтов в кодировке UTF-8 локали должны быть откомпилированы.
138                         </para>
139                         <para>Scilab также может быть запущен следующим образом:</para>
140                         <programlisting role="no-scilab-exec">LANG=ja_JP scilab
141                             #  то же, что и
142                             scilab -l ja_JP
143                         </programlisting>
144                     </listitem>
145                 </varlistentry>
146                 <varlistentry>
147                     <term>-mem N</term>
148                     <listitem>
149                         <para>
150                             Установка исходного размера стека <literal>stacksize</literal> для использования 
151                             совместно с опцией <literal>-ns</literal>. Без опции <literal>-ns</literal> 
152                             исходный размер стека <literal>stacksize</literal> устанавливается файлом-сценарием 
153                             <literal>scilab.start</literal>.
154                         </para>
155                     </listitem>
156                 </varlistentry>
157                 <varlistentry>
158                     <term>-nb</term>
159                     <listitem>
160                         <para>
161                             Если есть эта опция, то сообщение о загрузке Scilab'а не будет отображаться.
162                         </para>
163                     </listitem>
164                 </varlistentry>
165                 <varlistentry>
166                     <term>-ns</term>
167                     <listitem>
168                         <para>
169                             Если есть эта опция, то файл запуска <literal>SCI/etc/scilab.start</literal> и пользовательские 
170                             файлы запуска <literal>SCIHOME/.scilab</literal> и <literal>SCIHOME/scilab.ini</literal> не исполняются.
171                         </para>
172                         <para>
173                             Эта опция отключит многие возможности Scilab'а (используйте, если вы знаете что делаете).
174                         </para>
175                     </listitem>
176                 </varlistentry>
177                 <varlistentry>
178                     <term>-nouserstartup</term>
179                     <listitem>
180                         <para>
181                             Если есть эта опция, то пользовательские файлы запуска <literal>SCIHOME/.scilab</literal> и 
182                             <literal>SCIHOME/scilab.ini</literal> не исполняются.
183                         </para>
184                     </listitem>
185                 </varlistentry>
186                 <varlistentry>
187                     <term>-noatomsautoload</term>
188                     <listitem>
189                         <para>
190                             Если есть эта опция, то ранее установленные модули ATOMS не загружаются для данной сессии.
191                         </para>
192                     </listitem>
193                 </varlistentry>
194                 <varlistentry>
195                     <term>-nw</term>
196                     <listitem>
197                         <para>
198                             Если есть эта опция,то Scilab запускается как командная строка с улучшенными возможностями (графические окна, экспорт, xcos, scinotes, справочная система, ...).
199                         </para>
200                         <para>
201                             Эта опция может быть использована совместно с опциями <literal>-f</literal> и <literal>-e</literal>.
202                         </para>
203                         <para>Начиная с Scilab 5.2:</para>
204                         <itemizedlist>
205                             <listitem>
206                                 <para>
207                                     Дистрибутив Scilab также предоставляет специальный бинарный файл, который
208                                     делает то же, что и <literal>-nw</literal>: <literal>scilab-adv-cli</literal> 
209                                     (Интерпретатор Scilab с улучшенной командной строкой).
210                                 </para>
211                             </listitem>
212                             <listitem>
213                                 <para>
214                                     конвейеры доступны во всех операционных системах (см. примеры для дополнительной
215                                     информации).
216                                 </para>
217                             </listitem>
218                         </itemizedlist>
219                     </listitem>
220                 </varlistentry>
221                 <varlistentry>
222                     <term>-nwni / -nogui</term>
223                     <listitem>
224                         <para>
225                             Если есть эта опция, то Scilab запускается как командная строка без улучшенных возможностей (графических окон, экспорта, xcos, scinotes, справочной системы, ...).
226                         </para>
227                         <para>
228                             Эта опция может использоваться совместно с опциями <literal>-f</literal> или
229                             <literal>-e</literal>.
230                         </para>
231                         <para>Начиная с Scilab 5.2:</para>
232                         <itemizedlist>
233                             <listitem>
234                                 <para>
235                                     Дистрибутив Scilab также предоставляет специальный бинарный файл, который
236                                     делает то же, что и <literal>-nwni</literal>: <literal>scilab-cli</literal> 
237                                     (Интерпретатор Scilab с улучшенной командной строкой).
238                                 </para>
239                             </listitem>
240                         </itemizedlist>
241                         <itemizedlist>
242                             <listitem>
243                                 <para>
244                                     конвейеры доступны во всех операционных системах (см. примеры для дополнительной
245                                     информации).
246                                 </para>
247                             </listitem>
248                         </itemizedlist>
249                         <para>
250                             Этот режим не загружает виртуальную машину Java (быстрее загружается и использует меньше памяти.
251                         </para>
252                     </listitem>
253                 </varlistentry>
254                 <varlistentry>
255                     <term>--texmacs</term>
256                     <listitem>
257                         <para>Эта опция предназначена для TeXMacs.</para>
258                         <para>Пожалуйста, установите ATOMS-модуль TeXMacs:
259                             <programlisting role="">atomsInstall('texmacs')</programlisting>atomsInstall('texmacs')
260                         </para>
261                     </listitem>
262                 </varlistentry>
263                 <varlistentry>
264                     <term>-version</term>
265                     <listitem>
266                         <para>Эта опция выводит на экран версию продукта и выходит.</para>
267                     </listitem>
268                 </varlistentry>
269             </variablelist>
270         </refsection>
271         <refsection>
272             <title>Описание переменных окружения</title>
273             <variablelist>
274                 <varlistentry>
275                     <term>SCIVERBOSE</term>
276                     <listitem>
277                         <para>
278                             Если есть эта переменная, то файл-сценарий начального запуска Scilab'а покажет
279                             отладочную информацию начального запуска. Используется главным образом для сообщения об
280                             ошибках и отладки.
281                         </para>
282                     </listitem>
283                 </varlistentry>
284                 <varlistentry>
285                     <term>JAVA_HOME</term>
286                     <listitem>
287                         <para>
288                             Определяет какую Java использовать. Например, 
289                             <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> запустить Scilab с Java 7.
290                         </para>
291                     </listitem>
292                 </varlistentry>
293                 <varlistentry>
294                     <term>SCI_DISABLE_TK</term>
295                     <listitem>
296                         <para>Отключение возможностей Tk (не не Tcl).</para>
297                     </listitem>
298                 </varlistentry>
299                 <varlistentry>
300                     <term>SCI_JAVA_ENABLE_HEADLESS</term>
301                     <listitem>
302                         <para>
303                             Включить Java Headless VM (т. е. без возможностей графического пользовательского интерфейса).
304                         </para>
305                     </listitem>
306                 </varlistentry>
307             </variablelist>
308         </refsection>
309         <refsection>
310             <title>Опции виртуальной машины Java</title>
311             <para>
312                 Начиная с Scilab 5.0, графический пользовательский интерфейс (GUI) и встроенная 
313                 документация основаны на возможностях Java. В некоторых случаях может оказаться
314                 важным править опции JVM (Виртуальная Машина Java).
315             </para>
316             <para>
317                 Эти опции доступны в файле <emphasis>jvm_options.xml</emphasis>.
318             </para>
319             <para>
320                 В версиях 5.0.X и 5.1.X этот файл хранится как 
321                 <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>.
322             </para>
323             <para>
324                 В версии &gt;= 5.2.0 этот файл доступен в 
325                 <emphasis>
326                     etc/jvm_options.xml
327                 </emphasis>
328                 .
329             </para>
330             <para>
331                 <emphasis>
332                     По умолчанию в конфигурационном файле легко доступны следующие три опции:
333                 </emphasis>
334             </para>
335             <variablelist>
336                 <varlistentry>
337                     <term>-XmxXXXm</term>
338                     <listitem>
339                         <para>
340                             Эта опция устанавливает количество памяти, доступной для виртуальной Java-машины. По умолчанию выделено 256 МБ. Если вы меняете это значение, убедитесь, что оно не превышает память системы.
341                         </para>
342                         <para>
343                             Начиная с Scilab 5.4.0, это значение можно менять в меню настроек.
344                         </para>
345                     </listitem>
346                 </varlistentry>
347                 <varlistentry>
348                     <term>-Djava.compiler=JIT</term>
349                     <listitem>
350                         <para>
351                             Эта опция с аргументом <emphasis>JIT</emphasis> задействует оперативный 
352                             Java-компилятор (JIT). Он включается по умолчанию. <emphasis>NONE</emphasis> отключает 
353                             оперативный Java-компилятор и чрезвычайно уменьшает производительность.
354                         </para>
355                     </listitem>
356                 </varlistentry>
357                 <varlistentry>
358                     <term>-verbose:jni / -Xcheck:jni</term>
359                     <listitem>
360                         <para>
361                             Эти опции задействуют больше проверок и выход из вызовов интерфейса для прямого 
362                             доступа из Java. Эти опции полезны в случае отладки и по умолчанию отключены, поскольку они уменьшают производительность.
363                         </para>
364                     </listitem>
365                 </varlistentry>
366             </variablelist>
367             <para>
368                 Доступно очень много опций. Они могут улучшить производительность, поменять взгляды и 
369                 отношение, изменить способы управления памятью... Смотрите:: <ulink url="http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp">http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp</ulink>
370                 или <ulink url="http://blogs.sun.com/watt/resource/jvm-options-list.html">http://blogs.sun.com/watt/resource/jvm-options-list.html</ulink>.
371             </para>
372         </refsection>
373         <refsection>
374             <title>Примеры</title>
375             <programlisting role="example"><![CDATA[ 
376 # Запустим Scilab в режиме профилирования без прикрепления gdb после каждого SIGSEGV.
377 # Мы находимся в оболочке Bash
378 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
379 scilab -profiling
380  
381 # Запустим Scilab в режиме отладки без остановки после каждого SIGSEGV
382 # Сначала запишем небольшой файл команд
383 echo "handle SIGSEGV nostop" &> debug.txt
384 # Теперь установим пользовательские опции
385 # Мы находимся в оболочке Bash
386 export SCILAB_GDB_OPT="--command=debug.txt"
387 # Запуск Scilab'а в режиме отладки
388 scilab -debug
389 ]]></programlisting>
390             <programlisting role="example-cli"><![CDATA[
391 # В GNU/Linux, Mac OS X или Unix:
392 $ echo "disp(%pi)"|scilab-cli
393 или
394 $ echo "disp(%pi)"|scilab -nwni
395  
396 # Открыть только окно справки Scilab:
397 $ scilab-adv-cli -e "help()"
398 или
399 $ scilab -nw -e "help()"
400  
401  
402 # Scilab может быть использован написания сценариев:
403 echo "if 1<>2 then exit(99) end"|scilab-cli
404 echo $? ]]></programlisting>
405         </refsection>
406         <refsection role="see also">
407             <title>Смотрите также</title>
408             <simplelist type="inline">
409                 <member>
410                     <link linkend="exit">exit</link>
411                 </member>
412                 <member>
413                     <link linkend="startup">начальный запуск</link>
414                 </member>
415             </simplelist>
416         </refsection>
417         <refsection>
418             <title>История</title>
419             <revhistory>
420                 <revision>
421                     <revnumber>5.4.0</revnumber>
422                     <revremark>добавлено -noatomsautoload.</revremark>
423                 </revision>
424                 <revision>
425                     <revnumber>5.4.1</revnumber>
426                     <revremark>
427                         введены отдельные сценарии scinotes и xcos. 
428                         См.SEP #87.
429                     </revremark>
430                 </revision>
431             </revhistory>
432         </refsection>
433     </refentry>