From 24be1f14e65e567acb4f68addec7d5e481342378 Mon Sep 17 00:00:00 2001
From: knu <knu@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Thu, 3 Jun 2010 14:48:23 +0000
Subject: * 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/trunk@28149 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 ext/digest/lib/digest/hmac.rb | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'ext/digest/lib/digest/hmac.rb')

diff --git a/ext/digest/lib/digest/hmac.rb b/ext/digest/lib/digest/hmac.rb
index 1948352c4b..98f98a69cf 100644
--- a/ext/digest/lib/digest/hmac.rb
+++ b/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
-- 
cgit v1.2.3