numo-narray-alt 0.9.5 → 0.9.6

data/ext/numo/narray/src/t_dfloat.c

@@ -36,14 +36,23 @@ static ID id_to_a;
 
 #include <numo/types/dfloat.h>
 
-VALUE cT;
-extern VALUE cRT;
-
 /*
   class definition: Numo::DFloat
 */
-
 VALUE cT;
+extern VALUE cRT;
+
+#include "mh/mean.h"
+#include "mh/var.h"
+#include "mh/stddev.h"
+#include "mh/rms.h"
+
+typedef double dfloat; // Type aliases for shorter notation
+                       // following the codebase naming convention.
+DEF_NARRAY_FLT_MEAN_METHOD_FUNC(dfloat, double, numo_cDFloat, numo_cDFloat)
+DEF_NARRAY_FLT_VAR_METHOD_FUNC(dfloat, double, numo_cDFloat, numo_cDFloat)
+DEF_NARRAY_FLT_STDDEV_METHOD_FUNC(dfloat, double, numo_cDFloat, numo_cDFloat)
+DEF_NARRAY_FLT_RMS_METHOD_FUNC(dfloat, double, numo_cDFloat, numo_cDFloat)
 
 static VALUE dfloat_store(VALUE, VALUE);
 
@@ -148,13 +157,6 @@ static VALUE dfloat_allocate(VALUE self) {
   return self;
 }
 
-/*
-  Extract an element only if self is a dimensionless NArray.
-  @overload extract
-  @return [Numeric,Numo::NArray]
-  --- Extract element value as Ruby Object if self is a dimensionless NArray,
-  otherwise returns self.
-*/
 static VALUE dfloat_extract(VALUE self) {
   volatile VALUE v;
   char* ptr;
@@ -892,12 +894,6 @@ static VALUE dfloat_store_array(VALUE self, VALUE rary) {
   return self;
 }
 
-/*
-  Store elements to Numo::DFloat from other.
-  @overload store(other)
-  @param [Object] other
-  @return [Numo::DFloat] self
-*/
 static VALUE dfloat_store(VALUE self, VALUE obj) {
   VALUE r, klass;
 
@@ -1104,14 +1100,6 @@ static VALUE dfloat_cast_array(VALUE rary) {
   return nary;
 }
 
-/*
-  Cast object to Numo::DFloat.
-  @overload [](elements)
-  @overload cast(array)
-  @param [Numeric,Array] elements
-  @param [Array] array
-  @return [Numo::DFloat]
-*/
 static VALUE dfloat_s_cast(VALUE type, VALUE obj) {
   VALUE v;
   narray_t* na;
@@ -1147,15 +1135,6 @@ static VALUE dfloat_s_cast(VALUE type, VALUE obj) {
   return Qnil;
 }
 
-/*
-  Multi-dimensional element reference.
-  @overload [](dim0,...,dimL)
-  @param [Numeric,Range,Array,Numo::Int32,Numo::Int64,Numo::Bit,TrueClass,FalseClass,Symbol]
-  dim0,...,dimL  multi-dimensional indices.
-  @return [Numeric,Numo::DFloat] an element or NArray view.
-  @see Numo::NArray#[]
-  @see #[]=
- */
 static VALUE dfloat_aref(int argc, VALUE* argv, VALUE self) {
   int nd;
   size_t pos;
@@ -1170,16 +1149,6 @@ static VALUE dfloat_aref(int argc, VALUE* argv, VALUE self) {
   }
 }
 
-/*
-  Multi-dimensional element assignment.
-  @overload []=(dim0,...,dimL,val)
-  @param [Numeric,Range,Array,Numo::Int32,Numo::Int64,Numo::Bit,TrueClass,FalseClass,Symbol]
-  dim0,...,dimL  multi-dimensional indices.
-  @param [Numeric,Numo::NArray,Array] val  Value(s) to be set to self.
-  @return [Numeric,Numo::NArray,Array] returns `val` (last argument).
-  @see Numo::NArray#[]=
-  @see #[]
-*/
 static VALUE dfloat_aset(int argc, VALUE* argv, VALUE self) {
   int nd;
   size_t pos;
@@ -1204,11 +1173,6 @@ static VALUE dfloat_aset(int argc, VALUE* argv, VALUE self) {
   return argv[argc];
 }
 
-/*
-  return NArray with cast to the type of self.
-  @overload coerce_cast(type)
-  @return [nil]
-*/
 static VALUE dfloat_coerce_cast(VALUE self, VALUE type) {
   return Qnil;
 }
@@ -1239,11 +1203,6 @@ static void iter_dfloat_to_a(na_loop_t* const lp) {
   }
 }
 
-/*
-  Convert self to Array.
-  @overload to_a
-  @return [Array]
-*/
 static VALUE dfloat_to_a(VALUE self) {
   ndfunc_arg_in_t ain[3] = { { Qnil, 0 }, { sym_loop_opt }, { sym_option } };
   ndfunc_arg_out_t aout[1] = { { rb_cArray, 0 } }; // dummy?
@@ -1272,12 +1231,6 @@ static void iter_dfloat_fill(na_loop_t* const lp) {
   }
 }
 
-/*
-  Fill elements with other.
-  @overload fill other
-  @param [Numeric] other
-  @return [Numo::DFloat] self.
-*/
 static VALUE dfloat_fill(VALUE self, VALUE val) {
   ndfunc_arg_in_t ain[2] = { { OVERWRITE, 0 }, { sym_option } };
   ndfunc_t ndf = { iter_dfloat_fill, FULL_LOOP, 2, 0, ain, 0 };
@@ -1326,12 +1279,6 @@ static void iter_dfloat_format(na_loop_t* const lp) {
   }
 }
 
-/*
-  Format elements into strings.
-  @overload format format
-  @param [String] format
-  @return [Numo::RObject] array of formatted strings.
-*/
 static VALUE dfloat_format(int argc, VALUE* argv, VALUE self) {
   VALUE fmt = Qnil;
 
@@ -1373,12 +1320,6 @@ static void iter_dfloat_format_to_a(na_loop_t* const lp) {
   }
 }
 
-/*
-  Format elements into strings.
-  @overload format_to_a format
-  @param [String] format
-  @return [Array] array of formatted strings.
-*/
 static VALUE dfloat_format_to_a(int argc, VALUE* argv, VALUE self) {
   VALUE fmt = Qnil;
   ndfunc_arg_in_t ain[3] = { { Qnil, 0 }, { sym_loop_opt }, { sym_option } };
@@ -1393,11 +1334,6 @@ static VALUE iter_dfloat_inspect(char* ptr, size_t pos, VALUE fmt) {
   return format_dfloat(fmt, (dtype*)(ptr + pos));
 }
 
-/*
-  Returns a string containing a human-readable representation of NArray.
-  @overload inspect
-  @return [String]
-*/
 static VALUE dfloat_inspect(VALUE ary) {
   return na_ndloop_inspect(ary, iter_dfloat_inspect, Qnil);
 }
@@ -1426,16 +1362,6 @@ static void iter_dfloat_each(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calls the given block once for each element in self,
-  passing that element as a parameter.
-  @overload each
-  @return [Numo::NArray] self
-  For a block `{|x| ... }`,
-  @yieldparam [Numeric] x  an element of NArray.
-  @see #each_with_index
-  @see #map
-*/
 static VALUE dfloat_each(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { Qnil, 0 } };
   ndfunc_t ndf = { iter_dfloat_each, FULL_LOOP_NIP, 1, 0, ain, 0 };
@@ -1506,11 +1432,6 @@ static void iter_dfloat_map(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary map.
-  @overload map
-  @return [Numo::DFloat] map of self.
-*/
 static VALUE dfloat_map(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -1564,17 +1485,6 @@ static void iter_dfloat_each_with_index(na_loop_t* const lp) {
   }
 }
 
-/*
-  Invokes the given block once for each element of self,
-  passing that element and indices along each axis as parameters.
-  @overload each_with_index
-  For a block `{|x,i,j,...| ... }`,
-  @yieldparam [Numeric] x  an element
-  @yieldparam [Integer] i,j,...  multitimensional indices
-  @return [Numo::NArray] self
-  @see #each
-  @see #map_with_index
-*/
 static VALUE dfloat_each_with_index(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { Qnil, 0 } };
   ndfunc_t ndf = { iter_dfloat_each_with_index, FULL_LOOP_NIP, 1, 0, ain, 0 };
@@ -1653,19 +1563,6 @@ static void iter_dfloat_map_with_index(na_loop_t* const lp) {
   }
 }
 
-/*
-  Invokes the given block once for each element of self,
-  passing that element and indices along each axis as parameters.
-  Creates a new NArray containing the values returned by the block.
-  Inplace option is allowed, i.e., `nary.inplace.map` overwrites `nary`.
-  @overload map_with_index
-  For a block `{|x,i,j,...| ... }`,
-  @yieldparam [Numeric] x  an element
-  @yieldparam [Integer] i,j,...  multitimensional indices
-  @return [Numo::NArray] mapped array
-  @see #map
-  @see #each_with_index
-*/
 static VALUE dfloat_map_with_index(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { Qnil, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -1715,11 +1612,6 @@ static void iter_dfloat_abs(na_loop_t* const lp) {
   }
 }
 
-/*
-  abs of self.
-  @overload abs
-  @return [Numo::DFloat] abs of self.
-*/
 static VALUE dfloat_abs(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cRT, 0 } };
@@ -1728,7 +1620,7 @@ static VALUE dfloat_abs(VALUE self) {
   return na_ndloop(&ndf, 1, self);
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_dfloat_add(na_loop_t* const lp) {
@@ -1946,12 +1838,6 @@ static VALUE dfloat_add_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Binary add.
-  @overload + other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::NArray] self + other
-*/
 static VALUE dfloat_add(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -1965,7 +1851,7 @@ static VALUE dfloat_add(VALUE self, VALUE other) {
   }
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_dfloat_sub(na_loop_t* const lp) {
@@ -2185,12 +2071,6 @@ static VALUE dfloat_sub_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Binary sub.
-  @overload - other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::NArray] self - other
-*/
 static VALUE dfloat_sub(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2204,7 +2084,7 @@ static VALUE dfloat_sub(VALUE self, VALUE other) {
   }
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_dfloat_mul(na_loop_t* const lp) {
@@ -2424,12 +2304,6 @@ static VALUE dfloat_mul_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Binary mul.
-  @overload * other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::NArray] self * other
-*/
 static VALUE dfloat_mul(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2443,7 +2317,7 @@ static VALUE dfloat_mul(VALUE self, VALUE other) {
   }
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_dfloat_div(na_loop_t* const lp) {
@@ -2663,12 +2537,6 @@ static VALUE dfloat_div_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Binary div.
-  @overload / other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::NArray] self / other
-*/
 static VALUE dfloat_div(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2682,7 +2550,7 @@ static VALUE dfloat_div(VALUE self, VALUE other) {
   }
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_dfloat_mod(na_loop_t* const lp) {
@@ -2781,12 +2649,6 @@ static VALUE dfloat_mod_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Binary mod.
-  @overload % other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::NArray] self % other
-*/
 static VALUE dfloat_mod(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2827,12 +2689,6 @@ static VALUE dfloat_divmod_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Binary divmod.
-  @overload divmod other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::NArray] divmod of self and other.
-*/
 static VALUE dfloat_divmod(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2895,12 +2751,6 @@ static VALUE dfloat_pow_self(VALUE self, VALUE other) {
   }
 }
 
-/*
-  Binary power.
-  @overload ** other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::NArray] self to the other-th power.
-*/
 static VALUE dfloat_pow(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2975,11 +2825,6 @@ static void iter_dfloat_minus(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary minus.
-  @overload -@
-  @return [Numo::DFloat] minus of self.
-*/
 static VALUE dfloat_minus(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3050,11 +2895,6 @@ static void iter_dfloat_reciprocal(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary reciprocal.
-  @overload reciprocal
-  @return [Numo::DFloat] reciprocal of self.
-*/
 static VALUE dfloat_reciprocal(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3125,11 +2965,6 @@ static void iter_dfloat_sign(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary sign.
-  @overload sign
-  @return [Numo::DFloat] sign of self.
-*/
 static VALUE dfloat_sign(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3200,11 +3035,6 @@ static void iter_dfloat_square(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary square.
-  @overload square
-  @return [Numo::DFloat] square of self.
-*/
 static VALUE dfloat_square(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3242,12 +3072,6 @@ static VALUE dfloat_eq_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Comparison eq other.
-  @overload eq other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::Bit] result of self eq other.
-*/
 static VALUE dfloat_eq(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3289,12 +3113,6 @@ static VALUE dfloat_ne_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Comparison ne other.
-  @overload ne other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::Bit] result of self ne other.
-*/
 static VALUE dfloat_ne(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3336,12 +3154,6 @@ static VALUE dfloat_nearly_eq_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Comparison nearly_eq other.
-  @overload nearly_eq other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::Bit] result of self nearly_eq other.
-*/
 static VALUE dfloat_nearly_eq(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3416,11 +3228,6 @@ static void iter_dfloat_floor(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary floor.
-  @overload floor
-  @return [Numo::DFloat] floor of self.
-*/
 static VALUE dfloat_floor(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3491,11 +3298,6 @@ static void iter_dfloat_round(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary round.
-  @overload round
-  @return [Numo::DFloat] round of self.
-*/
 static VALUE dfloat_round(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3566,11 +3368,6 @@ static void iter_dfloat_ceil(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary ceil.
-  @overload ceil
-  @return [Numo::DFloat] ceil of self.
-*/
 static VALUE dfloat_ceil(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3641,11 +3438,6 @@ static void iter_dfloat_trunc(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary trunc.
-  @overload trunc
-  @return [Numo::DFloat] trunc of self.
-*/
 static VALUE dfloat_trunc(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3716,11 +3508,6 @@ static void iter_dfloat_rint(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary rint.
-  @overload rint
-  @return [Numo::DFloat] rint of self.
-*/
 static VALUE dfloat_rint(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3729,7 +3516,7 @@ static VALUE dfloat_rint(VALUE self) {
   return na_ndloop(&ndf, 1, self);
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_dfloat_copysign(na_loop_t* const lp) {
@@ -3828,12 +3615,6 @@ static VALUE dfloat_copysign_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Binary copysign.
-  @overload copysign other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::NArray] self copysign other
-*/
 static VALUE dfloat_copysign(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3876,11 +3657,6 @@ static void iter_dfloat_signbit(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of signbit.
-  @overload signbit
-  @return [Numo::Bit] Condition of signbit.
-*/
 static VALUE dfloat_signbit(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -3906,11 +3682,6 @@ static void iter_dfloat_modf(na_loop_t* const lp) {
   }
 }
 
-/*
-  modf of self.
-  @overload modf
-  @return [Numo::DFloat] modf of self.
-*/
 static VALUE dfloat_modf(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[2] = { { cT, 0 }, { cT, 0 } };
@@ -3948,12 +3719,6 @@ static VALUE dfloat_gt_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Comparison gt other.
-  @overload gt other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::Bit] result of self gt other.
-*/
 static VALUE dfloat_gt(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3995,12 +3760,6 @@ static VALUE dfloat_ge_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Comparison ge other.
-  @overload ge other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::Bit] result of self ge other.
-*/
 static VALUE dfloat_ge(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -4042,12 +3801,6 @@ static VALUE dfloat_lt_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Comparison lt other.
-  @overload lt other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::Bit] result of self lt other.
-*/
 static VALUE dfloat_lt(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -4089,12 +3842,6 @@ static VALUE dfloat_le_self(VALUE self, VALUE other) {
   return na_ndloop(&ndf, 2, self, other);
 }
 
-/*
-  Comparison le other.
-  @overload le other
-  @param [Numo::NArray,Numeric] other
-  @return [Numo::Bit] result of self le other.
-*/
 static VALUE dfloat_le(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -4172,36 +3919,6 @@ static void iter_dfloat_clip_max(na_loop_t* const lp) {
   }
 }
 
-/*
-  Clip array elements by [min,max].
-  If either of min or max is nil, one side is clipped.
-  @overload clip(min,max)
-  @param [Numo::NArray,Numeric] min
-  @param [Numo::NArray,Numeric] max
-  @return [Numo::NArray] result of clip.
-
-  @example
-      a = Numo::Int32.new(10).seq
-      # => Numo::Int32#shape=[10]
-      # [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
-
-      a.clip(1,8)
-      # => Numo::Int32#shape=[10]
-      # [1, 1, 2, 3, 4, 5, 6, 7, 8, 8]
-
-      a.inplace.clip(3,6)
-      a
-      # => Numo::Int32#shape=[10]
-      # [3, 3, 3, 3, 4, 5, 6, 6, 6, 6]
-
-      b = Numo::Int32.new(10).seq
-      # => Numo::Int32#shape=[10]
-      # [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
-
-      b.clip([3,4,1,1,1,4,4,4,4,4], 8)
-      # => Numo::Int32#shape=[10]
-      # [3, 4, 2, 3, 4, 5, 6, 7, 8, 8]
-*/
 static VALUE dfloat_clip(VALUE self, VALUE min, VALUE max) {
   ndfunc_arg_in_t ain[3] = { { Qnil, 0 }, { cT, 0 }, { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -4253,11 +3970,6 @@ static void iter_dfloat_isnan(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isnan.
-  @overload isnan
-  @return [Numo::Bit] Condition of isnan.
-*/
 static VALUE dfloat_isnan(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4295,11 +4007,6 @@ static void iter_dfloat_isinf(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isinf.
-  @overload isinf
-  @return [Numo::Bit] Condition of isinf.
-*/
 static VALUE dfloat_isinf(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4337,11 +4044,6 @@ static void iter_dfloat_isposinf(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isposinf.
-  @overload isposinf
-  @return [Numo::Bit] Condition of isposinf.
-*/
 static VALUE dfloat_isposinf(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4379,11 +4081,6 @@ static void iter_dfloat_isneginf(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isneginf.
-  @overload isneginf
-  @return [Numo::Bit] Condition of isneginf.
-*/
 static VALUE dfloat_isneginf(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4421,11 +4118,6 @@ static void iter_dfloat_isfinite(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isfinite.
-  @overload isfinite
-  @return [Numo::Bit] Condition of isfinite.
-*/
 static VALUE dfloat_isfinite(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4457,16 +4149,6 @@ static void iter_dfloat_sum_nan(na_loop_t* const lp) {
   *(dtype*)p2 = f_sum_nan(n, p1, s1);
 }
 
-/*
-  sum of self.
-  @overload sum(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs sum along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of sum.
-*/
 static VALUE dfloat_sum(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4503,16 +4185,6 @@ static void iter_dfloat_prod_nan(na_loop_t* const lp) {
   *(dtype*)p2 = f_prod_nan(n, p1, s1);
 }
 
-/*
-  prod of self.
-  @overload prod(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs prod along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of prod.
-*/
 static VALUE dfloat_prod(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4549,16 +4221,6 @@ static void iter_dfloat_kahan_sum_nan(na_loop_t* const lp) {
   *(dtype*)p2 = f_kahan_sum_nan(n, p1, s1);
 }
 
-/*
-  kahan_sum of self.
-  @overload kahan_sum(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs kahan_sum along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of kahan_sum.
-*/
 static VALUE dfloat_kahan_sum(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4572,190 +4234,6 @@ static VALUE dfloat_kahan_sum(int argc, VALUE* argv, VALUE self) {
   return dfloat_extract(v);
 }
 
-static void iter_dfloat_mean(na_loop_t* const lp) {
-  size_t n;
-  char *p1, *p2;
-  ssize_t s1;
-
-  INIT_COUNTER(lp, n);
-  INIT_PTR(lp, 0, p1, s1);
-  p2 = lp->args[1].ptr + lp->args[1].iter[0].pos;
-
-  *(dtype*)p2 = f_mean(n, p1, s1);
-}
-static void iter_dfloat_mean_nan(na_loop_t* const lp) {
-  size_t n;
-  char *p1, *p2;
-  ssize_t s1;
-
-  INIT_COUNTER(lp, n);
-  INIT_PTR(lp, 0, p1, s1);
-  p2 = lp->args[1].ptr + lp->args[1].iter[0].pos;
-
-  *(dtype*)p2 = f_mean_nan(n, p1, s1);
-}
-
-/*
-  mean of self.
-  @overload mean(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs mean along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of mean.
-*/
-static VALUE dfloat_mean(int argc, VALUE* argv, VALUE self) {
-  VALUE v, reduce;
-  ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
-  ndfunc_arg_out_t aout[1] = { { cT, 0 } };
-  ndfunc_t ndf = { iter_dfloat_mean, STRIDE_LOOP_NIP | NDF_FLAT_REDUCE, 2, 1, ain, aout };
-
-  reduce = na_reduce_dimension(argc, argv, 1, &self, &ndf, iter_dfloat_mean_nan);
-
-  v = na_ndloop(&ndf, 2, self, reduce);
-
-  return dfloat_extract(v);
-}
-
-static void iter_dfloat_stddev(na_loop_t* const lp) {
-  size_t n;
-  char *p1, *p2;
-  ssize_t s1;
-
-  INIT_COUNTER(lp, n);
-  INIT_PTR(lp, 0, p1, s1);
-  p2 = lp->args[1].ptr + lp->args[1].iter[0].pos;
-
-  *(rtype*)p2 = f_stddev(n, p1, s1);
-}
-static void iter_dfloat_stddev_nan(na_loop_t* const lp) {
-  size_t n;
-  char *p1, *p2;
-  ssize_t s1;
-
-  INIT_COUNTER(lp, n);
-  INIT_PTR(lp, 0, p1, s1);
-  p2 = lp->args[1].ptr + lp->args[1].iter[0].pos;
-
-  *(rtype*)p2 = f_stddev_nan(n, p1, s1);
-}
-
-/*
-  stddev of self.
-  @overload stddev(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs stddev along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of stddev.
-*/
-static VALUE dfloat_stddev(int argc, VALUE* argv, VALUE self) {
-  VALUE v, reduce;
-  ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
-  ndfunc_arg_out_t aout[1] = { { cRT, 0 } };
-  ndfunc_t ndf = { iter_dfloat_stddev, STRIDE_LOOP_NIP | NDF_FLAT_REDUCE, 2, 1, ain, aout };
-
-  reduce = na_reduce_dimension(argc, argv, 1, &self, &ndf, iter_dfloat_stddev_nan);
-
-  v = na_ndloop(&ndf, 2, self, reduce);
-
-  return rb_funcall(v, rb_intern("extract"), 0);
-}
-
-static void iter_dfloat_var(na_loop_t* const lp) {
-  size_t n;
-  char *p1, *p2;
-  ssize_t s1;
-
-  INIT_COUNTER(lp, n);
-  INIT_PTR(lp, 0, p1, s1);
-  p2 = lp->args[1].ptr + lp->args[1].iter[0].pos;
-
-  *(rtype*)p2 = f_var(n, p1, s1);
-}
-static void iter_dfloat_var_nan(na_loop_t* const lp) {
-  size_t n;
-  char *p1, *p2;
-  ssize_t s1;
-
-  INIT_COUNTER(lp, n);
-  INIT_PTR(lp, 0, p1, s1);
-  p2 = lp->args[1].ptr + lp->args[1].iter[0].pos;
-
-  *(rtype*)p2 = f_var_nan(n, p1, s1);
-}
-
-/*
-  var of self.
-  @overload var(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs var along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of var.
-*/
-static VALUE dfloat_var(int argc, VALUE* argv, VALUE self) {
-  VALUE v, reduce;
-  ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
-  ndfunc_arg_out_t aout[1] = { { cRT, 0 } };
-  ndfunc_t ndf = { iter_dfloat_var, STRIDE_LOOP_NIP | NDF_FLAT_REDUCE, 2, 1, ain, aout };
-
-  reduce = na_reduce_dimension(argc, argv, 1, &self, &ndf, iter_dfloat_var_nan);
-
-  v = na_ndloop(&ndf, 2, self, reduce);
-
-  return rb_funcall(v, rb_intern("extract"), 0);
-}
-
-static void iter_dfloat_rms(na_loop_t* const lp) {
-  size_t n;
-  char *p1, *p2;
-  ssize_t s1;
-
-  INIT_COUNTER(lp, n);
-  INIT_PTR(lp, 0, p1, s1);
-  p2 = lp->args[1].ptr + lp->args[1].iter[0].pos;
-
-  *(rtype*)p2 = f_rms(n, p1, s1);
-}
-static void iter_dfloat_rms_nan(na_loop_t* const lp) {
-  size_t n;
-  char *p1, *p2;
-  ssize_t s1;
-
-  INIT_COUNTER(lp, n);
-  INIT_PTR(lp, 0, p1, s1);
-  p2 = lp->args[1].ptr + lp->args[1].iter[0].pos;
-
-  *(rtype*)p2 = f_rms_nan(n, p1, s1);
-}
-
-/*
-  rms of self.
-  @overload rms(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs rms along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of rms.
-*/
-static VALUE dfloat_rms(int argc, VALUE* argv, VALUE self) {
-  VALUE v, reduce;
-  ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
-  ndfunc_arg_out_t aout[1] = { { cRT, 0 } };
-  ndfunc_t ndf = { iter_dfloat_rms, STRIDE_LOOP_NIP | NDF_FLAT_REDUCE, 2, 1, ain, aout };
-
-  reduce = na_reduce_dimension(argc, argv, 1, &self, &ndf, iter_dfloat_rms_nan);
-
-  v = na_ndloop(&ndf, 2, self, reduce);
-
-  return rb_funcall(v, rb_intern("extract"), 0);
-}
-
 static void iter_dfloat_min(na_loop_t* const lp) {
   size_t n;
   char *p1, *p2;
@@ -4779,16 +4257,6 @@ static void iter_dfloat_min_nan(na_loop_t* const lp) {
   *(dtype*)p2 = f_min_nan(n, p1, s1);
 }
 
-/*
-  min of self.
-  @overload min(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs min along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of min.
-*/
 static VALUE dfloat_min(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4825,16 +4293,6 @@ static void iter_dfloat_max_nan(na_loop_t* const lp) {
   *(dtype*)p2 = f_max_nan(n, p1, s1);
 }
 
-/*
-  max of self.
-  @overload max(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs max along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of max.
-*/
 static VALUE dfloat_max(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4871,16 +4329,6 @@ static void iter_dfloat_ptp_nan(na_loop_t* const lp) {
   *(dtype*)p2 = f_ptp_nan(n, p1, s1);
 }
 
-/*
-  ptp of self.
-  @overload ptp(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN for sum/mean etc, or,
-  return NaN for min/max etc).
-  @param [Numeric,Array,Range] axis  Performs ptp along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns result of ptp.
-*/
 static VALUE dfloat_ptp(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4962,26 +4410,6 @@ static void iter_dfloat_max_index_index32_nan(na_loop_t* const lp) {
 }
 #undef idx_t
 
-/*
-  Index of the maximum value.
-  @overload max_index(axis:nil, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (return NaN posision if exist).
-  @param [Numeric,Array,Range] axis  Finds maximum values along the axis and returns **flat 1-d
-  indices**.
-  @return [Integer,Numo::Int] returns result indices.
-  @see #argmax
-  @see #max
-
-  @example
-      a = Numo::NArray[3,4,1,2]
-      a.max_index  #=> 1
-
-      b = Numo::NArray[[3,4,1],[2,0,5]]
-      b.max_index             #=> 5
-      b.max_index(axis:1)     #=> [1, 5]
-      b.max_index(axis:0)     #=> [0, 1, 5]
-      b[b.max_index(axis:0)]  #=> [3, 4, 5]
- */
 static VALUE dfloat_max_index(int argc, VALUE* argv, VALUE self) {
   narray_t* na;
   VALUE idx, reduce;
@@ -5080,26 +4508,6 @@ static void iter_dfloat_min_index_index32_nan(na_loop_t* const lp) {
 }
 #undef idx_t
 
-/*
-  Index of the minimum value.
-  @overload min_index(axis:nil, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (return NaN posision if exist).
-  @param [Numeric,Array,Range] axis  Finds minimum values along the axis and returns **flat 1-d
-  indices**.
-  @return [Integer,Numo::Int] returns result indices.
-  @see #argmin
-  @see #min
-
-  @example
-      a = Numo::NArray[3,4,1,2]
-      a.min_index  #=> 2
-
-      b = Numo::NArray[[3,4,1],[2,0,5]]
-      b.min_index             #=> 4
-      b.min_index(axis:1)     #=> [2, 4]
-      b.min_index(axis:0)     #=> [3, 4, 2]
-      b[b.min_index(axis:0)]  #=> [2, 0, 1]
- */
 static VALUE dfloat_min_index(int argc, VALUE* argv, VALUE self) {
   narray_t* na;
   VALUE idx, reduce;
@@ -5194,26 +4602,6 @@ static void iter_dfloat_argmax_arg32_nan(na_loop_t* const lp) {
 }
 #undef idx_t
 
-/*
-  Index of the maximum value.
-  @overload argmax(axis:nil, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (return NaN posision if exist).
-  @param [Numeric,Array,Range] axis  Finds maximum values along the axis and returns **indices
-  along the axis**.
-  @return [Integer,Numo::Int] returns the result indices.
-  @see #max_index
-  @see #max
-
-  @example
-      a = Numo::NArray[3,4,1,2]
-      a.argmax  #=> 1
-
-      b = Numo::NArray[[3,4,1],[2,0,5]]
-      b.argmax                       #=> 5
-      b.argmax(axis:1)               #=> [1, 2]
-      b.argmax(axis:0)               #=> [0, 0, 1]
-      b.at(b.argmax(axis:0), 0..-1)  #=> [3, 4, 5]
- */
 static VALUE dfloat_argmax(int argc, VALUE* argv, VALUE self) {
   narray_t* na;
   VALUE reduce;
@@ -5305,26 +4693,6 @@ static void iter_dfloat_argmin_arg32_nan(na_loop_t* const lp) {
 }
 #undef idx_t
 
-/*
-  Index of the minimum value.
-  @overload argmin(axis:nil, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (return NaN posision if exist).
-  @param [Numeric,Array,Range] axis  Finds minimum values along the axis and returns **indices
-  along the axis**.
-  @return [Integer,Numo::Int] returns the result indices.
-  @see #min_index
-  @see #min
-
-  @example
-      a = Numo::NArray[3,4,1,2]
-      a.argmin  #=> 2
-
-      b = Numo::NArray[[3,4,1],[2,0,5]]
-      b.argmin                       #=> 4
-      b.argmin(axis:1)               #=> [2, 1]
-      b.argmin(axis:0)               #=> [1, 1, 0]
-      b.at(b.argmin(axis:0), 0..-1)  #=> [2, 0, 1]
- */
 static VALUE dfloat_argmin(int argc, VALUE* argv, VALUE self) {
   narray_t* na;
   VALUE reduce;
@@ -5381,15 +4749,6 @@ static void iter_dfloat_minmax_nan(na_loop_t* const lp) {
   *(dtype*)(lp->args[2].ptr + lp->args[2].iter[0].pos) = xmax;
 }
 
-/*
-  minmax of self.
-  @overload minmax(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (return NaN if exist).
-  @param [Numeric,Array,Range] axis  Finds min-max along the axis.
-  @param [TrueClass] keepdims (keyword) If true, the reduced axes are left in the result array
-  as dimensions with size one.
-  @return [Numo::DFloat,Numo::DFloat] min and max of self.
-*/
 static VALUE dfloat_minmax(int argc, VALUE* argv, VALUE self) {
   VALUE reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -5403,16 +4762,6 @@ static VALUE dfloat_minmax(int argc, VALUE* argv, VALUE self) {
   return na_ndloop(&ndf, 2, self, reduce);
 }
 
-/*
-  Element-wise maximum of two arrays.
-
-  @overload maximum(a1, a2, nan:false)
-  @param [Numo::NArray,Numeric] a1  The array to be compared.
-  @param [Numo::NArray,Numeric] a2  The array to be compared.
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (return NaN if exist).
-  @return [Numo::DFloat]
-*/
-
 static void iter_dfloat_s_maximum(na_loop_t* const lp) {
   size_t i, n;
   char *p1, *p2, *p3;
@@ -5472,16 +4821,6 @@ static VALUE dfloat_s_maximum(int argc, VALUE* argv, VALUE mod) {
   return na_ndloop(&ndf, 2, a1, a2);
 }
 
-/*
-  Element-wise minimum of two arrays.
-
-  @overload minimum(a1, a2, nan:false)
-  @param [Numo::NArray,Numeric] a1  The array to be compared.
-  @param [Numo::NArray,Numeric] a2  The array to be compared.
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (return NaN if exist).
-  @return [Numo::DFloat]
-*/
-
 static void iter_dfloat_s_minimum(na_loop_t* const lp) {
   size_t i, n;
   char *p1, *p2, *p3;
@@ -5578,13 +4917,6 @@ static void iter_dfloat_cumsum_nan(na_loop_t* const lp) {
   }
 }
 
-/*
-  cumsum of self.
-  @overload cumsum(axis:nil, nan:false)
-  @param [Numeric,Array,Range] axis  Performs cumsum along the axis.
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN if exists).
-  @return [Numo::DFloat] cumsum of self.
-*/
 static VALUE dfloat_cumsum(int argc, VALUE* argv, VALUE self) {
   VALUE reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -5635,13 +4967,6 @@ static void iter_dfloat_cumprod_nan(na_loop_t* const lp) {
   }
 }
 
-/*
-  cumprod of self.
-  @overload cumprod(axis:nil, nan:false)
-  @param [Numeric,Array,Range] axis  Performs cumprod along the axis.
-  @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN if exists).
-  @return [Numo::DFloat] cumprod of self.
-*/
 static VALUE dfloat_cumprod(int argc, VALUE* argv, VALUE self) {
   VALUE reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -5746,17 +5071,6 @@ static VALUE dfloat_mulsum_self(int argc, VALUE* argv, VALUE self) {
   return dfloat_extract(v);
 }
 
-/*
-  Binary mulsum.
-
-  @overload mulsum(other, axis:nil, keepdims:false, nan:false)
-  @param [Numo::NArray,Numeric] other
-  @param [Numeric,Array,Range] axis  Performs mulsum along the axis.
-  @param [TrueClass] keepdims (keyword) If true, the reduced axes are left in the result array
-  as dimensions with size one.
-  @param [TrueClass] nan (keyword) If true, apply NaN-aware algorithm (avoid NaN if exists).
-  @return [Numo::NArray] mulsum of self and other.
-*/
 static VALUE dfloat_mulsum(int argc, VALUE* argv, VALUE self) {
   //
   VALUE klass, v;
@@ -5819,23 +5133,6 @@ static void iter_dfloat_seq(na_loop_t* const lp) {
   g->count = c;
 }
 
-/*
-  Set linear sequence of numbers to self. The sequence is obtained from
-     beg+i*step
-  where i is 1-dimensional index.
-  @overload seq([beg,[step]])
-  @param [Numeric] beg  beginning of sequence. (default=0)
-  @param [Numeric] step  step of sequence. (default=1)
-  @return [Numo::DFloat] self.
-  @example
-    Numo::DFloat.new(6).seq(1,-0.2)
-    # => Numo::DFloat#shape=[6]
-    # [1, 0.8, 0.6, 0.4, 0.2, 0]
-
-    Numo::DComplex.new(6).seq(1,-0.2+0.2i)
-    # => Numo::DComplex#shape=[6]
-    # [1+0i, 0.8+0.2i, 0.6+0.4i, 0.4+0.6i, 0.2+0.8i, 0+1i]
-*/
 static VALUE dfloat_seq(int argc, VALUE* args, VALUE self) {
   seq_opt_t* g;
   VALUE vbeg = Qnil, vstep = Qnil;
@@ -5898,27 +5195,6 @@ static void iter_dfloat_logseq(na_loop_t* const lp) {
   g->count = c;
 }
 
-/*
-  Set logarithmic sequence of numbers to self. The sequence is obtained from
-     `base**(beg+i*step)`
-  where i is 1-dimensional index.
-  Applicable classes: DFloat, SFloat, DComplex, SCopmplex.
-
-  @overload logseq(beg,step,[base])
-  @param [Numeric] beg  The beginning of sequence.
-  @param [Numeric] step  The step of sequence.
-  @param [Numeric] base  The base of log space. (default=10)
-  @return [Numo::DFloat] self.
-
-  @example
-    Numo::DFloat.new(5).logseq(4,-1,2)
-    # => Numo::DFloat#shape=[5]
-    # [16, 8, 4, 2, 1]
-
-    Numo::DComplex.new(5).logseq(0,1i*Math::PI/3,Math::E)
-    # => Numo::DComplex#shape=[5]
-    # [1+7.26156e-310i, 0.5+0.866025i, -0.5+0.866025i, -1+1.22465e-16i, ...]
-*/
 static VALUE dfloat_logseq(int argc, VALUE* args, VALUE self) {
   logseq_opt_t* g;
   VALUE vbeg, vstep, vbase;
@@ -5967,15 +5243,6 @@ static void iter_dfloat_eye(na_loop_t* const lp) {
   }
 }
 
-/*
-  Eye: Set a value to diagonal components, set 0 to non-diagonal components.
-  @overload eye([element,offset])
-  @param [Numeric] element  Diagonal element to be stored. Default is 1.
-  @param [Integer] offset Diagonal offset from the main diagonal.  The
-      default is 0. k>0 for diagonals above the main diagonal, and k<0
-      for diagonals below the main diagonal.
-  @return [Numo::DFloat] eye of self.
-*/
 static VALUE dfloat_eye(int argc, VALUE* argv, VALUE self) {
   ndfunc_arg_in_t ain[1] = { { OVERWRITE, 2 } };
   ndfunc_t ndf = { iter_dfloat_eye, NO_LOOP, 1, 0, ain, 0 };
@@ -6068,26 +5335,6 @@ static void iter_dfloat_rand(na_loop_t* const lp) {
   }
 }
 
-/*
-  Generate uniformly distributed random numbers on self narray.
-  @overload rand([[low],high])
-  @param [Numeric] low  lower inclusive boundary of random numbers. (default=0)
-  @param [Numeric] high  upper exclusive boundary of random numbers. (default=1 or 1+1i for
-  complex types)
-  @return [Numo::DFloat] self.
-  @example
-    Numo::DFloat.new(6).rand
-    # => Numo::DFloat#shape=[6]
-    # [0.0617545, 0.373067, 0.794815, 0.201042, 0.116041, 0.344032]
-
-    Numo::DComplex.new(6).rand(5+5i)
-    # => Numo::DComplex#shape=[6]
-    # [2.69974+3.68908i, 0.825443+0.254414i, 0.540323+0.34354i, 4.52061+2.39322i, ...]
-
-    Numo::Int32.new(6).rand(2,5)
-    # => Numo::Int32#shape=[6]
-    # [4, 3, 3, 2, 4, 2]
-*/
 static VALUE dfloat_rand(int argc, VALUE* args, VALUE self) {
   rand_opt_t g;
   VALUE v1 = Qnil, v2 = Qnil;
@@ -6167,36 +5414,6 @@ static void iter_dfloat_rand_norm(na_loop_t* const lp) {
   }
 }
 
-/*
-  Generates random numbers from the normal distribution on self narray
-  using Box-Muller Transformation.
-  @overload rand_norm([mu,[sigma]])
-  @param [Numeric] mu  mean of normal distribution. (default=0)
-  @param [Numeric] sigma  standard deviation of normal distribution. (default=1)
-  @return [Numo::DFloat] self.
-  @example
-    Numo::DFloat.new(5,5).rand_norm
-    # => Numo::DFloat#shape=[5,5]
-    # [[-0.581255, -0.168354, 0.586895, -0.595142, -0.802802],
-    #  [-0.326106, 0.282922, 1.68427, 0.918499, -0.0485384],
-    #  [-0.464453, -0.992194, 0.413794, -0.60717, -0.699695],
-    #  [-1.64168, 0.48676, -0.875871, -1.43275, 0.812172],
-    #  [-0.209975, -0.103612, -0.878617, -1.42495, 1.0968]]
-
-    Numo::DFloat.new(5,5).rand_norm(10,0.1)
-    # => Numo::DFloat#shape=[5,5]
-    # [[9.9019, 9.90339, 10.0826, 9.98384, 9.72861],
-    #  [9.81507, 10.0272, 9.91445, 10.0568, 9.88923],
-    #  [10.0234, 9.97874, 9.96011, 9.9006, 9.99964],
-    #  [10.0186, 9.94598, 9.92236, 9.99811, 9.97003],
-    #  [9.79266, 9.95044, 9.95212, 9.93692, 10.2027]]
-
-    Numo::DComplex.new(3,3).rand_norm(5+5i)
-    # => Numo::DComplex#shape=[3,3]
-    # [[5.84303+4.40052i, 4.00984+6.08982i, 5.10979+5.13215i],
-    #  [4.26477+3.99655i, 4.90052+5.00763i, 4.46607+2.3444i],
-    #  [4.5528+7.11003i, 5.62117+6.69094i, 5.05443+5.35133i]]
-*/
 static VALUE dfloat_rand_norm(int argc, VALUE* args, VALUE self) {
   int n;
   randn_opt_t g;
@@ -6235,13 +5452,6 @@ static void iter_dfloat_poly(na_loop_t* const lp) {
   *(dtype*)(lp->args[i].ptr + lp->args[i].iter[0].pos) = y;
 }
 
-/*
-  Calculate polynomial.
-    `x.poly(a0,a1,a2,...,an) = a0 + a1*x + a2*x**2 + ... + an*x**n`
-  @overload poly a0, a1, ..., an
-  @param [Numo::NArray,Numeric] a0,a1,...,an
-  @return [Numo::DFloat]
-*/
 static VALUE dfloat_poly(VALUE self, VALUE args) {
   int argc, i;
   VALUE* argv;
@@ -6327,27 +5537,27 @@ static VALUE dfloat_poly(VALUE self, VALUE args) {
  * We have modified their original by adding a check for already-sorted input,
  * which seems to be a win per discussions on pgsql-hackers around 2006-03-21.
  */
-#define swapcode(TYPE, parmi, parmj, n) \
-  do {                                  \
-    size_t i = (n) / sizeof(TYPE);      \
-    TYPE* pi = (TYPE*)(void*)(parmi);   \
-    TYPE* pj = (TYPE*)(void*)(parmj);   \
-    do {                                \
-      TYPE t = *pi;                     \
-      *pi++ = *pj;                      \
-      *pj++ = t;                        \
-    } while (--i > 0);                  \
+#define swapcode(TYPE, parmi, parmj, n)                                                        \
+  do {                                                                                         \
+    size_t i = (n) / sizeof(TYPE);                                                             \
+    TYPE* pi = (TYPE*)(void*)(parmi);                                                          \
+    TYPE* pj = (TYPE*)(void*)(parmj);                                                          \
+    do {                                                                                       \
+      TYPE t = *pi;                                                                            \
+      *pi++ = *pj;                                                                             \
+      *pj++ = t;                                                                               \
+    } while (--i > 0);                                                                         \
   } while (0)
 
 #ifdef HAVE_STDINT_H
-#define SWAPINIT(a, es)                                             \
-  swaptype = (uintptr_t)a % sizeof(long) || (es) % sizeof(long) ? 2 \
-             : (es) == sizeof(long)                             ? 0 \
+#define SWAPINIT(a, es)                                                                        \
+  swaptype = (uintptr_t)a % sizeof(long) || (es) % sizeof(long) ? 2                            \
+             : (es) == sizeof(long)                             ? 0                            \
                                                                 : 1;
 #else
-#define SWAPINIT(a, es)                                                        \
-  swaptype = ((char*)(a) - (char*)0) % sizeof(long) || (es) % sizeof(long) ? 2 \
-             : (es) == sizeof(long)                                        ? 0 \
+#define SWAPINIT(a, es)                                                                        \
+  swaptype = ((char*)(a) - (char*)0) % sizeof(long) || (es) % sizeof(long) ? 2                 \
+             : (es) == sizeof(long)                                        ? 0                 \
                                                                            : 1;
 #endif
 
@@ -6358,19 +5568,19 @@ static inline void swapfunc(char* a, char* b, size_t n, int swaptype) {
     swapcode(char, a, b, n);
 }
 
-#define swap(a, b)                           \
-  if (swaptype == 0) {                       \
-    long t = *(long*)(void*)(a);             \
-    *(long*)(void*)(a) = *(long*)(void*)(b); \
-    *(long*)(void*)(b) = t;                  \
-  } else                                     \
+#define swap(a, b)                                                                             \
+  if (swaptype == 0) {                                                                         \
+    long t = *(long*)(void*)(a);                                                               \
+    *(long*)(void*)(a) = *(long*)(void*)(b);                                                   \
+    *(long*)(void*)(b) = t;                                                                    \
+  } else                                                                                       \
     swapfunc(a, b, es, swaptype)
 
-#define vecswap(a, b, n) \
+#define vecswap(a, b, n)                                                                       \
   if ((n) > 0) swapfunc((a), (b), (size_t)(n), swaptype)
 
-#define med3(a, b, c, _cmp)                                \
-  (cmpgt(b, a) ? (cmpgt(c, b) ? b : (cmpgt(c, a) ? c : a)) \
+#define med3(a, b, c, _cmp)                                                                    \
+  (cmpgt(b, a) ? (cmpgt(c, b) ? b : (cmpgt(c, a) ? c : a))                                     \
                : (cmpgt(b, c) ? b : (cmpgt(c, a) ? a : c)))
 #endif
 
@@ -6600,15 +5810,6 @@ static void iter_dfloat_sort_prnan(na_loop_t* const lp) {
   dfloat_qsort_prnan(ptr, n, step);
 }
 
-/*
-  sort of self.
-  @overload sort(axis:nil, nan:false)
-  @param [TrueClass] nan  If true, propagete NaN. If false, ignore NaN.
-  @param [Numeric,Array,Range] axis  Performs sort along the axis.
-  @return [Numo::DFloat] returns result of sort.
-  @example
-      Numo::DFloat[3,4,1,2].sort #=> Numo::DFloat[1,2,3,4]
-*/
 static VALUE dfloat_sort(int argc, VALUE* argv, VALUE self) {
   VALUE reduce;
   ndfunc_arg_in_t ain[2] = { { OVERWRITE, 0 }, { sym_reduce, 0 } };
@@ -7025,15 +6226,6 @@ static void dfloat_index32_qsort_prnan(na_loop_t* const lp) {
 }
 #undef idx_t
 
-/*
-  sort_index. Returns an index array of sort result.
-  @overload sort_index(axis:nil, nan:false)
-  @param [TrueClass] nan  If true, propagete NaN. If false, ignore NaN.
-  @param [Numeric,Array,Range] axis  Performs sort_index along the axis.
-  @return [Integer,Numo::Int] returns result index of sort_index.
-  @example
-      Numo::NArray[3,4,1,2].sort_index #=> Numo::Int32[2,3,0,1]
-*/
 static VALUE dfloat_sort_index(int argc, VALUE* argv, VALUE self) {
   size_t size;
   narray_t* na;
@@ -7119,16 +6311,6 @@ static void iter_dfloat_median_prnan(na_loop_t* const lp) {
   }
 }
 
-/*
-  median of self.
-  @overload median(axis:nil, keepdims:false, nan:false)
-  @param [TrueClass] nan (keyword) If true, propagete NaN. If false, ignore NaN.
-  @param [Numeric,Array,Range] axis  Finds median along the axis.
-  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as
-  dimensions with size one.
-  @return [Numo::DFloat] returns median of self.
-*/
-
 static VALUE dfloat_median(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { OVERWRITE, 0 }, { sym_reduce, 0 } };
@@ -7144,10 +6326,6 @@ static VALUE dfloat_median(int argc, VALUE* argv, VALUE self) {
   return dfloat_extract(v);
 }
 
-/*
-  module definition: Numo::DFloat::NMath
-*/
-
 VALUE mTM;
 
 static void iter_dfloat_math_s_sqrt(na_loop_t* const lp) {
@@ -7265,12 +6443,6 @@ static void iter_dfloat_math_s_sqrt(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate sqrt(x).
-  @overload sqrt(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of sqrt(x).
-*/
 static VALUE dfloat_math_s_sqrt(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7343,12 +6515,6 @@ static void iter_dfloat_math_s_cbrt(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate cbrt(x).
-  @overload cbrt(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of cbrt(x).
-*/
 static VALUE dfloat_math_s_cbrt(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7421,12 +6587,6 @@ static void iter_dfloat_math_s_log(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate log(x).
-  @overload log(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of log(x).
-*/
 static VALUE dfloat_math_s_log(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7499,12 +6659,6 @@ static void iter_dfloat_math_s_log2(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate log2(x).
-  @overload log2(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of log2(x).
-*/
 static VALUE dfloat_math_s_log2(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7577,12 +6731,6 @@ static void iter_dfloat_math_s_log10(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate log10(x).
-  @overload log10(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of log10(x).
-*/
 static VALUE dfloat_math_s_log10(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7655,12 +6803,6 @@ static void iter_dfloat_math_s_exp(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate exp(x).
-  @overload exp(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of exp(x).
-*/
 static VALUE dfloat_math_s_exp(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7733,12 +6875,6 @@ static void iter_dfloat_math_s_exp2(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate exp2(x).
-  @overload exp2(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of exp2(x).
-*/
 static VALUE dfloat_math_s_exp2(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7811,12 +6947,6 @@ static void iter_dfloat_math_s_exp10(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate exp10(x).
-  @overload exp10(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of exp10(x).
-*/
 static VALUE dfloat_math_s_exp10(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7889,12 +7019,6 @@ static void iter_dfloat_math_s_sin(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate sin(x).
-  @overload sin(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of sin(x).
-*/
 static VALUE dfloat_math_s_sin(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7967,12 +7091,6 @@ static void iter_dfloat_math_s_cos(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate cos(x).
-  @overload cos(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of cos(x).
-*/
 static VALUE dfloat_math_s_cos(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8045,12 +7163,6 @@ static void iter_dfloat_math_s_tan(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate tan(x).
-  @overload tan(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of tan(x).
-*/
 static VALUE dfloat_math_s_tan(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8123,12 +7235,6 @@ static void iter_dfloat_math_s_asin(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate asin(x).
-  @overload asin(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of asin(x).
-*/
 static VALUE dfloat_math_s_asin(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8201,12 +7307,6 @@ static void iter_dfloat_math_s_acos(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate acos(x).
-  @overload acos(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of acos(x).
-*/
 static VALUE dfloat_math_s_acos(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8279,12 +7379,6 @@ static void iter_dfloat_math_s_atan(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate atan(x).
-  @overload atan(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of atan(x).
-*/
 static VALUE dfloat_math_s_atan(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8357,12 +7451,6 @@ static void iter_dfloat_math_s_sinh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate sinh(x).
-  @overload sinh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of sinh(x).
-*/
 static VALUE dfloat_math_s_sinh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8435,12 +7523,6 @@ static void iter_dfloat_math_s_cosh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate cosh(x).
-  @overload cosh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of cosh(x).
-*/
 static VALUE dfloat_math_s_cosh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8513,12 +7595,6 @@ static void iter_dfloat_math_s_tanh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate tanh(x).
-  @overload tanh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of tanh(x).
-*/
 static VALUE dfloat_math_s_tanh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8591,12 +7667,6 @@ static void iter_dfloat_math_s_asinh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate asinh(x).
-  @overload asinh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of asinh(x).
-*/
 static VALUE dfloat_math_s_asinh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8669,12 +7739,6 @@ static void iter_dfloat_math_s_acosh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate acosh(x).
-  @overload acosh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of acosh(x).
-*/
 static VALUE dfloat_math_s_acosh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8747,12 +7811,6 @@ static void iter_dfloat_math_s_atanh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate atanh(x).
-  @overload atanh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of atanh(x).
-*/
 static VALUE dfloat_math_s_atanh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8825,12 +7883,6 @@ static void iter_dfloat_math_s_sinc(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate sinc(x).
-  @overload sinc(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of sinc(x).
-*/
 static VALUE dfloat_math_s_sinc(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8856,13 +7908,6 @@ static void iter_dfloat_math_s_atan2(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate atan2(a1,a2).
-  @overload atan2(a1,a2)
-  @param [Numo::NArray,Numeric] a1  first value
-  @param [Numo::NArray,Numeric] a2  second value
-  @return [Numo::DFloat] atan2(a1,a2).
-*/
 static VALUE dfloat_math_s_atan2(VALUE mod, VALUE a1, VALUE a2) {
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8887,13 +7932,6 @@ static void iter_dfloat_math_s_hypot(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate hypot(a1,a2).
-  @overload hypot(a1,a2)
-  @param [Numo::NArray,Numeric] a1  first value
-  @param [Numo::NArray,Numeric] a2  second value
-  @return [Numo::DFloat] hypot(a1,a2).
-*/
 static VALUE dfloat_math_s_hypot(VALUE mod, VALUE a1, VALUE a2) {
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8965,12 +8003,6 @@ static void iter_dfloat_math_s_erf(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate erf(x).
-  @overload erf(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of erf(x).
-*/
 static VALUE dfloat_math_s_erf(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -9043,12 +8075,6 @@ static void iter_dfloat_math_s_erfc(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate erfc(x).
-  @overload erfc(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of erfc(x).
-*/
 static VALUE dfloat_math_s_erfc(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -9121,12 +8147,6 @@ static void iter_dfloat_math_s_log1p(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate log1p(x).
-  @overload log1p(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of log1p(x).
-*/
 static VALUE dfloat_math_s_log1p(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -9199,12 +8219,6 @@ static void iter_dfloat_math_s_expm1(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate expm1(x).
-  @overload expm1(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::DFloat] result of expm1(x).
-*/
 static VALUE dfloat_math_s_expm1(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -9230,13 +8244,6 @@ static void iter_dfloat_math_s_ldexp(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate ldexp(a1,a2).
-  @overload ldexp(a1,a2)
-  @param [Numo::NArray,Numeric] a1  first value
-  @param [Numo::NArray,Numeric] a2  second value
-  @return [Numo::DFloat] ldexp(a1,a2).
-*/
 static VALUE dfloat_math_s_ldexp(VALUE mod, VALUE a1, VALUE a2) {
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -9262,15 +8269,6 @@ static void iter_dfloat_math_s_frexp(na_loop_t* const lp) {
   }
 }
 
-/*
-  split the number x into a normalized fraction and an exponent.
-  Returns [mantissa, exponent], where x = mantissa * 2**exponent.
-
-  @overload frexp(x)
-  @param [Numo::NArray,Numeric]  x
-  @return [Numo::DFloat,Numo::Int32]  mantissa and exponent.
-
-*/
 static VALUE dfloat_math_s_frexp(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[2] = { { cT, 0 }, { numo_cInt32, 0 } };
@@ -9298,16 +8296,18 @@ void Init_numo_dfloat(void) {
   id_nearly_eq = rb_intern("nearly_eq");
   id_to_a = rb_intern("to_a");
 
-  /*
-    Document-class: Numo::DFloat
-
-  */
+  /**
+   * Document-class: Numo::DFloat
+   *
+   * Double precision floating point number (64-bit float) N-dimensional array class.
+   */
   cT = rb_define_class_under(mNumo, "DFloat", cNArray);
 
   // alias of DFloat
   rb_define_const(mNumo, "Float64", numo_cDFloat);
 
   hCast = rb_hash_new();
+  /* Upcasting rules of DFloat. */
   rb_define_const(cT, "UPCAST", hCast);
   rb_hash_aset(hCast, rb_cArray, cT);
 
@@ -9334,148 +8334,1002 @@ void Init_numo_dfloat(void) {
   rb_hash_aset(hCast, numo_cUInt8, numo_cDFloat);
   rb_obj_freeze(hCast);
 
-  /**/
+  /* Element size of DFloat in bits. */
   rb_define_const(cT, "ELEMENT_BIT_SIZE", INT2FIX(sizeof(dtype) * 8));
-  /**/
+  /* Element size of DFloat in bytes. */
   rb_define_const(cT, "ELEMENT_BYTE_SIZE", INT2FIX(sizeof(dtype)));
-  /**/
+  /* Stride size of contiguous DFloat array. */
   rb_define_const(cT, "CONTIGUOUS_STRIDE", INT2FIX(sizeof(dtype)));
-  /**/
+  /* Machine epsilon of DFloat. */
   rb_define_const(cT, "EPSILON", M_EPSILON);
-  /**/
+  /* The largest representable value of DFloat. */
   rb_define_const(cT, "MAX", M_MAX);
-  /**/
+  /* The smallest representable value of DFloat. */
   rb_define_const(cT, "MIN", M_MIN);
   rb_define_alloc_func(cT, dfloat_s_alloc_func);
   rb_define_method(cT, "allocate", dfloat_allocate, 0);
+  /**
+   * Extract an element only if self is a dimensionless NArray.
+   * @overload extract
+   *   @return [Numeric,Numo::NArray] Extract element value as Ruby Object
+   *     if self is a dimensionless NArray, otherwise returns self.
+   */
   rb_define_method(cT, "extract", dfloat_extract, 0);
-
+  /**
+   * Store elements to Numo::DFloat from other.
+   * @overload store(other)
+   *   @param [Object] other
+   *   @return [Numo::DFloat] self
+   */
   rb_define_method(cT, "store", dfloat_store, 1);
-
+  /**
+   * Cast object to Numo::DFloat.
+   * @overload cast(array)
+   *   @param [Numeric,Array] elements
+   *   @param [Array] array
+   *   @return [Numo::DFloat]
+   */
   rb_define_singleton_method(cT, "cast", dfloat_s_cast, 1);
+  /**
+   * Cast object to Numo::DFloat.
+   * @overload [](elements)
+   *   @param [Numeric,Array] elements
+   *   @param [Array] array
+   *   @return [Numo::DFloat]
+   */
+  rb_define_singleton_method(cT, "[]", dfloat_s_cast, -2);
+  /**
+   * Multi-dimensional element reference.
+   * @overload [](dim0,...,dimL)
+   *   @param [Numeric,Range,Array,Numo::Int32,Numo::Int64,Numo::Bit,Boolean,Symbol]
+   *     dim0,...,dimL  multi-dimensional indices.
+   *   @return [Numeric,Numo::DFloat] an element or NArray view.
+   * @see Numo::NArray#[]
+   * @see #[]=
+   */
   rb_define_method(cT, "[]", dfloat_aref, -1);
+  /**
+   * Multi-dimensional element assignment.
+   * @overload []=(dim0,...,dimL,val)
+   *   @param [Numeric,Range,Array,Numo::Int32,Numo::Int64,Numo::Bit,Boolean,Symbol]
+   *     dim0,...,dimL  multi-dimensional indices.
+   *   @param [Numeric,Numo::NArray,Array] val  Value(s) to be set to self.
+   *   @return [Numeric,Numo::NArray,Array] returns `val` (last argument).
+   * @see Numo::NArray#[]=
+   * @see #[]
+   */
   rb_define_method(cT, "[]=", dfloat_aset, -1);
+  /**
+   * Return NArray with cast to the type of self.
+   * @overload coerce_cast(type)
+   *   @return [nil]
+   */
   rb_define_method(cT, "coerce_cast", dfloat_coerce_cast, 1);
+  /**
+   * Convert self to Array.
+   * @overload to_a
+   *   @return [Array]
+   */
   rb_define_method(cT, "to_a", dfloat_to_a, 0);
+  /**
+   * Fill elements with other.
+   * @overload fill other
+   *   @param [Numeric] other
+   *   @return [Numo::DFloat] self.
+   */
   rb_define_method(cT, "fill", dfloat_fill, 1);
+  /**
+   * Format elements into strings.
+   * @overload format format
+   *   @param [String] format
+   *   @return [Numo::RObject] array of formatted strings.
+   */
   rb_define_method(cT, "format", dfloat_format, -1);
+  /**
+   * Format elements into strings.
+   * @overload format_to_a format
+   *   @param [String] format
+   *   @return [Array] array of formatted strings.
+   */
   rb_define_method(cT, "format_to_a", dfloat_format_to_a, -1);
+  /**
+   * Returns a string containing a human-readable representation of NArray.
+   * @overload inspect
+   *   @return [String]
+   */
   rb_define_method(cT, "inspect", dfloat_inspect, 0);
+  /**
+   * Calls the given block once for each element in self,
+   * passing that element as a parameter. For a block `{|x| ... }`,
+   * @overload each
+   *   @return [Numo::NArray] self
+   *   @yieldparam [Numeric] x  an element of NArray.
+   * @see #each_with_index
+   * @see #map
+   */
   rb_define_method(cT, "each", dfloat_each, 0);
+  /**
+   * Unary map.
+   * @overload map
+   *   @return [Numo::DFloat] map of self.
+   */
   rb_define_method(cT, "map", dfloat_map, 0);
+  /**
+   * Invokes the given block once for each element of self, passing that element
+   * and indices along each axis as parameters. For a block `{|x,i,j,...| ... }`,
+   * @overload each_with_index
+   *   @yieldparam [Numeric] x  an element
+   *   @yieldparam [Integer] i,j,...  multitimensional indices
+   *   @return [Numo::NArray] self
+   * @see #each
+   * @see #map_with_index
+   */
   rb_define_method(cT, "each_with_index", dfloat_each_with_index, 0);
+  /**
+   * Invokes the given block once for each element of self,
+   * passing that element and indices along each axis as parameters.
+   * Creates a new NArray containing the values returned by the block.
+   * Inplace option is allowed, i.e., `nary.inplace.map` overwrites `nary`.
+   * For a block `{|x,i,j,...| ... }`,
+   * @overload map_with_index
+   *   @yieldparam [Numeric] x  an element
+   *   @yieldparam [Integer] i,j,...  multitimensional indices
+   *   @return [Numo::NArray] mapped array
+   * @see #map
+   * @see #each_with_index
+   */
   rb_define_method(cT, "map_with_index", dfloat_map_with_index, 0);
+  /**
+   * abs of self.
+   * @overload abs
+   *   @return [Numo::DFloat] abs of self.
+   */
   rb_define_method(cT, "abs", dfloat_abs, 0);
+  /**
+   * Binary add.
+   * @overload + other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self + other
+   */
   rb_define_method(cT, "+", dfloat_add, 1);
+  /**
+   * Binary sub.
+   * @overload - other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self - other
+   */
   rb_define_method(cT, "-", dfloat_sub, 1);
+  /**
+   * Binary mul.
+   * @overload * other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self * other
+   */
   rb_define_method(cT, "*", dfloat_mul, 1);
+  /**
+   * Binary div.
+   * @overload / other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self / other
+   */
   rb_define_method(cT, "/", dfloat_div, 1);
+  /**
+   * Binary mod.
+   * @overload % other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self % other
+   */
   rb_define_method(cT, "%", dfloat_mod, 1);
+  /**
+   * Binary divmod.
+   * @overload divmod other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] divmod of self and other.
+   */
   rb_define_method(cT, "divmod", dfloat_divmod, 1);
+  /**
+   * Binary power.
+   * @overload ** other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self to the other-th power.
+   */
   rb_define_method(cT, "**", dfloat_pow, 1);
   rb_define_alias(cT, "pow", "**");
+  /**
+   * Unary minus.
+   * @overload -@
+   *   @return [Numo::DFloat] minus of self.
+   */
   rb_define_method(cT, "-@", dfloat_minus, 0);
+  /**
+   * Unary reciprocal.
+   * @overload reciprocal
+   *   @return [Numo::DFloat] reciprocal of self.
+   */
   rb_define_method(cT, "reciprocal", dfloat_reciprocal, 0);
+  /**
+   * Unary sign.
+   * @overload sign
+   *   @return [Numo::DFloat] sign of self.
+   */
   rb_define_method(cT, "sign", dfloat_sign, 0);
+  /**
+   * Unary square.
+   * @overload square
+   *   @return [Numo::DFloat] square of self.
+   */
   rb_define_method(cT, "square", dfloat_square, 0);
   rb_define_alias(cT, "conj", "view");
   rb_define_alias(cT, "im", "view");
   rb_define_alias(cT, "conjugate", "conj");
+  /**
+   * Comparison eq other.
+   * @overload eq other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::Bit] result of self eq other.
+   */
   rb_define_method(cT, "eq", dfloat_eq, 1);
+  /**
+   * Comparison ne other.
+   * @overload ne other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::Bit] result of self ne other.
+   */
   rb_define_method(cT, "ne", dfloat_ne, 1);
+  /**
+   * Comparison nearly_eq other.
+   * @overload nearly_eq other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::Bit] result of self nearly_eq other.
+   */
   rb_define_method(cT, "nearly_eq", dfloat_nearly_eq, 1);
   rb_define_alias(cT, "close_to", "nearly_eq");
+  /**
+   * Unary floor.
+   * @overload floor
+   *   @return [Numo::DFloat] floor of self.
+   */
   rb_define_method(cT, "floor", dfloat_floor, 0);
+  /**
+   * Unary round.
+   * @overload round
+   *   @return [Numo::DFloat] round of self.
+   */
   rb_define_method(cT, "round", dfloat_round, 0);
+  /**
+   * Unary ceil.
+   * @overload ceil
+   *   @return [Numo::DFloat] ceil of self.
+   */
   rb_define_method(cT, "ceil", dfloat_ceil, 0);
+  /**
+   * Unary trunc.
+   * @overload trunc
+   *   @return [Numo::DFloat] trunc of self.
+   */
   rb_define_method(cT, "trunc", dfloat_trunc, 0);
+  /**
+   * Unary rint.
+   * @overload rint
+   *   @return [Numo::DFloat] rint of self.
+   */
   rb_define_method(cT, "rint", dfloat_rint, 0);
+  /**
+   * Binary copysign.
+   * @overload copysign other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self copysign other
+   */
   rb_define_method(cT, "copysign", dfloat_copysign, 1);
+  /**
+   * Condition of signbit.
+   * @overload signbit
+   *   @return [Numo::Bit] Condition of signbit.
+   */
   rb_define_method(cT, "signbit", dfloat_signbit, 0);
+  /**
+   * modf of self.
+   * @overload modf
+   *   @return [Numo::DFloat] modf of self.
+   */
   rb_define_method(cT, "modf", dfloat_modf, 0);
+  /**
+   * Comparison gt other.
+   * @overload gt other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::Bit] result of self gt other.
+   */
   rb_define_method(cT, "gt", dfloat_gt, 1);
+  /**
+   * Comparison ge other.
+   * @overload ge other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::Bit] result of self ge other.
+   */
   rb_define_method(cT, "ge", dfloat_ge, 1);
+  /**
+   * Comparison lt other.
+   * @overload lt other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::Bit] result of self lt other.
+   */
   rb_define_method(cT, "lt", dfloat_lt, 1);
+  /**
+   * Comparison le other.
+   * @overload le other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::Bit] result of self le other.
+   */
   rb_define_method(cT, "le", dfloat_le, 1);
   rb_define_alias(cT, ">", "gt");
   rb_define_alias(cT, ">=", "ge");
   rb_define_alias(cT, "<", "lt");
   rb_define_alias(cT, "<=", "le");
+  /**
+   * Clip array elements by [min,max].
+   * If either of min or max is nil, one side is clipped.
+   * @overload clip(min,max)
+   *   @param [Numo::NArray,Numeric] min
+   *   @param [Numo::NArray,Numeric] max
+   *   @return [Numo::NArray] result of clip.
+   *
+   * @example
+   *     a = Numo::Int32.new(10).seq
+   *     # => Numo::Int32#shape=[10]
+   *     # [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+   *
+   *     a.clip(1,8)
+   *     # => Numo::Int32#shape=[10]
+   *     # [1, 1, 2, 3, 4, 5, 6, 7, 8, 8]
+   *
+   *     a.inplace.clip(3,6)
+   *     a
+   *     # => Numo::Int32#shape=[10]
+   *     # [3, 3, 3, 3, 4, 5, 6, 6, 6, 6]
+   *
+   *     b = Numo::Int32.new(10).seq
+   *     # => Numo::Int32#shape=[10]
+   *     # [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+   *
+   *     b.clip([3,4,1,1,1,4,4,4,4,4], 8)
+   *     # => Numo::Int32#shape=[10]
+   *     # [3, 4, 2, 3, 4, 5, 6, 7, 8, 8]
+   */
   rb_define_method(cT, "clip", dfloat_clip, 2);
+  /**
+   * Condition of isnan.
+   * @overload isnan
+   *   @return [Numo::Bit] Condition of isnan.
+   */
   rb_define_method(cT, "isnan", dfloat_isnan, 0);
+  /**
+   * Condition of isinf.
+   * @overload isinf
+   *   @return [Numo::Bit] Condition of isinf.
+   */
   rb_define_method(cT, "isinf", dfloat_isinf, 0);
+  /**
+   * Condition of isposinf.
+   * @overload isposinf
+   *   @return [Numo::Bit] Condition of isposinf.
+   */
   rb_define_method(cT, "isposinf", dfloat_isposinf, 0);
+  /**
+   * Condition of isneginf.
+   * @overload isneginf
+   *   @return [Numo::Bit] Condition of isneginf.
+   */
   rb_define_method(cT, "isneginf", dfloat_isneginf, 0);
+  /**
+   * Condition of isfinite.
+   * @overload isfinite
+   *   @return [Numo::Bit] Condition of isfinite.
+   */
   rb_define_method(cT, "isfinite", dfloat_isfinite, 0);
+  /**
+   * sum of self.
+   * @overload sum(axis:nil, keepdims:false, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or, return NaN for min/max etc).
+   *   @param [Numeric,Array,Range] axis  Performs sum along the axis.
+   *   @param [Boolean] keepdims  If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @return [Numo::DFloat] returns result of sum.
+   */
   rb_define_method(cT, "sum", dfloat_sum, -1);
+  /**
+   * prod of self.
+   * @overload prod(axis:nil, keepdims:false, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or, return NaN for min/max etc).
+   *   @param [Numeric,Array,Range] axis  Performs prod along the axis.
+   *   @param [Boolean] keepdims  If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @return [Numo::DFloat] returns result of prod.
+   */
   rb_define_method(cT, "prod", dfloat_prod, -1);
+  /**
+   * kahan_sum of self.
+   * @overload kahan_sum(axis:nil, keepdims:false, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or, return NaN for min/max etc).
+   *   @param [Numeric,Array,Range] axis  Performs kahan_sum along the axis.
+   *   @param [Boolean] keepdims  If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @return [Numo::DFloat] returns result of kahan_sum.
+   */
   rb_define_method(cT, "kahan_sum", dfloat_kahan_sum, -1);
+  /**
+   * mean of self.
+   * @overload mean(axis: nil, keepdims: false, nan: false)
+   *   @param axis [Numeric, Array, Range] Performs mean along the axis.
+   *   @param keepdims [Boolean] If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @param nan [Boolean] If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or return NaN for min/max etc).
+   *   @return [Numo::DFloat] returns result of mean.
+   */
   rb_define_method(cT, "mean", dfloat_mean, -1);
-  rb_define_method(cT, "stddev", dfloat_stddev, -1);
+  /**
+   * var of self.
+   * @overload var(axis: nil, keepdims: false, nan: false)
+   *   @param axis [Numeric, Array, Range] Performs var along the axis.
+   *   @param keepdims [Boolean] If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @param nan [Boolean] If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or, return NaN for min/max etc).
+   *   @return [Numo::DFloat] returns result of var.
+   */
   rb_define_method(cT, "var", dfloat_var, -1);
+  /**
+   * stddev of self.
+   * @overload stddev(axis: nil, keepdims: false, nan: false)
+   *   @param axis [Numeric, Array, Range] Performs stddev along the axis.
+   *   @param keepdims [Boolean] If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @param nan [Boolean] If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or, return NaN for min/max etc).
+   *   @return [Numo::DFloat] returns result of stddev.
+   */
+  rb_define_method(cT, "stddev", dfloat_stddev, -1);
+  /**
+   * rms of self.
+   * @overload rms(axis: nil, keepdims: false, nan: false)
+   *   @param axis [Numeric, Array, Range] Performs rms along the axis.
+   *   @param keepdims [Boolean] If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @param nan [Boolean] If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or, return NaN for min/max etc).
+   *   @return [Numo::DFloat] returns result of rms.
+   */
   rb_define_method(cT, "rms", dfloat_rms, -1);
+  /**
+   * min of self.
+   * @overload min(axis:nil, keepdims:false, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or, return NaN for min/max etc).
+   *   @param [Numeric,Array,Range] axis  Performs min along the axis.
+   *   @param [Boolean] keepdims  If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @return [Numo::DFloat] returns result of min.
+   */
   rb_define_method(cT, "min", dfloat_min, -1);
+  /**
+   * max of self.
+   * @overload max(axis:nil, keepdims:false, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or, return NaN for min/max etc).
+   *   @param [Numeric,Array,Range] axis  Performs max along the axis.
+   *   @param [Boolean] keepdims  If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @return [Numo::DFloat] returns result of max.
+   */
   rb_define_method(cT, "max", dfloat_max, -1);
+  /**
+   * ptp of self.
+   * @overload ptp(axis:nil, keepdims:false, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm
+   *     (avoid NaN for sum/mean etc, or, return NaN for min/max etc).
+   *   @param [Numeric,Array,Range] axis  Performs ptp along the axis.
+   *   @param [Boolean] keepdims  If true, the reduced axes are left in the result array as
+   *     dimensions with size one.
+   *   @return [Numo::DFloat] returns result of ptp.
+   */
   rb_define_method(cT, "ptp", dfloat_ptp, -1);
+  /**
+   * Index of the maximum value.
+   * @overload max_index(axis:nil, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm (return NaN posision if exist).
+   *   @param [Numeric,Array,Range] axis  Finds maximum values along the axis
+   *     and returns **flat 1-d indices**.
+   *   @return [Integer,Numo::Int] returns result indices.
+   * @see #argmax
+   * @see #max
+   *
+   * @example
+   *     a = Numo::NArray[3,4,1,2]
+   *     a.max_index  #=> 1
+   *
+   *     b = Numo::NArray[[3,4,1],[2,0,5]]
+   *     b.max_index             #=> 5
+   *     b.max_index(axis:1)     #=> [1, 5]
+   *     b.max_index(axis:0)     #=> [0, 1, 5]
+   *     b[b.max_index(axis:0)]  #=> [3, 4, 5]
+   */
   rb_define_method(cT, "max_index", dfloat_max_index, -1);
+  /**
+   * Index of the minimum value.
+   * @overload min_index(axis:nil, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm (return NaN posision if exist).
+   *   @param [Numeric,Array,Range] axis  Finds minimum values along the axis
+   *     and returns **flat 1-d indices**.
+   *   @return [Integer,Numo::Int] returns result indices.
+   * @see #argmin
+   * @see #min
+   *
+   * @example
+   *     a = Numo::NArray[3,4,1,2]
+   *     a.min_index  #=> 2
+   *
+   *     b = Numo::NArray[[3,4,1],[2,0,5]]
+   *     b.min_index             #=> 4
+   *     b.min_index(axis:1)     #=> [2, 4]
+   *     b.min_index(axis:0)     #=> [3, 4, 2]
+   *     b[b.min_index(axis:0)]  #=> [2, 0, 1]
+   */
   rb_define_method(cT, "min_index", dfloat_min_index, -1);
+  /**
+   * Index of the maximum value.
+   * @overload argmax(axis:nil, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm (return NaN posision if exist).
+   *   @param [Numeric,Array,Range] axis  Finds maximum values along the axis
+   *     and returns **indices along the axis**.
+   *   @return [Integer,Numo::Int] returns the result indices.
+   * @see #max_index
+   * @see #max
+   *
+   * @example
+   *     a = Numo::NArray[3,4,1,2]
+   *     a.argmax  #=> 1
+   *
+   *     b = Numo::NArray[[3,4,1],[2,0,5]]
+   *     b.argmax                       #=> 5
+   *     b.argmax(axis:1)               #=> [1, 2]
+   *     b.argmax(axis:0)               #=> [0, 0, 1]
+   *     b.at(b.argmax(axis:0), 0..-1)  #=> [3, 4, 5]
+   */
   rb_define_method(cT, "argmax", dfloat_argmax, -1);
+  /**
+   * Index of the minimum value.
+   * @overload argmin(axis:nil, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm (return NaN posision if exist).
+   *   @param [Numeric,Array,Range] axis  Finds minimum values along the axis
+   *     and returns **indices along the axis**.
+   *   @return [Integer,Numo::Int] returns the result indices.
+   * @see #min_index
+   * @see #min
+   *
+   * @example
+   *     a = Numo::NArray[3,4,1,2]
+   *     a.argmin  #=> 2
+   *
+   *     b = Numo::NArray[[3,4,1],[2,0,5]]
+   *     b.argmin                       #=> 4
+   *     b.argmin(axis:1)               #=> [2, 1]
+   *     b.argmin(axis:0)               #=> [1, 1, 0]
+   *     b.at(b.argmin(axis:0), 0..-1)  #=> [2, 0, 1]
+   */
   rb_define_method(cT, "argmin", dfloat_argmin, -1);
+  /**
+   * minmax of self.
+   * @overload minmax(axis:nil, keepdims:false, nan:false)
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm (return NaN if exist).
+   *   @param [Numeric,Array,Range] axis  Finds min-max along the axis.
+   *   @param [Boolean] keepdims (keyword) If true, the reduced axes are left
+   *     in the result array as dimensions with size one.
+   *   @return [Numo::DFloat,Numo::DFloat] min and max of self.
+   */
   rb_define_method(cT, "minmax", dfloat_minmax, -1);
+  /**
+   * Element-wise maximum of two arrays.
+   * @overload maximum(a1, a2, nan:false)
+   *   @param [Numo::NArray,Numeric] a1  The array to be compared.
+   *   @param [Numo::NArray,Numeric] a2  The array to be compared.
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm (return NaN if exist).
+   *   @return [Numo::DFloat]
+   */
   rb_define_module_function(cT, "maximum", dfloat_s_maximum, -1);
+  /**
+   * Element-wise minimum of two arrays.
+   * @overload minimum(a1, a2, nan:false)
+   *   @param [Numo::NArray,Numeric] a1  The array to be compared.
+   *   @param [Numo::NArray,Numeric] a2  The array to be compared.
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm (return NaN if exist).
+   *   @return [Numo::DFloat]
+   */
   rb_define_module_function(cT, "minimum", dfloat_s_minimum, -1);
+  /**
+   * cumsum of self.
+   * @overload cumsum(axis:nil, nan:false)
+   *   @param [Numeric,Array,Range] axis  Performs cumsum along the axis.
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm (avoid NaN if exists).
+   *   @return [Numo::DFloat] cumsum of self.
+   */
   rb_define_method(cT, "cumsum", dfloat_cumsum, -1);
+  /**
+   * cumprod of self.
+   * @overload cumprod(axis:nil, nan:false)
+   *   @param [Numeric,Array,Range] axis  Performs cumprod along the axis.
+   *   @param [Boolean] nan  If true, apply NaN-aware algorithm (avoid NaN if exists).
+   *   @return [Numo::DFloat] cumprod of self.
+   */
   rb_define_method(cT, "cumprod", dfloat_cumprod, -1);
+  /**
+   * Binary mulsum.
+   * @overload mulsum(other, axis:nil, keepdims:false, nan:false)
+   *   @param [Numo::NArray,Numeric] other
+   *   @param [Numeric,Array,Range] axis  Performs mulsum along the axis.
+   *   @param [Boolean] keepdims (keyword) If true, the reduced axes are left
+   *     in the result array as dimensions with size one.
+   *   @param [Boolean] nan (keyword) If true, apply NaN-aware algorithm (avoid NaN if exists).
+   *   @return [Numo::NArray] mulsum of self and other.
+   */
   rb_define_method(cT, "mulsum", dfloat_mulsum, -1);
+  /**
+   * Set linear sequence of numbers to self. The sequence is obtained from
+   *    beg+i*step
+   * where i is 1-dimensional index.
+   * @overload seq([beg,[step]])
+   *   @param [Numeric] beg  beginning of sequence. (default=0)
+   *   @param [Numeric] step  step of sequence. (default=1)
+   *   @return [Numo::DFloat] self.
+   * @example
+   *   Numo::DFloat.new(6).seq(1,-0.2)
+   *   # => Numo::DFloat#shape=[6]
+   *   # [1, 0.8, 0.6, 0.4, 0.2, 0]
+   *
+   *   Numo::DComplex.new(6).seq(1,-0.2+0.2i)
+   *   # => Numo::DComplex#shape=[6]
+   *   # [1+0i, 0.8+0.2i, 0.6+0.4i, 0.4+0.6i, 0.2+0.8i, 0+1i]
+   */
   rb_define_method(cT, "seq", dfloat_seq, -1);
+  /**
+   * Set logarithmic sequence of numbers to self. The sequence is obtained from
+   *    `base**(beg+i*step)`
+   * where i is 1-dimensional index.
+   * Applicable classes: DFloat, SFloat, DComplex, SCopmplex.
+   *
+   * @overload logseq(beg,step,[base])
+   *   @param [Numeric] beg  The beginning of sequence.
+   *   @param [Numeric] step  The step of sequence.
+   *   @param [Numeric] base  The base of log space. (default=10)
+   *   @return [Numo::DFloat] self.
+   *
+   * @example
+   *   Numo::DFloat.new(5).logseq(4,-1,2)
+   *   # => Numo::DFloat#shape=[5]
+   *   # [16, 8, 4, 2, 1]
+   *
+   *   Numo::DComplex.new(5).logseq(0,1i*Math::PI/3,Math::E)
+   *   # => Numo::DComplex#shape=[5]
+   *   # [1+7.26156e-310i, 0.5+0.866025i, -0.5+0.866025i, -1+1.22465e-16i, ...]
+   */
   rb_define_method(cT, "logseq", dfloat_logseq, -1);
+  /**
+   * Eye: Set a value to diagonal components, set 0 to non-diagonal components.
+   * @overload eye([element,offset])
+   *   @param [Numeric] element  Diagonal element to be stored. Default is 1.
+   *   @param [Integer] offset Diagonal offset from the main diagonal.
+   *     The default is 0. k>0 for diagonals above the main diagonal,
+   *     and k<0 for diagonals below the main diagonal.
+   *   @return [Numo::DFloat] eye of self.
+   */
   rb_define_method(cT, "eye", dfloat_eye, -1);
   rb_define_alias(cT, "indgen", "seq");
+  /**
+   * Generate uniformly distributed random numbers on self narray.
+   * @overload rand([[low],high])
+   *   @param [Numeric] low  lower inclusive boundary of random numbers. (default=0)
+   *   @param [Numeric] high  upper exclusive boundary of random numbers.
+   *     (default=1 or 1+1i for complex types)
+   *   @return [Numo::DFloat] self.
+   * @example
+   *   Numo::DFloat.new(6).rand
+   *   # => Numo::DFloat#shape=[6]
+   *   # [0.0617545, 0.373067, 0.794815, 0.201042, 0.116041, 0.344032]
+   *
+   *   Numo::DComplex.new(6).rand(5+5i)
+   *   # => Numo::DComplex#shape=[6]
+   *   # [2.69974+3.68908i, 0.825443+0.254414i, 0.540323+0.34354i, 4.52061+2.39322i, ...]
+   *
+   *   Numo::Int32.new(6).rand(2,5)
+   *   # => Numo::Int32#shape=[6]
+   *   # [4, 3, 3, 2, 4, 2]
+   */
   rb_define_method(cT, "rand", dfloat_rand, -1);
+  /**
+   * Generates random numbers from the normal distribution on self narray
+   * using Box-Muller Transformation.
+   * @overload rand_norm([mu,[sigma]])
+   *   @param [Numeric] mu  mean of normal distribution. (default=0)
+   *   @param [Numeric] sigma  standard deviation of normal distribution. (default=1)
+   *   @return [Numo::DFloat] self.
+   * @example
+   *   Numo::DFloat.new(5,5).rand_norm
+   *   # => Numo::DFloat#shape=[5,5]
+   *   # [[-0.581255, -0.168354, 0.586895, -0.595142, -0.802802],
+   *   #  [-0.326106, 0.282922, 1.68427, 0.918499, -0.0485384],
+   *   #  [-0.464453, -0.992194, 0.413794, -0.60717, -0.699695],
+   *   #  [-1.64168, 0.48676, -0.875871, -1.43275, 0.812172],
+   *   #  [-0.209975, -0.103612, -0.878617, -1.42495, 1.0968]]
+   *
+   *   Numo::DFloat.new(5,5).rand_norm(10,0.1)
+   *   # => Numo::DFloat#shape=[5,5]
+   *   # [[9.9019, 9.90339, 10.0826, 9.98384, 9.72861],
+   *   #  [9.81507, 10.0272, 9.91445, 10.0568, 9.88923],
+   *   #  [10.0234, 9.97874, 9.96011, 9.9006, 9.99964],
+   *   #  [10.0186, 9.94598, 9.92236, 9.99811, 9.97003],
+   *   #  [9.79266, 9.95044, 9.95212, 9.93692, 10.2027]]
+   *
+   *   Numo::DComplex.new(3,3).rand_norm(5+5i)
+   *   # => Numo::DComplex#shape=[3,3]
+   *   # [[5.84303+4.40052i, 4.00984+6.08982i, 5.10979+5.13215i],
+   *   #  [4.26477+3.99655i, 4.90052+5.00763i, 4.46607+2.3444i],
+   *   #  [4.5528+7.11003i, 5.62117+6.69094i, 5.05443+5.35133i]]
+   */
   rb_define_method(cT, "rand_norm", dfloat_rand_norm, -1);
+  /**
+   * Calculate polynomial.
+   *   `x.poly(a0,a1,a2,...,an) = a0 + a1*x + a2*x**2 + ... + an*x**n`
+   * @overload poly a0, a1, ..., an
+   *   @param [Numo::NArray,Numeric] a0,a1,...,an
+   *   @return [Numo::DFloat]
+   */
   rb_define_method(cT, "poly", dfloat_poly, -2);
-
+  /**
+   * sort of self.
+   * @overload sort(axis:nil, nan:false)
+   *   @param [Boolean] nan  If true, propagete NaN. If false, ignore NaN.
+   *   @param [Numeric,Array,Range] axis  Performs sort along the axis.
+   *   @return [Numo::DFloat] returns result of sort.
+   * @example
+   *   Numo::DFloat[3,4,1,2].sort #=> Numo::DFloat[1,2,3,4]
+   */
   rb_define_method(cT, "sort", dfloat_sort, -1);
-
+  /**
+   * sort_index. Returns an index array of sort result.
+   * @overload sort_index(axis:nil, nan:false)
+   *   @param [Boolean] nan  If true, propagete NaN. If false, ignore NaN.
+   *   @param [Numeric,Array,Range] axis  Performs sort_index along the axis.
+   *   @return [Integer,Numo::Int] returns result index of sort_index.
+   * @example
+   *   Numo::NArray[3,4,1,2].sort_index #=> Numo::Int32[2,3,0,1]
+   */
   rb_define_method(cT, "sort_index", dfloat_sort_index, -1);
+  /**
+   * median of self.
+   * @overload median(axis:nil, keepdims:false, nan:false)
+   *   @param [Boolean] nan (keyword) If true, propagete NaN. If false, ignore NaN.
+   *   @param [Numeric,Array,Range] axis  Finds median along the axis.
+   *   @param [Boolean] keepdims  If true, the reduced axes are left
+   *     in the result array as dimensions with size one.
+   * @return [Numo::DFloat] returns median of self.
+   */
   rb_define_method(cT, "median", dfloat_median, -1);
-  rb_define_singleton_method(cT, "[]", dfloat_s_cast, -2);
-
-  /*
-    Document-module: Numo::DFloat::NMath
-
-  */
 
+  /**
+   * Document-module: Numo::DFloat::Math
+   *
+   * This module contains mathematical functions for Numo::DFloat.
+   */
   mTM = rb_define_module_under(cT, "Math");
-
+  /**
+   * Calculate sqrt(x).
+   * @overload sqrt(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of sqrt(x).
+   */
   rb_define_module_function(mTM, "sqrt", dfloat_math_s_sqrt, 1);
+  /**
+   * Calculate cbrt(x).
+   * @overload cbrt(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of cbrt(x).
+   */
   rb_define_module_function(mTM, "cbrt", dfloat_math_s_cbrt, 1);
+  /**
+   * Calculate log(x).
+   * @overload log(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of log(x).
+   */
   rb_define_module_function(mTM, "log", dfloat_math_s_log, 1);
+  /**
+   * Calculate log2(x).
+   * @overload log2(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of log2(x).
+   */
   rb_define_module_function(mTM, "log2", dfloat_math_s_log2, 1);
+  /**
+   * Calculate log10(x).
+   * @overload log10(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of log10(x).
+   */
   rb_define_module_function(mTM, "log10", dfloat_math_s_log10, 1);
+  /**
+   * Calculate exp(x).
+   * @overload exp(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of exp(x).
+   */
   rb_define_module_function(mTM, "exp", dfloat_math_s_exp, 1);
+  /**
+   * Calculate exp2(x).
+   * @overload exp2(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of exp2(x).
+   */
   rb_define_module_function(mTM, "exp2", dfloat_math_s_exp2, 1);
+  /**
+   * Calculate exp10(x).
+   * @overload exp10(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of exp10(x).
+   */
   rb_define_module_function(mTM, "exp10", dfloat_math_s_exp10, 1);
+  /**
+   * Calculate sin(x).
+   * @overload sin(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of sin(x).
+   */
   rb_define_module_function(mTM, "sin", dfloat_math_s_sin, 1);
+  /**
+   * Calculate cos(x).
+   * @overload cos(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of cos(x).
+   */
   rb_define_module_function(mTM, "cos", dfloat_math_s_cos, 1);
+  /**
+   * Calculate tan(x).
+   * @overload tan(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of tan(x).
+   */
   rb_define_module_function(mTM, "tan", dfloat_math_s_tan, 1);
+  /**
+   * Calculate asin(x).
+   * @overload asin(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of asin(x).
+   */
   rb_define_module_function(mTM, "asin", dfloat_math_s_asin, 1);
+  /**
+   * Calculate acos(x).
+   * @overload acos(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of acos(x).
+   */
   rb_define_module_function(mTM, "acos", dfloat_math_s_acos, 1);
+  /**
+   * Calculate atan(x).
+   * @overload atan(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of atan(x).
+   */
   rb_define_module_function(mTM, "atan", dfloat_math_s_atan, 1);
+  /**
+   * Calculate sinh(x).
+   * @overload sinh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of sinh(x).
+   */
   rb_define_module_function(mTM, "sinh", dfloat_math_s_sinh, 1);
+  /**
+   * Calculate cosh(x).
+   * @overload cosh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of cosh(x).
+   */
   rb_define_module_function(mTM, "cosh", dfloat_math_s_cosh, 1);
+  /**
+   * Calculate tanh(x).
+   * @overload tanh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of tanh(x).
+   */
   rb_define_module_function(mTM, "tanh", dfloat_math_s_tanh, 1);
+  /**
+   * Calculate asinh(x).
+   * @overload asinh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of asinh(x).
+   */
   rb_define_module_function(mTM, "asinh", dfloat_math_s_asinh, 1);
+  /**
+   * Calculate acosh(x).
+   * @overload acosh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of acosh(x).
+   */
   rb_define_module_function(mTM, "acosh", dfloat_math_s_acosh, 1);
+  /**
+   * Calculate atanh(x).
+   * @overload atanh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of atanh(x).
+   */
   rb_define_module_function(mTM, "atanh", dfloat_math_s_atanh, 1);
+  /**
+   * Calculate sinc(x).
+   * @overload sinc(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of sinc(x).
+   */
   rb_define_module_function(mTM, "sinc", dfloat_math_s_sinc, 1);
+  /**
+   * Calculate atan2(a1,a2).
+   * @overload atan2(a1,a2)
+   *   @param [Numo::NArray,Numeric] a1  first value
+   *   @param [Numo::NArray,Numeric] a2  second value
+   *   @return [Numo::DFloat] atan2(a1,a2).
+   */
   rb_define_module_function(mTM, "atan2", dfloat_math_s_atan2, 2);
+  /**
+   * Calculate hypot(a1,a2).
+   * @overload hypot(a1,a2)
+   *   @param [Numo::NArray,Numeric] a1  first value
+   *   @param [Numo::NArray,Numeric] a2  second value
+   *   @return [Numo::DFloat] hypot(a1,a2).
+   */
   rb_define_module_function(mTM, "hypot", dfloat_math_s_hypot, 2);
+  /**
+   * Calculate erf(x).
+   * @overload erf(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of erf(x).
+   */
   rb_define_module_function(mTM, "erf", dfloat_math_s_erf, 1);
+  /**
+   * Calculate erfc(x).
+   * @overload erfc(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of erfc(x).
+   */
   rb_define_module_function(mTM, "erfc", dfloat_math_s_erfc, 1);
+  /**
+   * Calculate log1p(x).
+   * @overload log1p(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of log1p(x).
+   */
   rb_define_module_function(mTM, "log1p", dfloat_math_s_log1p, 1);
+  /**
+   * Calculate expm1(x).
+   * @overload expm1(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::DFloat] result of expm1(x).
+   */
   rb_define_module_function(mTM, "expm1", dfloat_math_s_expm1, 1);
+  /**
+   * Calculate ldexp(a1,a2).
+   * @overload ldexp(a1,a2)
+   *   @param [Numo::NArray,Numeric] a1  first value
+   *   @param [Numo::NArray,Numeric] a2  second value
+   *   @return [Numo::DFloat] ldexp(a1,a2).
+   */
   rb_define_module_function(mTM, "ldexp", dfloat_math_s_ldexp, 2);
+  /**
+   * split the number x into a normalized fraction and an exponent.
+   * Returns [mantissa, exponent], where x = mantissa * 2**exponent.
+   *
+   * @overload frexp(x)
+   *   @param [Numo::NArray,Numeric]  x
+   *   @return [Numo::DFloat,Numo::Int32]  mantissa and exponent.
+   */
   rb_define_module_function(mTM, "frexp", dfloat_math_s_frexp, 1);
 
   //  how to do this?