bug fix 14901: WScilex.exe stops immediately when launched from Java
[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"
3     xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml"
4     xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
5     xmlns:scilab="http://www.scilab.org" xml:id="scilab" xml:lang="ru">
6     <refnamediv xml:id="wscilex">
7     </refnamediv>
8     <refnamediv xml:id="scilex">
9     </refnamediv>
10     <refnamediv>
11         <refname>scilex | scilab</refname>
12         <refpurpose>
13             главный файл-сценарий для запуска Scilab'а и различных инструментов
14         </refpurpose>
15     </refnamediv>
16     <refsynopsisdiv>
17         <title>Синтаксис</title>
18         <synopsis>
19 #      MS Windows          |  # Linux / Unix / Mac OS X
20 wscilex     &lt;Options&gt;     |  scilab         &lt;Options&gt;
21 wscilex-cli &lt;Options&gt; |  scilab-adv-cli &lt;Options&gt;
22 scilex      &lt;Options&gt;      |  scilab-cli     &lt;Options&gt;
23         </synopsis>
24     </refsynopsisdiv>
25     <refsection role="arguments">
26         <title>Аргументы</title>
27         <variablelist>
28             <varlistentry>
29                 <term>-args arg№1 arg№2 ..</term>
30                 <listitem>
31                     <para>
32                         Эта опция позволяет переслать  данные в сессию Scilab'а:
33                         <itemizedlist>
34                             <listitem>
35                               Последовательность данных, разделённых одним или несколькими пробелами.
36                             </listitem>
37                             <listitem>
38                               Выражение между двойными кавычками является единым куском данных.
39                             </listitem>
40                             <listitem>
41                               Чтобы внести двойные кавычки в данные, запишите <literal>\"</literal> вместо <literal>"</literal>.
42                             </listitem>
43                             <listitem>
44                               Одинарная кавычка <literal>'</literal> является обычным символом. У неё нет специального значения.
45                             </listitem>
46                         </itemizedlist>
47                     </para>
48                     <para>
49                       Внутри открытой сессии эти данные могут быть получены  виде раздельных строк с помощью <link linkend="sciargs">sciargs()</link>.
50                      </para>
51                      <para>
52                       Пример:
53                         <screen><![CDATA[C:\Users\Me> scilex -nb -noatomsautoload -args "Привет, \"%USERNAME%\"" 1.2345 \"%cd%\"]]></screen>
54                         <programlisting><![CDATA[
55 // Внутри открытой сессии:
56 a = sciargs()
57 i = find(a=="-args")
58 a(i+1)
59 evstr(a(i+2))*2
60 "Эта сессия была запущена из " + a(i+3)
61                         ]]>
62                         </programlisting>
63                         <screen><![CDATA[
64 --> // Внутри открытой сессии:
65 --> a = sciargs()
66  a  =
67 !c:\SCIdir\bin\scilex  -nw  -nb  -noatomsautoload  -args  Привет, "Иван"  1.2345  "C:\Users\Me" !
68
69 --> i = find(a=="-args")
70  i  =
71     5.
72
73 --> a(i+1)
74  ans  =
75  Привет, "Иван"
76
77 --> evstr(a(i+2))*2
78  ans  =
79     2.469
80
81 --> "Эта сессия была запущена из " + a(i+3)
82  ans  =
83  Эта сессия была запущена из "C:\Users\Me"
84 ]]></screen>
85                      </para>
86                      <para>
87                      <note>
88                        Безопаснее использовать <literal>-args</literal> в качестве <emphasis role="italic">последней</emphasis> опции командной строки.
89                      </note>
90                      </para>
91                 </listitem>
92             </varlistentry>
93             <varlistentry>
94                 <term>-display Display</term>
95                 <listitem>
96                     <para>
97                         Только для использования в системах Xwindow для установки специфичного
98                         дисплея X-сервера. Дисплей по умолчанию -- unix:0.0.
99                     </para>
100                     <para>
101                         <literal>-display</literal> можно сократить как <literal>-d</literal>.
102                     </para>
103                 </listitem>
104             </varlistentry>
105             <varlistentry>
106                 <term>-e Instructions</term>
107                 <listitem>
108                     <para>
109                         По окончании запуска всей сессии, этот вариант
110                         <itemizedlist>
111                             <listitem>
112                                 <para>
113                                   устанавливает текущий рабочий каталог в каталог оболочки, из которой Scilab был запущен.
114                                   Пожалуйста, смотрите пример, приведенный здесь ниже для опции <literal>-f</literal>. Затем,
115                                 </para>
116                             </listitem>
117                             <listitem>
118                                 <para>эта опция выполняет инструкции Scilab <literal>Instructions</literal>, указанные в строке. Пример :
119                                     <screen><![CDATA[ scilab-cli -e  "disp(\"Привет\"); a=%pi+%i; disp(exp(a)); exit;" -nb]]></screen>
120                                 </para>
121                             </listitem>
122                         </itemizedlist>
123                     </para>
124                     <warning>
125                         Опции <literal>-e</literal> и <literal>-f</literal> взаимоисключающие.
126                     </warning>
127                 </listitem>
128             </varlistentry>
129             <varlistentry>
130                 <term>-f file</term>
131                 <listitem>
132                     <para>
133                         Если эта опцпия используется, то в начале сессии Scilab, после исполнения файлов запуска Sciblab и
134                         пользовательских файлов запуска, и после установки пользовательских настроек, включая настройки рабочей директории,
135                         <itemizedlist>
136                             <listitem>
137                                 <para>
138                                     текущая рабочая директория Scilab  устаровлена в каталоге оболочки, из которой Scilab был запущен. Например,
139                                     <screen><![CDATA[ D:\users\me\scilab\dev> C:\scilab-5.5.2\bin\scilex -f ..\test.sce]]></screen>
140                                     будет исполнять <literal>cd("D:\users\me\scilab\dev")</literal>.
141                                 </para>
142                             </listitem>
143                             <listitem>
144                                 <para>
145                                     Scilab-сценарий <literal>file</literal> выполнен. Если относительный путь используется
146                                     (по умолчанию <literal>.\</literal> или как <literal>..\</literal> в примере выше), то
147                                     он отсылается в новую рабочую директорию Scilab.
148                                 </para>
149                             </listitem>
150                         </itemizedlist>
151                     </para>
152                   <para>Файл с расширением <literal>.xcos</literal> будет открыт в Xcos.</para>
153                 </listitem>
154             </varlistentry>
155             <varlistentry>
156                 <term>-quit</term>
157                 <listitem>
158                     <para>
159                         Эта опция заставляет Scilab всегда выходить после инструкций, переданных вместе с опцией
160                         <literal>-e</literal>, или  сценарий, на который ссылается оция <literal>-f</literal>,
161                         будет исполнен, даже в случае ошибки времени исполнения. Эта опция всегда должна использоваться
162                         в режиме пакетной обработки. Она игнорируется, если нет ни опции <literal>-e</literal>
163                         ни опции <literal>-f</literal>.
164                     </para>
165                 </listitem>
166             </varlistentry>
167             <varlistentry>
168                 <term>-l lang</term>
169                 <listitem>
170                     <para>
171                         Если есть эта опция, то она фиксирует язык пользователя.
172                         <emphasis>lang</emphasis> может быть: <emphasis>ca_ES de_DE en_US es_ES
173                             fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW
174                         </emphasis>
175                         (начиная с Scilab 5.2).
176                     </para>
177                     <para>
178                         Другими возможными значениями <literal>lang</literal> (для совместимости) являются <literal>'fr'</literal>
179                         для французского и <literal>'en'</literal> для английского языка. По умолчанию язык английский.
180                         Это значение по умолчанию зафиксировано в файле <literal>scilab.start</literal>.
181                     </para>
182                     <para>
183                         В некоторых системах для правильного отображения шрифтов в кодировке UTF-8 локали должны быть откомпилированы.
184                     </para>
185                     <para>Scilab также может быть запущен следующим образом:</para>
186                     <screen><![CDATA[ LANG=ja_JP scilab
187  #  то же, что и
188  scilab -l ja_JP
189 ]]></screen>
190                 </listitem>
191             </varlistentry>
192             <varlistentry>
193                 <term>-nb</term>
194                 <listitem>
195                     <para>
196                         "no banner" : Если есть эта опция, то сообщение о загрузке Scilab'а не будет отображаться.
197                     </para>
198                 </listitem>
199             </varlistentry>
200             <varlistentry>
201                 <term>-ns</term>
202                 <listitem>
203                     <para>
204                         "No Startup files" :
205                         Если есть эта опция, то файл запуска <literal>SCI/etc/scilab.start</literal> и пользовательские
206                         файлы запуска <literal>SCIHOME/.scilab</literal> и <literal>SCIHOME/scilab.ini</literal> не исполняются.
207                     </para>
208                     <para>
209                         Эта опция отключит многие возможности Scilab'а (используйте, если вы знаете что делаете).
210                     </para>
211                 </listitem>
212             </varlistentry>
213             <varlistentry>
214                 <term>-nouserstartup</term>
215                 <listitem>
216                     <para>
217                         Если есть эта опция, то пользовательские файлы запуска <literal>SCIHOME/.scilab</literal> и
218                         <literal>SCIHOME/scilab.ini</literal> не исполняются.
219                     </para>
220                 </listitem>
221             </varlistentry>
222             <varlistentry>
223                 <term>-noatomsautoload</term>
224                 <listitem>
225                     <para>
226                         Если есть эта опция, то ранее установленные модули ATOMS не загружаются для данной сессии.
227                     </para>
228                 </listitem>
229             </varlistentry>
230             <varlistentry>
231                 <term>-nw</term>
232                 <listitem>
233                     <para>
234                         Если есть эта опция,то Scilab запускается как командная строка с улучшенными возможностями (графические окна, экспорт, xcos, scinotes, справочная система, ...).
235                     </para>
236                     <para>
237                         Начиная с Scilab 5.2:
238                         <itemizedlist>
239                             <listitem>
240                                 <para>
241                                     конвейеры доступны во всех операционных системах (см. примеры для дополнительной
242                                     информации).
243                                 </para>
244                             </listitem>
245                             <listitem>
246                                 <para>
247                                     Дистрибутив Scilab также предоставляет специальный бинарный файл, который
248                                     делает то же, что и <literal>-nw</literal>: <literal>scilab-adv-cli</literal>
249                                     (Интерпретатор Scilab с улучшенной командной строкой).
250                                 </para>
251                             </listitem>
252                         </itemizedlist>
253                     </para>
254                 </listitem>
255             </varlistentry>
256             <varlistentry>
257                 <term>-nwni / -nogui</term>
258                 <listitem>
259                     <important>
260                         Этот режим не загружает виртуальную машину Java (быстрее загружается и использует меньше памяти).
261                     </important>
262                     <warning>
263                         Если есть эта опция, то Scilab запускается как командная строка без улучшенных возможностей (графических окон, экспорта, xcos, scinotes, справочной системы, ...).
264                     </warning>
265                     <para>
266                         Начиная с Scilab 5.2:
267                         <itemizedlist>
268                           <listitem>
269                             <para>
270                               конвейеры доступны во всех операционных системах (см. примеры для дополнительной
271                               информации).
272                             </para>
273                           </listitem>
274                           <listitem>
275                             <para>
276                               Дистрибутив Scilab также предоставляет специальный бинарный файл, который
277                               делает то же, что и <literal>-nwni</literal>: <literal>scilab-cli</literal>
278                               (Интерпретатор Scilab с улучшенной командной строкой).
279                             </para>
280                           </listitem>
281                         </itemizedlist>
282                     </para>
283                 </listitem>
284             </varlistentry>
285             <varlistentry>
286                 <term>-scihome dir</term>
287                 <listitem>
288                     <para>Forces SCIHOME to the <literal>dir</literal> directory. If the path
289                       includes some white space, it must be specified between double-quotes (no
290                       single quotes!).
291                     </para>
292                 </listitem>
293             </varlistentry>
294             <varlistentry>
295                 <term>--texmacs</term>
296                 <listitem>
297                     <para>Эта опция предназначена для TeXMacs.</para>
298                     <para>Пожалуйста, установите ATOMS-модуль TeXMacs:
299                         <code>atomsInstall('texmacs')</code>
300                     </para>
301                 </listitem>
302             </varlistentry>
303             <varlistentry>
304                 <term>-version</term>
305                 <listitem>
306                     <para>Эта опция выводит на экран версию продукта.</para>
307                 </listitem>
308             </varlistentry>
309         </variablelist>
310     </refsection>
311
312     <refsection role="arguments">
313         <title>Дополнительные опции для Unix/Linux и Mac OS X</title>
314         <para>Совет: используйте эти параметры в дереве исходников Scilab'а.</para>
315         <variablelist>
316             <varlistentry>
317                 <term>-debug</term>
318                 <listitem>
319                     <para>
320                         Запуск Scilab'а в отладчике gdb.
321                     </para>
322                     <para>
323                         Определите переменную  <literal>SCILAB_GDB_OPT</literal> для добавления
324                         пользовательских настроек в gdb.
325                     </para>
326                 </listitem>
327             </varlistentry>
328             <varlistentry>
329                 <term>-debug-kdbg</term>
330                 <listitem>
331                     <para>Запуск Scilab'а в kdbg.</para>
332                 </listitem>
333             </varlistentry>
334             <varlistentry>
335                 <term>-profiling</term>
336                 <listitem>
337                     <para>Запуск Scilab'а в valgrind.</para>
338                     <para>
339                         Определите переменную  <literal>SCILAB_VALGRIND_OPT</literal>  для
340                         добавления пользовательских настроек в valgrind (и отмены существующих
341                         опций valgrind).
342                     </para>
343                 </listitem>
344             </varlistentry>
345             <varlistentry>
346                 <term>-profiling-visu</term>
347                 <listitem>
348                     <para>Запуск Scilab'а в callgrind.</para>
349                     <para>
350                         Определите переменную <literal>SCILAB_VALGRIND_OPT</literal> для
351                         добавления пользовательских настроек в callgrind (и отмены существующих
352                         опций callgrind).
353                     </para>
354                 </listitem>
355             </varlistentry>
356             <varlistentry>
357                 <term>-electric-fence</term>
358                 <listitem>
359                     <para>Запуск Scilab'а в Electric Fence.</para>
360                 </listitem>
361             </varlistentry>
362         </variablelist>
363     </refsection>
364
365     <refsection role="description">
366         <title>Описание переменных окружения</title>
367         <variablelist>
368             <varlistentry>
369                 <term>SCIVERBOSE</term>
370                 <listitem>
371                     <para>
372                         Если есть эта переменная, то файл-сценарий начального запуска Scilab'а покажет
373                         отладочную информацию начального запуска. Используется главным образом для сообщения об
374                         ошибках и отладки.
375                     </para>
376                 </listitem>
377             </varlistentry>
378             <varlistentry>
379                 <term>JAVA_HOME</term>
380                 <listitem>
381                     <para>
382                         Определяет какую Java использовать. Например,
383                         <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> запустить Scilab с Java 7.
384                     </para>
385                 </listitem>
386             </varlistentry>
387             <varlistentry>
388                 <term>SCI_DISABLE_TK</term>
389                 <listitem>
390                     <para>Отключение возможностей Tk (не не Tcl).</para>
391                 </listitem>
392             </varlistentry>
393             <varlistentry>
394                 <term>SCI_JAVA_ENABLE_HEADLESS</term>
395                 <listitem>
396                     <para>
397                         Включить Java Headless VM (т. е. без возможностей графического пользовательского интерфейса).
398                     </para>
399                 </listitem>
400             </varlistentry>
401         </variablelist>
402     </refsection>
403     <refsection role="description">
404         <title>Опции виртуальной машины Java</title>
405         <warning>
406             Опции, описаные ниже бесполезны и будут удалены, если используется опция <literal>-nwni</literal>.
407         </warning>
408         <para>
409             Начиная с Scilab 5.0, графический пользовательский интерфейс (GUI) и встроенная
410             документация основаны на возможностях Java. В некоторых случаях может оказаться
411             важным править опции JVM (Виртуальная Машина Java).
412         </para>
413         <para>
414             Эти опции доступны в файле <emphasis>jvm_options.xml</emphasis>.
415         </para>
416         <para>
417             В версиях 5.0.X и 5.1.X этот файл хранится как
418             <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>.
419         </para>
420         <para>
421             В версии &gt;= 5.2.0 этот файл доступен в
422             <emphasis>
423                 etc/jvm_options.xml
424             </emphasis>
425             .
426         </para>
427         <para>
428             <emphasis>
429                 По умолчанию в конфигурационном файле легко доступны следующие три опции:
430             </emphasis>
431         </para>
432         <variablelist>
433             <varlistentry>
434                 <term>-XmxXXXm</term>
435                 <listitem>
436                     <para>
437                         Эта опция устанавливает количество памяти, доступной для виртуальной Java-машины. По умолчанию выделено 256 МБ. Если вы меняете это значение, убедитесь, что оно не превышает память системы.
438                     </para>
439                     <para>
440                         Начиная с Scilab 5.4.0, это значение можно менять в меню настроек.
441                     </para>
442                 </listitem>
443             </varlistentry>
444             <varlistentry>
445                 <term>-Djava.compiler=JIT</term>
446                 <listitem>
447                     <para>
448                         Эта опция с аргументом <emphasis>JIT</emphasis> задействует оперативный
449                         Java-компилятор (JIT). Он включается по умолчанию. <emphasis>NONE</emphasis> отключает
450                         оперативный Java-компилятор и чрезвычайно уменьшает производительность.
451                     </para>
452                 </listitem>
453             </varlistentry>
454             <varlistentry>
455                 <term>-verbose:jni / -Xcheck:jni</term>
456                 <listitem>
457                     <para>
458                         Эти опции задействуют больше проверок и выход из вызовов интерфейса для прямого
459                         доступа из Java. Эти опции полезны в случае отладки и по умолчанию отключены, поскольку они уменьшают производительность.
460                     </para>
461                 </listitem>
462             </varlistentry>
463         </variablelist>
464         <para>
465             Доступно очень много опций. Они могут улучшить производительность, поменять взгляды и
466             отношение, изменить способы управления памятью... Смотрите:: <ulink url="http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp">http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp</ulink>
467             или <ulink url="http://blogs.sun.com/watt/resource/jvm-options-list.html">http://blogs.sun.com/watt/resource/jvm-options-list.html</ulink>.
468         </para>
469     </refsection>
470     <refsection role="examples">
471         <title>Примеры</title>
472         <screen><![CDATA[
473 # Запустим Scilab в режиме профилирования без прикрепления gdb после каждого SIGSEGV.
474 # Мы находимся в оболочке Bash
475 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
476 scilab -profiling
477
478 # Запустим Scilab в режиме отладки без остановки после каждого SIGSEGV
479 # Сначала запишем небольшой файл команд
480 echo "handle SIGSEGV nostop" > debug.txt
481 # Теперь установим пользовательские опции
482 # Мы находимся в оболочке Bash
483 export SCILAB_GDB_OPT="--command=debug.txt"
484 # Запуск Scilab'а в режиме отладки
485 scilab -debug ]]></screen>
486         <para></para>
487         <screen><![CDATA[
488 # В GNU/Linux, Mac OS X или Unix:
489 $ echo "disp(%pi)"|scilab-cli
490 или
491 $ echo "disp(%pi)"|scilab -nwni
492
493 # Открыть только окно справки Scilab:
494 $ scilab-adv-cli -e "help()"
495 или
496 $ scilab -nw -e "help()"
497
498
499 # Scilab может быть использован написания сценариев:
500 echo "if 1&lt;>2 then exit(99) end"|scilab-cli
501 echo $? ]]></screen>
502     </refsection>
503     <refsection role="see also">
504         <title>Смотрите также</title>
505         <simplelist type="inline">
506             <member>
507                 <link linkend="startup">начальный запуск</link>
508             </member>
509             <member>
510                 <link linkend="sciargs">sciargs</link>
511             </member>
512             <member>
513                 <link linkend="getpid">getpid</link>
514             </member>
515             <member>
516                 <link linkend="getenv">getenv</link>
517             </member>
518             <member>
519                 <link linkend="getversion">getversion</link>
520             </member>
521             <member>
522                 <link linkend="consolebox">consolebox</link>
523             </member>
524             <member>
525                 <link linkend="exit">exit</link>
526             </member>
527         </simplelist>
528     </refsection>
529     <refsection role="history">
530         <title>История</title>
531         <revhistory>
532             <revision>
533                 <revnumber>5.4.0</revnumber>
534                 <revremark>добавлено -noatomsautoload.</revremark>
535             </revision>
536             <revision>
537                 <revnumber>5.4.1</revnumber>
538                 <revremark>
539                     введены отдельные сценарии scinotes и xcos.
540                     См.SEP #87.
541                 </revremark>
542             </revision>
543             <revision>
544                 <revnumber>6.0.0</revnumber>
545                 <revremark>
546                     Добавлена опция <literal>-quit</literal>. Опция <literal>-mem</literal> удалена.
547                 </revremark>
548             </revision>
549             <revision>
550                 <revnumber>6.0.1</revnumber>
551                 <revremark>
552                     <literal>-scihome</literal> option added.
553                 </revremark>
554             </revision>
555         </revhistory>
556     </refsection>
557 </refentry>