[doc] misc fix & improvements
[scilab.git] / scilab / modules / development_tools / help / ja_JP / example_run.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2012 - Scilab Enterprises - Vincent COUVERT
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
19           xmlns:scilab="http://www.scilab.org" xml:id="example_run" xml:lang="ja">
20     <refnamediv>
21         <refname>example_run</refname>
22         <refpurpose>ヘルプページで見つかった例を実行.</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>呼び出し手順</title>
26         <synopsis>
27             example_run()
28             example_run(moduleNames)
29             example_run(moduleNames, functionNames)
30             example_run(moduleNames, functionNames, language)
31             example_run(moduleNames, functionNames, language, testrunOptions, testrunExportToFile)
32         </synopsis>
33     </refsynopsisdiv>
34     <refsection>
35         <title>引数</title>
36         <variablelist>
37             <varlistentry>
38                 <term>moduleNames</term>
39                 <listitem>
40                     <para>
41                         a string or a vector of strings: references of the modules to test.
42                         Each reference can be either of
43                         <itemizedlist>
44                             <listitem>
45                                 the technical name of a Scilab internal module, that is the name
46                                 of the root directory of the module.
47                             </listitem>
48                             <listitem>
49                                 the relative or absolute path of the root directory of the module.
50                                 This must be used for installed ATOMS modules or other external modules.
51                             </listitem>
52                         </itemizedlist>
53                         By default, all Scilab internal modules are considered, as returned by
54                         <link linkend="getmodules">getmodules()</link>.
55                     </para>
56                     <para>
57                         The root directory of each targeted module must have a
58                         <literal>./help</literal> subdirectory containing the XML source files of
59                         help pages where examples to test are provided, gathered by languages as
60                         in the source package of any standard module.
61                         Example of the template toolbox_skeleton module:
62                         <programlisting role="example">
63 unix_w("dir /b /s """ + WSCI + "/contrib/toolbox_skeleton/help""")
64                       </programlisting>
65                     </para>
66                 </listitem>
67             </varlistentry>
68             <varlistentry>
69                 <term>functionNames</term>
70                 <listitem>
71                     <para>文字列または文字列ベクトル:
72                         テストする関数の名前. 指定されないアバイ,
73                         モジュールの全てのヘルプページがテストされます.
74                     </para>
75                 </listitem>
76             </varlistentry>
77             <varlistentry>
78                 <term>language</term>
79                 <listitem>
80                     <para>文字列: テストするヘルプページの言語. デフォルト値は "en_US"です.</para>
81                 </listitem>
82             </varlistentry>
83             <varlistentry>
84                 <term>testrunOptions</term>
85                 <listitem>
86                     <para>
87                         <link linkend="test_run">test_run</link>の第3引数として使用.
88                     </para>
89                 </listitem>
90             </varlistentry>
91             <varlistentry>
92                 <term>testrunExportToFile</term>
93                 <listitem>
94                     <para>
95                         <link linkend="test_run">test_run</link>の第4引数として使用.
96                     </para>
97                 </listitem>
98             </varlistentry>
99         </variablelist>
100     </refsection>
101     <refsection>
102         <title>説明</title>
103         <para>
104             この巻数は,ヘルプページで指定した例を展開し,
105             <link linkend="test_run">test_run</link>により実行します.
106         </para>
107         <para>
108            <warning>
109                When testing examples of any external module, it is mandatory to autoload the module
110                at Scilab startup. This can be achieved either by setting the ATOMS module as
111                autoloaded, or by loading the module through the user's startup file.
112            </warning>
113         </para>
114     </refsection>
115     <refsection>
116         <title>例</title>
117         <programlisting role="example"><![CDATA[
118 if ~isempty(ls("SCI/modules/xml/help/en_US/*.xml")) then // この例のXMLソースが存在する必要があります
119     example_run("xml")
120     example_run("elementary_functions", "insertion")
121     example_run("elementary_functions", ["insertion"; "extraction"])
122     example_run("elementary_functions", "insertion", "en_US")
123 end
124  ]]></programlisting>
125     </refsection>
126     <refsection role="see also">
127         <title>参照</title>
128         <simplelist type="inline">
129             <member>
130                 <link linkend="test_run">test_run</link>
131             </member>
132             <member>
133                 <link linkend="bench_run">bench_run</link>
134             </member>
135             <member>
136                 <link linkend="atomsAutoloadAdd">atomsAutoloadAdd</link>
137             </member>
138             <member>
139                 <link linkend="startup">startup</link>
140             </member>
141         </simplelist>
142     </refsection>
143     <refsection>
144         <title>履歴</title>
145         <revhistory>
146             <revision>
147                 <revnumber>5.4.0</revnumber>
148                 <revremark>関数example_runが導入されました.</revremark>
149             </revision>
150         </revhistory>
151     </refsection>
152 </refentry>