* ext/digest/lib/digest/hmac.rb: Emit a deprecation warning in

verbose mode and add a caution to the overview section of the
  document. [ruby-dev:41525]


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/branches/ruby_1_9_2@28151 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

ChangeLog

@@ -1,3 +1,9 @@
+Thu Jun  3 23:34:55 2010  Akinori MUSHA  <knu@iDaemons.org>
+
+	* ext/digest/lib/digest/hmac.rb: Emit a deprecation warning in
+	  verbose mode and add a caution to the overview section of the
+	  document. [ruby-dev:41525]
+
 Thu Jun  3 19:33:51 2010  Nobuyoshi Nakada  <nobu@ruby-lang.org>
 
 	* ext/dl/cfunc.c (rb_dlcfunc_inspect): suppress warnings by

NEWS

@@ -196,6 +196,10 @@ with all sufficient information, see the ChangeLog file.
     * Digest::Instance#base64digest
     * Digest::Instance#base64digest!
 
+  * Digest::HMAC (digest/hmac) has been marked as deprecated because
+    it was unintentional for the experimental library to be included
+    in the final release of 1.9.1.  Please use OpenSSL::HMAC instead.
+
 * rss
 
   * 0.2.4 -> 0.2.7.
@@ -455,3 +459,7 @@ with all sufficient information, see the ChangeLog file.
   * $:
 
     See above.
+
+  * Digest::HMAC
+
+    Deprecated.  See above.

ext/digest/lib/digest/hmac.rb

@@ -4,6 +4,11 @@
 #
 # == Overview
 #
+# CAUTION: Use of this library is discouraged, because this
+# implementation was meant to be experimental but somehow got into the
+# 1.9 series without being noticed.  Please use OpenSSL::HMAC in the
+# "openssl" library instead.
+#
 # This library adds a method named hmac() to Digest classes, which
 # creates a Digest class for calculating HMAC digests.
 #
@@ -36,6 +41,8 @@
 #   $Id$
 #
 
+warn "use of the experimetal library 'digest/hmac' is discouraged; require 'openssl' and use OpenSSL::HMAC instead." if $VERBOSE
+
 require 'digest'
 
 module Digest