diff --git a/re.c b/re.c
index a429c33319..11f7e615b8 100644
--- a/re.c
+++ b/re.c
@@ -3265,8 +3265,8 @@ rb_reg_match2(VALUE re)
 
 /*
  *  call-seq:
- *     rxp.match(str)       -> matchdata or nil
- *     rxp.match(str,pos)   -> matchdata or nil
+ *     rxp.match(str, pos=0)                   -> matchdata or nil
+ *     rxp.match(str, pos=0) {|match| block }  -> obj
  *
  *  Returns a MatchData object describing the match, or
  *  <code>nil</code> if there was no match. This is equivalent to
diff --git a/string.c b/string.c
index ca21e0001c..c64b2735f9 100644
--- a/string.c
+++ b/string.c
@@ -3841,8 +3841,8 @@ static VALUE get_pat(VALUE);
 
 /*
  *  call-seq:
- *     str.match(pattern)        -> matchdata or nil
- *     str.match(pattern, pos)   -> matchdata or nil
+ *     str.match(pattern, pos=0)                   -> matchdata or nil
+ *     str.match(pattern, pos=0) {|match| block }  -> obj
  *
  *  Converts <i>pattern</i> to a Regexp (if it isn't already one),
  *  then invokes its <code>match</code> method on the receiver.