886a72cce2e86942fab49cdb5d105552f3dff271
[scilab.git] / scilab / modules / core / help / ja_JP / scilab.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <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="ja">
4     
5     <refnamediv>
6         
7         <refname>scilab</refname>
8         
9         <refpurpose>
10             
11             Scilabおよび関連ツールを起動するためのツール
12             
13             (GNU/Linux, Unix および Mac OS X)
14             
15         </refpurpose>
16         
17     </refnamediv>
18     
19     <refsynopsisdiv>
20         
21         <title>呼出し手順</title>
22         
23         <synopsis>scilab &lt;Options&gt;
24             
25             scilab-adv-cli &lt;Options&gt;
26             
27             scilab-cli &lt;Options&gt;
28             
29         </synopsis>
30         
31     </refsynopsisdiv>
32     
33     <refsection>
34         
35         <title>説明</title>
36         
37         <variablelist>
38             
39             <varlistentry>
40                 
41                 <term>-args Arguments</term>
42                 
43                 <listitem>
44                     
45                     <para>
46                         
47                         このオプションが存在する場合,引数がScilabに渡されます.
48                         
49                         これらは,<link linkend="sciargs">sciargs</link>関数で取得することが
50                         
51                         できます.
52                         
53                         複数の引数を指定する場合,以下のように一連の複数の単語を引用符で括り,
54                         
55                         空白で分割してください: <literal>scilab -args 'foo1 foo2'</literal>. 
56                         
57                         このオプションを指定しない場合,未知の引数は受け付けられません.
58                         
59                     </para>
60                     
61                 </listitem>
62                 
63             </varlistentry>
64             
65             <varlistentry>
66                 
67                 <term>-display Display</term>
68                 
69                 <listitem>
70                     
71                     <para>
72                         
73                         Xwindow システム上でのみ使用可能で, 表示する
74                         
75                         Xサーバーを指定します.
76                         
77                         デフォルトの表示先は unix:0.0 です.
78                         
79                     </para>
80                     
81                     <para>
82                         
83                         <literal>-display</literal> は,
84                         
85                         <literal>-d</literal>と短縮形で指定できます.
86                         
87                     </para>
88                     
89                 </listitem>
90                 
91             </varlistentry>
92             
93             <varlistentry>
94                 
95                 <term>-debug</term>
96                 
97                 <listitem>
98                     
99                     <para>デバッガgdb上でScilabを開始します(Unix/Linux/Mac OS Xのみ).</para>
100                     
101                     <para>
102                         
103                         gdb にカスタムオプションを追加する場合,
104                         
105                         変数<literal>SCILAB_GDB_OPT</literal>を定義します.
106                         
107                     </para>
108                     
109                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
110                     
111                 </listitem>
112                 
113             </varlistentry>
114             
115             <varlistentry>
116                 
117                 <term>-debug-kdbg</term>
118                 
119                 <listitem>
120                     
121                     <para>kdbg上でScilabを開始します (Unix/Linux/Mac OS X のみ).</para>
122                     
123                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
124                     
125                 </listitem>
126                 
127             </varlistentry>
128             
129             <varlistentry>
130                 
131                 <term>-profiling</term>
132                 
133                 <listitem>
134                     
135                     <para>valgrind上でScilabを開始します (Unix/Linux/Mac OS X のみ).</para>
136                     
137                     <para>
138                         
139                         valgrind にカスタムオプションを追加する場合
140                         
141                         (および既存の valgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
142                         
143                         を定義してください.
144                         
145                     </para>
146                     
147                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
148                     
149                 </listitem>
150                 
151             </varlistentry>
152             
153             <varlistentry>
154                 
155                 <term>-profiling-visu</term>
156                 
157                 <listitem>
158                     
159                     <para>callgrind上でScilabを開始します (Unix/Linux/Mac OS X のみ).</para>
160                     
161                     <para>
162                         
163                         callgrind にカスタムオプションを追加する場合
164                         
165                         (および既存の callgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
166                         
167                         を定義してください.
168                         
169                     </para>
170                     
171                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
172                     
173                 </listitem>
174                 
175             </varlistentry>
176             
177             <varlistentry>
178                 
179                 <term>-electric-fence</term>
180                 
181                 <listitem>
182                     
183                     <para>Electric Fence を指定して Scilab を開始します(Unix/Linux/Mac OS Xのみ).</para>
184                     
185                     <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
186                     
187                 </listitem>
188                 
189             </varlistentry>
190             
191             <varlistentry>
192                 
193                 <term>-e 命令</term>
194                 
195                 <listitem>
196                     
197                     <para>
198                         
199                         このオプションを指定すると Scilab 命令
200                         
201                         <literal>Instruction</literal> が(スタートアップファイルの実行直後に)
202                         
203                         まずScilabで実行されます.
204                         
205                         <literal>-e</literal> および
206                         
207                         <literal>-f</literal> オプションは相互に排他的です.
208                         
209                     </para>
210                     
211                     <para>
212                         <literal>-e</literal>により複数の命令を指定できることに注意してください.
213                     </para>
214                     
215                     <programlisting role="no-scilab-exec">scilab-cli -e  "a=1+%i; aPlusPi=a+%pi; disp(aPlusPi);exit;" -nb</programlisting>
216                     
217                 </listitem>
218                 
219             </varlistentry>
220             
221             <varlistentry>
222                 
223                 <term>-f file</term>
224                 
225                 <listitem>
226                     
227                     <para>
228                         
229                         このオプションを指定すると, Scilab はスクリプト <literal>file</literal>
230                         
231                         を(スタートアップファイルの実行直後,)Scilab上で最初に実行します.
232                         
233                         
234                         
235                         <literal>-e</literal> および
236                         
237                         <literal>-f</literal> オプションは相互に排他的です.
238                         
239                     </para>
240                     
241                     <para>.xcos 拡張子を有するファイルはXcosで開かれます.</para>
242                     
243                 </listitem>
244                 
245             </varlistentry>
246             
247             <varlistentry>
248                 
249                 <term>-l lang</term>
250                 
251                 <listitem>
252                     
253                     <para>このオプションを指定した場合,
254                         
255                         ユーザ言語を指定します.
256                         
257                         <emphasis>lang</emphasis> は以下の値を指定できます: <emphasis>ca_ES de_DE en_US es_ES
258                             
259                             fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW
260                             
261                         </emphasis>
262                         
263                         (Scilab 5.2以降).
264                         
265                     </para>
266                     
267                     <para>
268                         
269                         互換性維持のため,その他に <literal>lang</literal> の値は,フランス語として
270                         
271                         <literal>'fr'</literal> および英語として <literal>'en'</literal> を使用可能です.
272                         
273                         デフォルト値は,<literal>scilab.start</literal>ファイルで指定されます.
274                         
275                     </para>
276                     
277                     <para>いくつかのシステムでは,UTF-8フォントを正しく描画するために,
278                         
279                         ロケールをコンパイルする必要があります.
280                         
281                     </para>
282                     
283                     <para>Scilab を以下のようにコールすることも可能です:</para>
284                     
285                     <programlisting role="no-scilab-exec">LANG=ja_JP scilab
286                         
287                         # これは以下と等価です
288                         
289                         scilab -l ja_JP
290                         
291                     </programlisting>
292                     
293                 </listitem>
294                 
295             </varlistentry>
296             
297             <varlistentry>
298                 
299                 <term>-nb</term>
300                 
301                 <listitem>
302                     
303                     <para>
304                         
305                         このオプションが指定された場合, Scilabの Welcome バナーは表示されません.
306                         
307                     </para>
308                     
309                 </listitem>
310                 
311             </varlistentry>
312             
313             <varlistentry>
314                 
315                 <term>-ns</term>
316                 
317                 <listitem>
318                     
319                     <para>
320                         
321                         このオプションが指定された場合, スタートアップファイル
322                         
323                         <literal>SCI/etc/scilab.start</literal> およびユーザスタートアップファイル
324                         
325                         <literal>SCIHOME/.scilab</literal>,
326                         
327                         <literal>SCIHOME/scilab.ini</literal> は実行されません.
328                         
329                     </para>
330                     
331                     <para>このオプションは, Scilabの多くの機能を無効にします (動作を理解している場合のみ
332                         
333                         使用してください).
334                         
335                     </para>
336                     
337                 </listitem>
338                 
339             </varlistentry>
340             
341             <varlistentry>
342                 
343                 <term>-nouserstartup</term>
344                 
345                 <listitem>
346                     
347                     <para>このオプションが指定された場合, スタートアップファイル
348                         
349                         <literal>SCIHOME/.scilab</literal>,
350                         
351                         <literal>SCIHOME/scilab.ini</literal> は実行されません.
352                         
353                     </para>
354                     
355                 </listitem>
356                 
357             </varlistentry>
358             
359             <varlistentry>
360                 
361                 <term>-noatomsautoload</term>
362                 
363                 <listitem>
364                     
365                     <para>
366                         
367                         このオプションが指定された場合,イントール済みのATOMモジュールは
368                         
369                         このセッションでロードされません.
370                         
371                     </para>
372                     
373                 </listitem>
374                 
375             </varlistentry>
376             
377             <varlistentry>
378                 
379                 <term>-nw</term>
380                 
381                 <listitem>
382                     
383                     <para>
384                         
385                         このオプションが指定された場合, Scilab は
386                         
387                         先進的な機能(グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)
388                         
389                         と共にコマンドラインで起動されます.
390                         
391                     </para>
392                     
393                     <para>
394                         このオプションは <literal>-f</literal>または <literal>-e</literal>
395                         
396                         オプションと同時に指定することができます.
397                     </para>
398                     
399                     <para>Scilab 5.2以降:</para>
400                     
401                     <itemizedlist>
402                         
403                         <listitem>
404                             
405                             <para>Scilab のディストリビューションには,
406                                 
407                                 <literal>-nw</literal>と同様のバイナリを提供します: 
408                                 
409                                 <literal>scilab-adv-cli</literal>
410                                 
411                                 (Scilab Advanced Command Line Interpreter).
412                                 
413                             </para>
414                             
415                         </listitem>
416                         
417                         <listitem>
418                             
419                             <para>全てのオペレーティングシステムについて
420                                 
421                                 パイプが有効です (詳細については例を参照ください).
422                                 
423                             </para>
424                             
425                         </listitem>
426                         
427                     </itemizedlist>
428                     
429                 </listitem>
430                 
431             </varlistentry>
432             
433             <varlistentry>
434                 
435                 <term>-nwni / -nogui</term>
436                 
437                 <listitem>
438                     
439                     <para>このオプションが指定された場合, Scilab は先進的な機能
440                         
441                         (グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)なしで
442                         
443                         コマンドラインで起動されます.
444                         
445                     </para>
446                     
447                     <para>
448                         このオプションは <literal>-f</literal> または <literal>-e</literal>
449                         
450                         オプションと同時に指定することができます.
451                     </para>
452                     
453                     <para>Scilab 5.2以降:</para>
454                     
455                     <itemizedlist>
456                         
457                         <listitem>
458                             
459                             <para>
460                                 
461                                 Scilab のディストリビューションでは,
462                                 
463                                 <literal>-nwni</literal>と同じ専用バイナリが提供されています
464                                 
465                                 : <literal>scilab-cli</literal>
466                                 
467                                 (Scilab Command Line Interpreter).
468                                 
469                             </para>
470                             
471                         </listitem>
472                         
473                     </itemizedlist>
474                     
475                     <itemizedlist>
476                         
477                         <listitem>
478                             
479                             <para>全てのオペレーティングシステムについて
480                                 
481                                 パイプが有効です (詳細については例を参照ください).
482                                 
483                             </para>
484                             
485                         </listitem>
486                         
487                     </itemizedlist>
488                     
489                     <para>このモードでは Java 仮想マシンはロードされません.
490                         
491                         (起動は高速化され,メモリ消費量は減少します)
492                         
493                     </para>
494                     
495                 </listitem>
496                 
497             </varlistentry>
498             
499             <varlistentry>
500                 
501                 <term>--texmacs</term>
502                 
503                 <listitem>
504                     
505                     <para>このオプションは TeXMacs用に予約されています.</para>
506                     
507                     <para>
508                         
509                         ATOMSモジュールをインストールしてください: <programlisting role="">atomsInstall('texmacs')</programlisting>
510                         
511                     </para>
512                     
513                 </listitem>
514                 
515             </varlistentry>
516             
517             <varlistentry>
518                 
519                 <term>-version</term>
520                 
521                 <listitem>
522                     
523                     <para>このオプションはプロダクトのバージョンを出力し,終了します.</para>
524                     
525                 </listitem>
526                 
527             </varlistentry>
528             
529         </variablelist>
530         
531     </refsection>
532     
533     <refsection>
534         
535         <title>環境変数の説明</title>
536         
537         <variablelist>
538             
539             <varlistentry>
540                 
541                 <term>SCIVERBOSE</term>
542                 
543                 <listitem>
544                     
545                     <para>
546                         
547                         この変数が存在した場合, Scilab起動スクリプトは起動時デバッグ情報を表示します.
548                         
549                         主にバグレポートおよびデバッグ目的で使用されます.
550                         
551                     </para>
552                     
553                 </listitem>
554                 
555             </varlistentry>
556             
557             <varlistentry>
558                 
559                 <term>JAVA_HOME</term>
560                 
561                 <listitem>
562                     
563                     <para>
564                         
565                         使用するJavaを指定します. 例えば,
566                         
567                         <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> は
568                         
569                         Java 7 でScilabを起動します.
570                         
571                     </para>
572                     
573                 </listitem>
574                 
575             </varlistentry>
576             
577             <varlistentry>
578                 
579                 <term>SCI_DISABLE_TK</term>
580                 
581                 <listitem>
582                     
583                     <para>Tk (Tclではなく) 機能を無効にします.</para>
584                     
585                 </listitem>
586                 
587             </varlistentry>
588             
589             <varlistentry>
590                 
591                 <term>SCI_JAVA_ENABLE_HEADLESS</term>
592                 
593                 <listitem>
594                     
595                     <para>
596                         
597                         ヘッドレスJava仮想マシン (すなわち,GUI機能なし).
598                         
599                     </para>
600                     
601                 </listitem>
602                 
603             </varlistentry>
604             
605         </variablelist>
606         
607     </refsection>
608     
609     <refsection>
610         
611         <title>Java 仮想マシンオプション</title>
612         
613         <para>Scilab 5.0以降, グラフィカルユーザインターフェイス (GUI) および
614             
615             ドキュメントの構築は,Java機能に基づいています.
616             
617             いくつかのケースでは,
618             
619             JVM (Java仮想マシン)オプションを編集することが重要となります.
620             
621         </para>
622         
623         <para>これらのオプションは,
624             
625             <emphasis>jvm_options.xml</emphasis>ファイルで利用可能です.
626             
627         </para>
628         
629         <para>5.0.X および 5.1.Xでは, このファイルは
630             
631             <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>に保存されています.
632             
633         </para>
634         
635         <para>&gt;= 5.2.0以降, このファイルは
636             
637             <emphasis>
638                 
639                 etc/jvm_options.xml<emphasis> </emphasis>
640                 
641             </emphasis>
642             
643             にあります.
644             
645         </para>
646         
647         <para>デフォルトで, 以下の3つのオプションが
648             
649             設定ファイルで容易にアクセス可能です:
650             
651         </para>
652         
653         <variablelist>
654             
655             <varlistentry>
656                 
657                 <term>-XmxXXXm</term>
658                 
659                 <listitem>
660                     
661                     <para>
662                         
663                         このオプションは,Java仮想マシンで利用可能なメモリ量を設定します.
664                         
665                         デフォルトで, 256M が確保されます.
666                         
667                         この値を変更した場合, その値がシステムで利用可能なメモリを
668                         
669                         超えないことを確認してください.
670                         
671                     </para>
672                     
673                     <para>
674                         
675                         Scilab 5.4.0以降, この値は設定メニュー内で変更可能です.
676                         
677                     </para>
678                     
679                 </listitem>
680                 
681             </varlistentry>
682             
683             <varlistentry>
684                 
685                 <term>-Djava.compiler=JIT</term>
686                 
687                 <listitem>
688                     
689                     <para>
690                         
691                         このオプションを引数<emphasis>JIT</emphasis>を付けて指定すると,
692                         
693                         Java Just In Time compilerが有効になります.
694                         
695                         このオプションはデフォルトで有効となります.
696                         
697                         <emphasis>NONE</emphasis>によりJITは無効となり,
698                         
699                         著しく性能が低下します.
700                         
701                     </para>
702                     
703                 </listitem>
704                 
705             </varlistentry>
706             
707             <varlistentry>
708                 
709                 <term>-verbose:jni / -Xcheck:jni</term>
710                 
711                 <listitem>
712                     
713                     <para>
714                         
715                         これらのオプションは,JNIコールとその出力をより詳細に確認します.
716                         
717                         デバッグ時にはこれらのオプションを利用可能ですが,
718                         
719                         性能を低下させるためデフォルトでは無効となっています.
720                         
721                     </para>
722                     
723                 </listitem>
724                 
725             </varlistentry>
726             
727         </variablelist>
728         
729         <para>より多くのオプションが利用可能です.
730             
731             これにより性能を改善したり,ルックアンドフィールを変更したり,
732             
733             メモリ管理を変更したりといったことが可能です.
734             
735             参照:  <ulink url="http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html">http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html</ulink>
736             
737         </para>
738         
739     </refsection>
740     
741     <refsection>
742         
743         <title>例</title>
744         
745         <programlisting role="no-scilab-exec"><![CDATA[ 
746 # Let's start Scilab in profiling mode without attaching a gdb once a SIGSEGV is met.
747 # We are under Bash shell
748 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
749 scilab -profiling
750
751 # Let's start Scilab in debug mode without stopping after each SIGSEGV
752 # First, we write a small command file
753 echo "handle SIGSEGV nostop" &> debug.txt
754 # Now set the custom option
755 # We are under Bash shell
756 export SCILAB_GDB_OPT="--command=debug.txt"
757 # Start Scilab in debug mode
758 scilab -debug]]></programlisting>
759         
760         <programlisting role="no-scilab-exec"><![CDATA[
761 # Under GNU/Linux, Mac OS X or Unix:
762 $ echo "disp(%pi)"|scilab-cli
763 or
764 $ echo "disp(%pi)"|scilab -nwni
765
766 # Only open the Scilab help window:
767 $ scilab-adv-cli -e "help()"
768 or
769 $ scilab -nw -e "help()"
770
771
772 # Scilab can be used for scripting aspects:
773 echo "if 1<>2 then exit(99) end"|scilab-cli
774 echo $? ]]></programlisting>
775         
776     </refsection>
777     
778     <refsection role="see also">
779         
780         <title>参照</title>
781         
782         <simplelist type="inline">
783             
784             <member>
785                 
786                 <link linkend="exit">exit</link>
787                 
788             </member>
789             
790             <member>
791                 
792                 <link linkend="startup">startup</link>
793                 
794             </member>
795             
796         </simplelist>
797         
798     </refsection>
799     
800     <refsection>
801         
802         <title>履歴</title>
803         
804         <revhistory>
805             
806             <revision>
807                 
808                 <revnumber>5.4.0</revnumber>
809                 
810                 <revremark>-noatomsautoload が追加されました.</revremark>
811                 
812             </revision>
813             
814             <revision>
815                 
816                 <revnumber>5.4.1</revnumber>
817                 
818                 <revremark>scinotes と xcos 個別スクリプトが導入されました. SEP #87参照.</revremark>
819                 
820             </revision>
821             
822         </revhistory>
823         
824     </refsection>
825     
826 </refentry>
827