[ruby-list:21466] Re: raise non-Exception object

小宮＠自己レスです。

> 
> それと、買って出ていおいて言うのも何ですが、格別英語に自信があるわけでは
> ありません。あしからず。
> 

とうわけで、すぎむしさんに添削していただいた分をとりこんで差分を作りなお
しました。その他、日本語と英語の差が縮まるように多少いじりました。

全部まとめて送りなおしますので、差し支えなければこちらをお使いください。
(今回のものを使うと[ruby-list:21397]と[ruby-list:21421]の分は不要になり
ます。)

小宮
[e-mail]


*** ruby-man-1.4-jp-dist/Exception.html	Fri Oct 15 03:41:14 1999
--- ruby-man-1.4-jp/Exception.html	Tue Mar 14 01:54:39 2000
***************
*** 29,39 ****
--- 29,45 ----
        <dt><h2>クラスメソッド:</h2>
        <dd>
        <dl compact>
+ 	<dt><a name="class_exception">
+ 	    <code>exception([<var>error_message</var> = ""])</code></a></dt>
  	<dt><a name="new"><code>new([<var>error_message</var> = ""])</code></a></dt>
  	<dd>
  	  <p>引数としてエラーメッセージを表す文字列を与えることができます．
  	    このメッセージはデフォルトの例外ハンドラで表示されます．
  	  </p>
+ 	  <p>
+ 	    <code>exception</code>は<a href="function.html#raise"><code>raise</code></a>
+             の内部で使われています．
+ 	  </p>
  	</dd>
        </dl>
        <dt><h2>メソッド:</h2>
***************
*** 50,55 ****
--- 56,69 ----
  	      </dl>
  	      という形式(デフォルトでは)の<code>String</code>の配列です．</p>
  	  </dd>
+ 	  <dt><a name="exception"><code>exception</code></a></dt>
+ 	  <dd>
+ 	    <p>
+ 	    <code>self</code>を返します．このメソッドは<a
+ 	    href="function.html#raise"><code>raise</code></a>内部で使われ
+ 	    ています．
+ 	    </p>
+ 	  </dd>
  	  <dt><a name="message"><code>message</code></a></dt>
  	  <dt><a name="to_s"><code>to_s</code></a></dt>
  	  <dt><a name="to_str"><code>to_str</code></a></dt>
***************
*** 96,102 ****
        <dt><h1><a name="SignalException">SignalException</a></h1>
        <dd>
  	<p><code>signal(2)</code>を受け取ったときに発生します．
! 	<code>rescue</code>で捕捉できません．</p>
        <dt><h2>スーパークラス:</h2>
        <dd> 
  	<dl>
--- 110,116 ----
        <dt><h1><a name="SignalException">SignalException</a></h1>
        <dd>
  	<p><code>signal(2)</code>を受け取ったときに発生します．
! 	</p>
        <dt><h2>スーパークラス:</h2>
        <dd> 
  	<dl>

*** ruby-man-1.4-jp-dist/function.html	Wed Dec  8 17:39:38 1999
--- ruby-man-1.4-jp/function.html	Thu Mar 16 02:09:20 2000
***************
*** 485,490 ****
--- 485,497 ----
  ます．
  </P>
  <p>
+ 第一引数が例外クラスや例外オブジェクトでない場合，実際に発生す
+ る例外はそのクラスやオブジェクトの<code>exception</code>メソッ
+ ドを呼びだして決められます(ただし，第二の形式で引数が文字列の
+ 場合は除きます)．<Code>exception</Code>メソッドはそのクラスや
+ オブジェクトを例外として表現した値を返す必要があります．
+ </p>
+ <p>
  <code>raise</code> には <code>fail</code> という別名が定義さ
  れています．
  </p>

*** ruby-man-1.4-jp-dist/syntax.html	Wed Dec  8 10:01:05 1999
--- ruby-man-1.4-jp/syntax.html	Thu Mar 16 01:50:26 2000
***************
*** 1671,1676 ****
--- 1671,1683 ----
  ます．
  </P>
  <p>
+ 第一引数が例外クラスや例外オブジェクトでない場合，実際に発生す
+ る例外はそのクラスやオブジェクトの<code>exception</code>メソッ
+ ドを呼びだして決められます(ただし，第二の形式で引数が文字列の
+ 場合は除きます)．<Code>exception</Code>メソッドはそのクラスや
+ オブジェクトを例外として表現した値を返す必要があります．
+ </p>
+ <p>
  <code>raise</code> は Ruby の予約語ではなく，<a href="Kernel.html">
  <code>Kernel</code></a> モジュールで定義されている関数的メソッドです．
  <code>raise</code> には <code>fail</code> という別名も定義さ

*** ruby-man-1.4-dist/Exception.html	Fri Oct 15 04:24:24 1999
--- ruby-man-1.4/Exception.html	Tue Mar 14 19:41:04 2000
***************
*** 29,40 ****
--- 29,45 ----
        <dt><h2>Class Methods:</h2>
        <dd>
        <dl compact>
+ 	<dt><a name="class_exception"><code>
+ 	      exception([<var>error_message</var> = ""])</code></a></dt>
  	<dt><a name="new"><code>new([<var>error_message</var> = ""])</code></a></dt>
  	<dd>
  	  <p>Creates a new exception object.  The error_message string can be supplied
  	     as the optional argument.  The default exception handler at top leve,
  	     will show this error_message.
  	  </p>
+ 	  <p><code>exception</code> is used internally by <a href="function.html#raise"><code>
+ 		raise</code></a>.
+ 	  </p>
  	</dd>
        </dl>
        <dt><h2>Methods:</h2>
***************
*** 50,55 ****
--- 55,66 ----
  		<dt><code>"#{sourcefile}:#{sourceline}"</code>
  		<dd>(at top level)
  	      </dl>
+ 	  </dd>
+ 	  <dt><a name="exception"><code>exception</code></a></dt>
+ 	  <dd>
+ 	    <p>Return self.  This method is used internally by <a
+ 	      href="function.html#raise"> <code>raise</code></a>.
+ 	    </p>
  	  </dd>
  	  <dt><a name="message"><code>message</code></a></dt>
  	  <dt><a name="to_s"><code>to_s</code></a></dt>

*** ruby-man-1.4-dist/function.html	Tue Oct  5 01:05:05 1999
--- ruby-man-1.4/function.html	Thu Mar 16 01:59:51 2000
***************
*** 476,481 ****
--- 476,488 ----
  the position in the source file is assigned to the <CODE>$@</CODE>.
  </P>
  <p>
+ If the first argument is not an exception class or an exception
+ object, the actual exception is determined by calling it's
+ <code>exception</code> method (except when the argument is a string in
+ the second form).  The <code>exception</code> method of that class or
+ object must return it's representation as an exception.
+ </p>
+ <p>
  The <code>fail</code> is an alias of the <code>raise</code>.
  </p>
  <DT><A NAME="rand"><CODE>rand(<VAR>max</VAR>)</CODE></A>

*** ruby-man-1.4-dist/syntax.html	Wed Dec  8 10:01:31 1999
--- ruby-man-1.4/syntax.html	Thu Mar 16 01:59:23 2000
***************
*** 1622,1627 ****
--- 1622,1634 ----
  the position in the source file is assigned to the <CODE>$@</CODE>.
  </P>
  <p>
+ If the first argument is not an exception class or an exception
+ object, the actual exception is determined by calling it's
+ <code>exception</code> method (except when the argument is a string in
+ the second form).  The <code>exception</code> method of that class or
+ object must return it's representation as an exception.
+ </p>
+ <p>
  The word `<code>raise</code>' is not the reserved word in Ruby.
  <code>raise</code> is the method of the <a href="Kernel.html">
  <code>Kernel</code></a> module.  There is an alias named