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