1c12ac98b78ef413996567cde38e2a9d09de3af8
[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 role="arguments">
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>-quit</term>
123                 <listitem>
124                     <para>
125                         This option forces scilab to always exit after the instruction(s) passed with the <literal>-e</literal>
126                         option, or the script referred to by the <literal>-f</literal> option, have been executed,
127                         even in case of a runtime error. This option should always be used in batch mode.
128                         It is ignored if neither <literal>-e</literal> nor <literal>-f</literal> options are present.
129                     </para>
130                 </listitem>
131             </varlistentry>
132             <varlistentry>
133                 <term>-l lang</term>
134                 <listitem>
135                     <para>
136                         Если есть эта опция, то она фиксирует язык пользователя.
137                         <emphasis>lang</emphasis> может быть: <emphasis>ca_ES de_DE en_US es_ES
138                             fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW
139                         </emphasis>
140                         (начиная с Scilab 5.2).
141                     </para>
142                     <para>
143                         Другими возможными значениями <literal>lang</literal> (для совместимости) являются <literal>'fr'</literal>
144                         для французского и <literal>'en'</literal> для английского языка. По умолчанию язык английский.
145                         Это значение по умолчанию зафиксировано в файле <literal>scilab.start</literal>.
146                     </para>
147                     <para>
148                         В некоторых системах для правильного отображения шрифтов в кодировке UTF-8 локали должны быть откомпилированы.
149                     </para>
150                     <para>Scilab также может быть запущен следующим образом:</para>
151                     <programlisting role="no-scilab-exec">LANG=ja_JP scilab
152                         #  то же, что и
153                         scilab -l ja_JP
154                     </programlisting>
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 role="description">
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 role="description">
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 role="examples">
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 role="history">
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             <revision>
432                 <revnumber>6.0.0</revnumber>
433                 <revremark>
434                     <literal>-quit</literal> option added. <literal>-mem</literal> option removed.
435                 </revremark>
436             </revision>
437         </revhistory>
438     </refsection>
439 </refentry>