コミットメタ情報

リビジョンe7103552ee18c91772b5e00b562fc7708d255968 (tree)
日時2013-12-20 20:43:26
作者argius <argius.net@gmai...>
コミッターargius

ログメッセージ

Update MANUAL*

変更サマリ

差分

--- a/MANUAL.html
+++ b/MANUAL.html
@@ -12,7 +12,7 @@
1212 <body>
1313 <header>
1414 <h1 class="title">Stew4 User Manual</h1>
15-<h3 class="date">version 4.0</h3>
15+<h3 class="date">version 4.1</h3>
1616 </header>
1717 <nav id="TOC">
1818 <ul>
@@ -40,7 +40,7 @@
4040 <li><a href="#rollback---rollbacks-current-transaction-built-in">rollback - Rollbacks current transaction (built-in)</a></li>
4141 <li><a href="#e---evaluates-multiple-commands-built-in">-e - Evaluates multiple commands (built-in)</a></li>
4242 <li><a href="#f---executes-file-content-as-command-built-in">-f - Executes file content as command (built-in)</a></li>
43-<li><a href="#s---executes-file-content-as-script-built-in">-s - Executes file content as script (built-in)</a></li>
43+<li><a href="#s---executes-file-content-as-script-built-in-improved-feature-in-version-4.1">-s - Executes file content as script (built-in) &lt;improved feature in version 4.1&gt;</a></li>
4444 <li><a href="#cd---changes-current-directory-built-in">cd - Changes current directory (built-in)</a></li>
4545 <li><a href="#displays-directories-built-in">@ - Displays directories (built-in)</a></li>
4646 <li><a href="#displays-system-properties-built-in">? - Displays System Properties (built-in)</a></li>
@@ -117,18 +117,20 @@
117117 </ul>
118118 </nav>
119119 <h2 id="what-is-stew"><a href="#TOC">What Is Stew ?</a></h2>
120-<p>...</p>
120+<p>Stew is the database (SQL) tool with JDBC.</p>
121+<p>For details, see &quot;README.md&quot;.</p>
121122 <h2 id="precautions"><a href="#TOC">PRECAUTIONS</a></h2>
122123 <h3 id="password-management"><a href="#TOC">Password Management</a></h3>
123-<p>...</p>
124-<p>For details, see <a href="#Connector-Settings">How To Use - Connector Settings</a>.</p>
124+<p>By defaults, passwords are not encrypted. Setting &quot;Encryption&quot; in the connector will encrypt the password.</p>
125+<p>For details, see <a href="#configuration-of-connector">How To Use - Configuration Of &quot;Connector&quot;</a>.</p>
125126 <h3 id="rollback-does-not-work-when-the-connection-is-disconnecting"><a href="#TOC">Rollback Does Not Work When The Connection Is Disconnecting</a></h3>
126-<p>...</p>
127-<p>For details, see <a href="#Connector-Settings">How To Use - Connector Settings</a>.</p>
127+<p>By defaults, Rollback does not work automatically on disconnect. You have to care that some of DBMSs commit on disconnect.</p>
128+<p>Setting &quot;Auto Rollback&quot; in the connector will rollback automatically on disconnect.</p>
129+<p>For details, see <a href="#configuration-of-connector">How To Use - Configuration Of &quot;Connector&quot;</a>.</p>
128130 <h3 id="other"><a href="#TOC">Other</a></h3>
129131 <p>For more information, see the project site. <a href="http://stew.sourceforge.jp/"><code class="url">http://stew.sourceforge.jp/</code></a></p>
130132 <h2 id="installation"><a href="#TOC">Installation</a></h2>
131-<p>...</p>
133+<p>Just extract the package archive file.</p>
132134 <h2 id="running-app"><a href="#TOC">Running App</a></h2>
133135 <p>If you want to use GUI mode, execute the following command:</p>
134136 <pre><code>&gt; java -jar stew.jar --gui</code></pre>
@@ -220,14 +222,21 @@ $ stew --edit
220222 <h3 id="f---executes-file-content-as-command-built-in"><a href="#TOC">-f - Executes file content as command (built-in)</a></h3>
221223 <pre><code>&gt; -f &lt;file&gt;</code></pre>
222224 <p>...</p>
223-<h3 id="s---executes-file-content-as-script-built-in"><a href="#TOC">-s - Executes file content as script (built-in)</a></h3>
224-<pre><code>&gt; -s &lt;file&gt;</code></pre>
225-<p>( default=JavaScript )</p>
226-<p>The following variables will be available in the script:</p>
225+<h3 id="s---executes-file-content-as-script-built-in-improved-feature-in-version-4.1"><a href="#TOC">-s - Executes file content as script (built-in) &lt;improved feature in version 4.1&gt;</a></h3>
226+<pre><code>&gt; -s . | &lt;SCRIPT FILE&gt; | &lt;SCRIPT-NAME&gt; &lt;SCRIPT-CODE&gt;</code></pre>
227+<ol type="1">
228+<li>If the first argument is &quot;.&quot;, the Script Context is reset.</li>
229+<li>If the first argument is a filename with extension, the script language is identified by the extension, and the file is run as the script language's script.</li>
230+<li>Otherwise, the first argument is recognized as the name of a script language, and the rest of arguments are executed as the script language's script.</li>
231+</ol>
232+<p>(Only the built-in JavaScript by file is supported in version 4.0.)</p>
233+<p>To use script languages except the built-in script language (JavaScript), it requires each script engine of script languages such as jruby, jython and groovy.</p>
234+<p>The Script Context keeps global scope bindings, and following scripts can reuse the bindings. If you want to reset Script Context, input &quot; -s . &quot; above.</p>
235+<p>The following variables will be available in the script (global scope):</p>
227236 <ul>
228-<li>object of current connection: connection, conn</li>
229-<li>object of Parameter: parameter, p</li>
230-<li>object of OutputProcessor: outputProcessor, op</li>
237+<li>the reference of current connection: connection, conn</li>
238+<li>the reference of Parameter: parameter, p</li>
239+<li>the reference of OutputProcessor: outputProcessor, op</li>
231240 </ul>
232241 <h3 id="cd---changes-current-directory-built-in"><a href="#TOC">cd - Changes current directory (built-in)</a></h3>
233242 <pre><code>&gt; cd &lt;directory&gt;</code></pre>
--- a/MANUAL.md
+++ b/MANUAL.md
@@ -1,30 +1,33 @@
11 % Stew4 User Manual
22 %
3-% version 4.0
3+% version 4.1
44
55
66 ## What Is Stew ?
77
8-...
8+Stew is the database (SQL) tool with JDBC.
9+
10+For details, see "README.md".
911
1012
1113 ## PRECAUTIONS
1214
1315 ### Password Management
1416
15-...
16-
17+By defaults, passwords are not encrypted.
18+Setting "Encryption" in the connector will encrypt the password.
1719
18-For details, see [How To Use - Connector Settings](#Connector-Settings).
20+For details, see [How To Use - Configuration Of "Connector"](#configuration-of-connector).
1921
2022
2123 ### Rollback Does Not Work When The Connection Is Disconnecting
2224
25+By defaults, Rollback does not work automatically on disconnect.
26+You have to care that some of DBMSs commit on disconnect.
2327
24-...
25-
28+Setting "Auto Rollback" in the connector will rollback automatically on disconnect.
2629
27-For details, see [How To Use - Connector Settings](#Connector-Settings).
30+For details, see [How To Use - Configuration Of "Connector"](#configuration-of-connector).
2831
2932
3033 ### Other
@@ -35,9 +38,7 @@ For more information, see the project site.
3538
3639 ## Installation
3740
38-
39-...
40-
41+Just extract the package archive file.
4142
4243
4344 ## Running App
@@ -182,17 +183,27 @@ For example, you can execute two export command continuously,
182183 ...
183184
184185
185-### -s - Executes file content as script (built-in)
186+### -s - Executes file content as script (built-in) \<improved feature in version 4.1\>
187+
188+ > -s . | <SCRIPT FILE> | <SCRIPT-NAME> <SCRIPT-CODE>
189+
190+ 1. If the first argument is ".", the Script Context is reset.
191+ 2. If the first argument is a filename with extension, the script language is identified by the extension, and the file is run as the script language's script.
192+ 3. Otherwise, the first argument is recognized as the name of a script language, and the rest of arguments are executed as the script language's script.
193+
194+(Only the built-in JavaScript by file is supported in version 4.0.)
195+
196+To use script languages except the built-in script language (JavaScript), it requires each script engine of script languages such as jruby, jython and groovy.
186197
187- > -s <file>
198+The Script Context keeps global scope bindings, and following scripts can reuse the bindings.
199+If you want to reset Script Context, input " -s . " above.
188200
189-( default=JavaScript )
190201
191-The following variables will be available in the script:
202+The following variables will be available in the script (global scope):
192203
193- * object of current connection: connection, conn
194- * object of Parameter: parameter, p
195- * object of OutputProcessor: outputProcessor, op
204+ * the reference of current connection: connection, conn
205+ * the reference of Parameter: parameter, p
206+ * the reference of OutputProcessor: outputProcessor, op
196207
197208
198209 ### cd - Changes current directory (built-in)
@@ -223,9 +234,9 @@ By defauts, it displays JRE, OS and Locale.
223234 OS : ...
224235 Locale : ja_JP
225236 > ? java.version user.timezone zzz
226- java.version=[1.6.0_##]
227- user.timezone=[Europe/London]
228- zzz=undefined
237+ java.version=[1.6.0_##]
238+ user.timezone=[Europe/London]
239+ zzz=undefined
229240
230241
231242 ### alias - Registers alias (built-in)
@@ -507,7 +518,7 @@ just connected: connector as a root node and sub nodes ...
507518 Each node expands ...
508519
509520
510-An "Auto-expansion" is a function to automatically expands nodes in the database info tree when connecting a database.
521+An "Auto-expansion" is a function to automatically expands nodes in the database info tree when connecting a database.
511522 If you use it, create a TSV file named "autoexpansion.tsv" in the system directory (.stew) and write node name lists as TSV into this file.
512523
513524
--- a/MANUAL_ja.html
+++ b/MANUAL_ja.html
@@ -12,7 +12,7 @@
1212 <body>
1313 <header>
1414 <h1 class="title">Stew4 ユーザーマニュアル</h1>
15-<h3 class="date">version 4.0</h3>
15+<h3 class="date">version 4.1</h3>
1616 </header>
1717 <nav id="TOC">
1818 <ul>
@@ -40,7 +40,7 @@
4040 <li><a href="#rollback---トランザクションのロールバック-組み込みコマンド">rollback - トランザクションのロールバック (組み込みコマンド)</a></li>
4141 <li><a href="#e---複数コマンドの評価-組み込みコマンド">-e - 複数コマンドの評価 (組み込みコマンド)</a></li>
4242 <li><a href="#f---ファイル内容をコマンドとして実行-組み込みコマンド">-f - ファイル内容をコマンドとして実行 (組み込みコマンド)</a></li>
43-<li><a href="#s---ファイル内容をスクリプトとして実行-組み込みコマンド">-s - ファイル内容をスクリプトとして実行 (組み込みコマンド)</a></li>
43+<li><a href="#s---スクリプトとして実行-組み込みコマンド-バージョン4.1の更新機能">-s - スクリプトとして実行 (組み込みコマンド) &lt;バージョン4.1の更新機能&gt;</a></li>
4444 <li><a href="#cd---カレントディレクトリの移動-組み込みコマンド">cd - カレントディレクトリの移動 (組み込みコマンド)</a></li>
4545 <li><a href="#場所の表示-組み込みコマンド">@ - 場所の表示 (組み込みコマンド)</a></li>
4646 <li><a href="#システムプロパティ-組み込みコマンド">? - システムプロパティ (組み込みコマンド)</a></li>
@@ -237,9 +237,15 @@
237237 <h3 id="f---ファイル内容をコマンドとして実行-組み込みコマンド"><a href="#TOC">-f - ファイル内容をコマンドとして実行 (組み込みコマンド)</a></h3>
238238 <pre><code>&gt; -f &lt;ファイル&gt;</code></pre>
239239 <p>ファイルの内容をコマンドとして実行します。 再帰的に指定できますが、無限ループは検知できないので注意してください。</p>
240-<h3 id="s---ファイル内容をスクリプトとして実行-組み込みコマンド"><a href="#TOC">-s - ファイル内容をスクリプトとして実行 (組み込みコマンド)</a></h3>
241-<pre><code>&gt; -s &lt;ファイル&gt;</code></pre>
242-<p>ファイルの内容をスクリプト(JavaScript)として実行します。</p>
240+<h3 id="s---スクリプトとして実行-組み込みコマンド-バージョン4.1の更新機能"><a href="#TOC">-s - スクリプトとして実行 (組み込みコマンド) &lt;バージョン4.1の更新機能&gt;</a></h3>
241+<pre><code>&gt; -s . | &lt;スクリプトファイル&gt; | &lt;スクリプト言語名&gt; &lt;スクリプトコード&gt;</code></pre>
242+<ol type="1">
243+<li>最初の引数が&quot;.&quot;(ピリオド)の場合、スクリプトコンテキストはリセットされます。</li>
244+<li>最初の引数が拡張子付きのファイル名の場合、拡張子でスクリプト言語を特定し、ファイルをそのスクリプト言語のスクリプトファイルとして実行します。</li>
245+<li>それ以外の場合、最初の引数はスクリプト言語名として認識され、残りの引数はそのスクリプト言語のスクリプトコードとして実行されます。</li>
246+</ol>
247+<p>組み込み(JavaScript)以外のスクリプト言語を使うには、JRuby、Jython、Groovyなど、言語ごとのスクリプトエンジンが必要です。</p>
248+<p>スクリプトコンテキストは、グローバルスコープのバインディング(すなわちグローバル変数)を保持します。 スクリプトコンテキストをリセットしたい場合は、前述のとおり、&quot; -s . &quot;を入力します。</p>
243249 <p>スクリプト内では、以下の変数が定義済みになります。</p>
244250 <ul>
245251 <li>接続中のコネクション: connection, conn</li>
--- a/MANUAL_ja.md
+++ b/MANUAL_ja.md
@@ -1,6 +1,6 @@
11 % Stew4 ユーザーマニュアル
22 %
3-% version 4.0
3+% version 4.1
44
55
66 ## Stewとは何ですか?
@@ -266,11 +266,18 @@ exportなどを同時に実行する場合や、コマンドラインからの
266266 再帰的に指定できますが、無限ループは検知できないので注意してください。
267267
268268
269-### -s - ファイル内容をスクリプトとして実行 (組み込みコマンド)
269+### -s - スクリプトとして実行 (組み込みコマンド) \<バージョン4.1の更新機能>
270270
271- > -s <ファイル>
271+ > -s . | <スクリプトファイル> | <スクリプト言語名> <スクリプトコード>
272272
273-ファイルの内容をスクリプト(JavaScript)として実行します。
273+ 1. 最初の引数が"."(ピリオド)の場合、スクリプトコンテキストはリセットされます。
274+ 2. 最初の引数が拡張子付きのファイル名の場合、拡張子でスクリプト言語を特定し、ファイルをそのスクリプト言語のスクリプトファイルとして実行します。
275+ 3. それ以外の場合、最初の引数はスクリプト言語名として認識され、残りの引数はそのスクリプト言語のスクリプトコードとして実行されます。
276+
277+組み込み(JavaScript)以外のスクリプト言語を使うには、JRuby、Jython、Groovyなど、言語ごとのスクリプトエンジンが必要です。
278+
279+スクリプトコンテキストは、グローバルスコープのバインディング(すなわちグローバル変数)を保持します。
280+スクリプトコンテキストをリセットしたい場合は、前述のとおり、" -s . "を入力します。
274281
275282 スクリプト内では、以下の変数が定義済みになります。
276283
@@ -307,9 +314,9 @@ exportなどを同時に実行する場合や、コマンドラインからの
307314 OS : ...
308315 Locale : ja_JP
309316 > ? java.version user.timezone zzz
310- java.version=[1.6.0_##]
311- user.timezone=[Asia/Tokyo]
312- zzz=undefined
317+ java.version=[1.6.0_##]
318+ user.timezone=[Asia/Tokyo]
319+ zzz=undefined
313320
314321
315322 ### alias - エイリアス(コマンド別名)の登録 (組み込みコマンド)
旧リポジトリブラウザで表示