drbrain	2011-08-25 09:29:02 +0900 (Thu, 25 Aug 2011)

  New Revision: 33065

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=33065

  Log:
    * ext/openssl/ossl_digest.c:  Document OpenSSL::Digest::digest and add
      an example to OpenSSL::Digest.  Patch by Sylvain Daubert.
      [Ruby 1.9 - Bug #5166]
    * ext/openssl/lib/openssl/digest.rb (module OpenSSL):  ditto

  Modified files:
    trunk/ChangeLog
    trunk/ext/openssl/lib/openssl/digest.rb
    trunk/ext/openssl/ossl_digest.c

Index: ChangeLog
===================================================================
--- ChangeLog	(revision 33064)
+++ ChangeLog	(revision 33065)
@@ -1,3 +1,10 @@
+Thu Aug 25 09:25:48 2011  Eric Hodel  <drbrain@s...>
+
+	* ext/openssl/ossl_digest.c:  Document OpenSSL::Digest::digest and add
+	  an example to OpenSSL::Digest.  Patch by Sylvain Daubert.
+	  [Ruby 1.9 - Bug #5166]
+	* ext/openssl/lib/openssl/digest.rb (module OpenSSL):  ditto
+
 Thu Aug 25 08:19:43 2011  Koichi Sasada  <ko1@a...>
 
 	* vm.c (vm_make_env_each): work around to solve Bug #2729.
Index: ext/openssl/ossl_digest.c
===================================================================
--- ext/openssl/ossl_digest.c	(revision 33064)
+++ ext/openssl/ossl_digest.c	(revision 33065)
@@ -403,6 +403,17 @@
      *   sha256 << data2
      *   sha256 << data3
      *   digest = sha256.digest
+     *
+     * === Reuse a Digest instance
+     *
+     *   data1 = File.read('file1')
+     *   sha256 = OpenSSL::Digest::SHA256.new
+     *   digest1 = sha256.digest(data1)
+     *   
+     *   data2 = File.read('file2')
+     *   sha256.reset
+     *   digest2 = sha256.digest(data2)
+     *
      */
     cDigest = rb_define_class_under(mOSSL, "Digest", rb_path2class("Digest::Class"));
     /* Document-class: OpenSSL::Digest::DigestError
Index: ext/openssl/lib/openssl/digest.rb
===================================================================
--- ext/openssl/lib/openssl/digest.rb	(revision 33064)
+++ ext/openssl/lib/openssl/digest.rb	(revision 33065)
@@ -22,6 +22,17 @@
       alg += %w(SHA224 SHA256 SHA384 SHA512)
     end
 
+    # Return the +data+ hash computed with +name+ Digest. +name+ is either the
+    # long name or short name of a supported digest algorithm.
+    #
+    # === Examples
+    #
+    #   OpenSSL::Digest.digest("SHA256, "abc")
+    #
+    # which is equivalent to:
+    #
+    #   OpenSSL::Digest::SHA256.digest("abc")
+
     def self.digest(name, data)
         super(data, name)
     end

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/