From 694b2c7a29dc8e0f468053cafe85df7c63b20580 Mon Sep 17 00:00:00 2001 From: knu Date: Fri, 13 Oct 2006 20:55:33 +0000 Subject: [PATCH] * ext/digest/digest.c: Improve RDoc documentation further more. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@11165 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ChangeLog | 4 ++++ ext/digest/digest.c | 15 +++++++++++++-- 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/ChangeLog b/ChangeLog index 4e86163a24..52c65022fe 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Sat Oct 14 05:54:05 2006 Akinori MUSHA + + * ext/digest/digest.c: Improve RDoc documentation further more. + Sat Oct 14 04:33:33 2006 Akinori MUSHA * ext/digest/digest.c: Improve RDoc documentation. diff --git a/ext/digest/digest.c b/ext/digest/digest.c index 55c490c31e..9d56cb89c4 100644 --- a/ext/digest/digest.c +++ b/ext/digest/digest.c @@ -112,7 +112,8 @@ rb_digest_base_alloc(VALUE klass) * * Returns the hash value of a given string _data_. This is almost * equivalent to Digest::ALGORITHM.new(...).update(string).digest() - * where extra arguments, if any, are passed to the constructor. + * where extra arguments, if any, are passed through to the + * constructor. */ static VALUE rb_digest_base_s_digest(int argc, VALUE *argv, VALUE klass) @@ -157,7 +158,7 @@ rb_digest_base_s_digest(int argc, VALUE *argv, VALUE klass) * Returns the hex-encoded hash value of a given _string_. This * method just hex-encode the return value of * Digest::ALGORITHM.digest(string[, ...]) where extra arguments, if - * any, are passed to digest() along with the _string_. + * any, are passed through along with the _string_. */ static VALUE rb_digest_base_s_hexdigest(int argc, VALUE *argv, VALUE klass) @@ -197,6 +198,10 @@ rb_digest_base_copy(VALUE copy, VALUE obj) * digest_obj.reset -> digest_obj * * Resets the digest to the initial state and returns self. + * + * Every implementation subclass which constructor takes arguments + * must redefine this method because Digest::Base#reset() internally + * calls initialize() with no argument. */ static VALUE rb_digest_base_reset(VALUE self) @@ -225,6 +230,8 @@ rb_digest_base_reset(VALUE self) * digest_obj.update(string) -> digest_obj * * Updates the digest using a given _string_ and returns self. + * + * Implementation subclasses must redefine this method. */ static VALUE rb_digest_base_update(VALUE self, VALUE str) @@ -252,6 +259,8 @@ rb_digest_base_update(VALUE self, VALUE str) * digest_obj << string -> digest_obj * * Calls update(string). + * + * Subclasses need not redefine this method. */ static VALUE rb_digest_base_lshift(VALUE self, VALUE str) @@ -281,6 +290,8 @@ rb_digest_base_lshift(VALUE self, VALUE str) * digest_obj.digest -> string * * Returns the resulting hash value. + * + * Implementation subclasses must redefine this method. */ static VALUE rb_digest_base_digest(VALUE self)