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