3 files changed, 37 insertions, 34 deletions
diff --git a/ext/.document b/ext/.document
index 0985f45328..45702f27a0 100644
--- a/ext/.document
+++ b/ext/.document
@@ -1,6 +1,10 @@
 # Add files to this as they become documented
 
+bigdecimal/bigdecimal.c
+etc/etc.c
+fcntl/fcntl.c
 iconv/iconv.c
+io/wait/wait.c
 nkf/lib/kconv.rb
 nkf/nkf.c
 socket/socket.c
diff --git a/ext/digest/digest.c b/ext/digest/digest.c
index a11996e5e9..347e3c71c4 100644
--- a/ext/digest/digest.c
+++ b/ext/digest/digest.c
@@ -13,24 +13,6 @@
 
 ************************************************/
 
-/*
- * This module provides an interface to the following hash algorithms:
- *
- *   - the MD5 Message-Digest Algorithm by the RSA Data Security,
- *     Inc., described in RFC 1321
- *
- *   - the SHA-1 Secure Hash Algorithm by NIST (the US' National
- *     Institute of Standards and Technology), described in FIPS PUB
- *     180-1.
- *
- *   - the SHA-256/384/512 Secure Hash Algorithm by NIST (the US'
- *     National Institute of Standards and Technology), described in
- *     FIPS PUB 180-2.
- *
- *   - the RIPEMD-160 cryptographic hash function, designed by Hans
- *     Dobbertin, Antoon Bosselaers, and Bart Preneel.
- */
-
 #include "digest.h"
 
 static VALUE mDigest, cDigest_Base;
@@ -244,7 +226,21 @@ rb_digest_base_equal(VALUE self, VALUE other)
 }
 
 /*
- * Init
+ * This module provides an interface to the following hash algorithms:
+ *
+ *   - the MD5 Message-Digest Algorithm by the RSA Data Security,
+ *     Inc., described in RFC 1321
+ *
+ *   - the SHA-1 Secure Hash Algorithm by NIST (the US' National
+ *     Institute of Standards and Technology), described in FIPS PUB
+ *     180-1.
+ *
+ *   - the SHA-256/384/512 Secure Hash Algorithm by NIST (the US'
+ *     National Institute of Standards and Technology), described in
+ *     FIPS PUB 180-2.
+ *
+ *   - the RIPEMD-160 cryptographic hash function, designed by Hans
+ *     Dobbertin, Antoon Bosselaers, and Bart Preneel.
  */
 
 void
diff --git a/ext/io/wait/wait.c b/ext/io/wait/wait.c
index 4b95698ce7..68d4bd5af7 100644
--- a/ext/io/wait/wait.c
+++ b/ext/io/wait/wait.c
@@ -41,17 +41,13 @@ void Init_wait _((void));
 EXTERN struct timeval rb_time_interval _((VALUE time));
 
 /*
-=begin
-= IO wait methods.
-=end
+ * call-seq:
+ *
+ *   io.ready? -> boolean
+ *
+ * Returns non-nil if input available without blocking, or nil.
  */
 
-/*
-=begin
---- IO#ready?
-    returns non-nil if input available without blocking, or nil.
-=end
-*/
 static VALUE
 io_ready_p(VALUE io)
 {
@@ -84,12 +80,15 @@ wait_readable(VALUE p)
 #endif
 
 /*
-=begin
---- IO#wait([timeout])
-    waits until input available or timed out and returns self, or nil
-    when EOF reached.
-=end
-*/
+ * call-seq:
+ *
+ *   io.wait          -> io, true, false or nil
+ *   io.wait(timeout) -> io, true, false or nil
+ *
+ * Waits until input is available or times out and returns self or nil when
+ * EOF is reached.
+ */
+
 static VALUE
 io_wait(int argc, VALUE *argv, VALUE io)
 {
@@ -130,6 +129,10 @@ io_wait(int argc, VALUE *argv, VALUE io)
     return Qnil;
 }
 
+/*
+ * IO wait methods
+ */
+
 void
 Init_wait()
 {