numo-narray-alt 0.9.5 → 0.9.6

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

@@ -36,14 +36,23 @@ static ID id_to_a;
 
 #include <numo/types/sfloat.h>
 
-VALUE cT;
-extern VALUE cRT;
-
 /*
   class definition: Numo::SFloat
 */
-
 VALUE cT;
+extern VALUE cRT;
+
+#include "mh/mean.h"
+#include "mh/var.h"
+#include "mh/stddev.h"
+#include "mh/rms.h"
+
+typedef float sfloat; // Type aliases for shorter notation
+                      // following the codebase naming convention.
+DEF_NARRAY_FLT_MEAN_METHOD_FUNC(sfloat, float, numo_cSFloat, numo_cSFloat)
+DEF_NARRAY_FLT_VAR_METHOD_FUNC(sfloat, float, numo_cSFloat, numo_cSFloat)
+DEF_NARRAY_FLT_STDDEV_METHOD_FUNC(sfloat, float, numo_cSFloat, numo_cSFloat)
+DEF_NARRAY_FLT_RMS_METHOD_FUNC(sfloat, float, numo_cSFloat, numo_cSFloat)
 
 static VALUE sfloat_store(VALUE, VALUE);
 
@@ -148,13 +157,6 @@ static VALUE sfloat_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 sfloat_extract(VALUE self) {
   volatile VALUE v;
   char* ptr;
@@ -892,12 +894,6 @@ static VALUE sfloat_store_array(VALUE self, VALUE rary) {
   return self;
 }
 
-/*
-  Store elements to Numo::SFloat from other.
-  @overload store(other)
-  @param [Object] other
-  @return [Numo::SFloat] self
-*/
 static VALUE sfloat_store(VALUE self, VALUE obj) {
   VALUE r, klass;
 
@@ -1104,14 +1100,6 @@ static VALUE sfloat_cast_array(VALUE rary) {
   return nary;
 }
 
-/*
-  Cast object to Numo::SFloat.
-  @overload [](elements)
-  @overload cast(array)
-  @param [Numeric,Array] elements
-  @param [Array] array
-  @return [Numo::SFloat]
-*/
 static VALUE sfloat_s_cast(VALUE type, VALUE obj) {
   VALUE v;
   narray_t* na;
@@ -1147,15 +1135,6 @@ static VALUE sfloat_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::SFloat] an element or NArray view.
-  @see Numo::NArray#[]
-  @see #[]=
- */
 static VALUE sfloat_aref(int argc, VALUE* argv, VALUE self) {
   int nd;
   size_t pos;
@@ -1170,16 +1149,6 @@ static VALUE sfloat_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 sfloat_aset(int argc, VALUE* argv, VALUE self) {
   int nd;
   size_t pos;
@@ -1204,11 +1173,6 @@ static VALUE sfloat_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 sfloat_coerce_cast(VALUE self, VALUE type) {
   return Qnil;
 }
@@ -1239,11 +1203,6 @@ static void iter_sfloat_to_a(na_loop_t* const lp) {
   }
 }
 
-/*
-  Convert self to Array.
-  @overload to_a
-  @return [Array]
-*/
 static VALUE sfloat_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_sfloat_fill(na_loop_t* const lp) {
   }
 }
 
-/*
-  Fill elements with other.
-  @overload fill other
-  @param [Numeric] other
-  @return [Numo::SFloat] self.
-*/
 static VALUE sfloat_fill(VALUE self, VALUE val) {
   ndfunc_arg_in_t ain[2] = { { OVERWRITE, 0 }, { sym_option } };
   ndfunc_t ndf = { iter_sfloat_fill, FULL_LOOP, 2, 0, ain, 0 };
@@ -1326,12 +1279,6 @@ static void iter_sfloat_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 sfloat_format(int argc, VALUE* argv, VALUE self) {
   VALUE fmt = Qnil;
 
@@ -1373,12 +1320,6 @@ static void iter_sfloat_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 sfloat_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_sfloat_inspect(char* ptr, size_t pos, VALUE fmt) {
   return format_sfloat(fmt, (dtype*)(ptr + pos));
 }
 
-/*
-  Returns a string containing a human-readable representation of NArray.
-  @overload inspect
-  @return [String]
-*/
 static VALUE sfloat_inspect(VALUE ary) {
   return na_ndloop_inspect(ary, iter_sfloat_inspect, Qnil);
 }
@@ -1426,16 +1362,6 @@ static void iter_sfloat_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 sfloat_each(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { Qnil, 0 } };
   ndfunc_t ndf = { iter_sfloat_each, FULL_LOOP_NIP, 1, 0, ain, 0 };
@@ -1506,11 +1432,6 @@ static void iter_sfloat_map(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary map.
-  @overload map
-  @return [Numo::SFloat] map of self.
-*/
 static VALUE sfloat_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_sfloat_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 sfloat_each_with_index(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { Qnil, 0 } };
   ndfunc_t ndf = { iter_sfloat_each_with_index, FULL_LOOP_NIP, 1, 0, ain, 0 };
@@ -1653,19 +1563,6 @@ static void iter_sfloat_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 sfloat_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_sfloat_abs(na_loop_t* const lp) {
   }
 }
 
-/*
-  abs of self.
-  @overload abs
-  @return [Numo::SFloat] abs of self.
-*/
 static VALUE sfloat_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 sfloat_abs(VALUE self) {
   return na_ndloop(&ndf, 1, self);
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_sfloat_add(na_loop_t* const lp) {
@@ -1948,12 +1840,6 @@ static VALUE sfloat_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 sfloat_add(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -1967,7 +1853,7 @@ static VALUE sfloat_add(VALUE self, VALUE other) {
   }
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_sfloat_sub(na_loop_t* const lp) {
@@ -2187,12 +2073,6 @@ static VALUE sfloat_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 sfloat_sub(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2206,7 +2086,7 @@ static VALUE sfloat_sub(VALUE self, VALUE other) {
   }
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_sfloat_mul(na_loop_t* const lp) {
@@ -2426,12 +2306,6 @@ static VALUE sfloat_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 sfloat_mul(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2445,7 +2319,7 @@ static VALUE sfloat_mul(VALUE self, VALUE other) {
   }
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_sfloat_div(na_loop_t* const lp) {
@@ -2665,12 +2539,6 @@ static VALUE sfloat_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 sfloat_div(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2684,7 +2552,7 @@ static VALUE sfloat_div(VALUE self, VALUE other) {
   }
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_sfloat_mod(na_loop_t* const lp) {
@@ -2783,12 +2651,6 @@ static VALUE sfloat_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 sfloat_mod(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2829,12 +2691,6 @@ static VALUE sfloat_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 sfloat_divmod(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2897,12 +2753,6 @@ static VALUE sfloat_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 sfloat_pow(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -2977,11 +2827,6 @@ static void iter_sfloat_minus(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary minus.
-  @overload -@
-  @return [Numo::SFloat] minus of self.
-*/
 static VALUE sfloat_minus(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3052,11 +2897,6 @@ static void iter_sfloat_reciprocal(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary reciprocal.
-  @overload reciprocal
-  @return [Numo::SFloat] reciprocal of self.
-*/
 static VALUE sfloat_reciprocal(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3127,11 +2967,6 @@ static void iter_sfloat_sign(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary sign.
-  @overload sign
-  @return [Numo::SFloat] sign of self.
-*/
 static VALUE sfloat_sign(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3202,11 +3037,6 @@ static void iter_sfloat_square(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary square.
-  @overload square
-  @return [Numo::SFloat] square of self.
-*/
 static VALUE sfloat_square(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3244,12 +3074,6 @@ static VALUE sfloat_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 sfloat_eq(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3291,12 +3115,6 @@ static VALUE sfloat_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 sfloat_ne(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3338,12 +3156,6 @@ static VALUE sfloat_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 sfloat_nearly_eq(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3418,11 +3230,6 @@ static void iter_sfloat_floor(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary floor.
-  @overload floor
-  @return [Numo::SFloat] floor of self.
-*/
 static VALUE sfloat_floor(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3493,11 +3300,6 @@ static void iter_sfloat_round(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary round.
-  @overload round
-  @return [Numo::SFloat] round of self.
-*/
 static VALUE sfloat_round(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3568,11 +3370,6 @@ static void iter_sfloat_ceil(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary ceil.
-  @overload ceil
-  @return [Numo::SFloat] ceil of self.
-*/
 static VALUE sfloat_ceil(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3643,11 +3440,6 @@ static void iter_sfloat_trunc(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary trunc.
-  @overload trunc
-  @return [Numo::SFloat] trunc of self.
-*/
 static VALUE sfloat_trunc(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3718,11 +3510,6 @@ static void iter_sfloat_rint(na_loop_t* const lp) {
   }
 }
 
-/*
-  Unary rint.
-  @overload rint
-  @return [Numo::SFloat] rint of self.
-*/
 static VALUE sfloat_rint(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -3731,7 +3518,7 @@ static VALUE sfloat_rint(VALUE self) {
   return na_ndloop(&ndf, 1, self);
 }
 
-#define check_intdivzero(y) \
+#define check_intdivzero(y)                                                                    \
   {}
 
 static void iter_sfloat_copysign(na_loop_t* const lp) {
@@ -3830,12 +3617,6 @@ static VALUE sfloat_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 sfloat_copysign(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3878,11 +3659,6 @@ static void iter_sfloat_signbit(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of signbit.
-  @overload signbit
-  @return [Numo::Bit] Condition of signbit.
-*/
 static VALUE sfloat_signbit(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -3908,11 +3684,6 @@ static void iter_sfloat_modf(na_loop_t* const lp) {
   }
 }
 
-/*
-  modf of self.
-  @overload modf
-  @return [Numo::SFloat] modf of self.
-*/
 static VALUE sfloat_modf(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[2] = { { cT, 0 }, { cT, 0 } };
@@ -3950,12 +3721,6 @@ static VALUE sfloat_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 sfloat_gt(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -3997,12 +3762,6 @@ static VALUE sfloat_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 sfloat_ge(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -4044,12 +3803,6 @@ static VALUE sfloat_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 sfloat_lt(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -4091,12 +3844,6 @@ static VALUE sfloat_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 sfloat_le(VALUE self, VALUE other) {
 
   VALUE klass, v;
@@ -4174,36 +3921,6 @@ static void iter_sfloat_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 sfloat_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 } };
@@ -4255,11 +3972,6 @@ static void iter_sfloat_isnan(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isnan.
-  @overload isnan
-  @return [Numo::Bit] Condition of isnan.
-*/
 static VALUE sfloat_isnan(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4297,11 +4009,6 @@ static void iter_sfloat_isinf(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isinf.
-  @overload isinf
-  @return [Numo::Bit] Condition of isinf.
-*/
 static VALUE sfloat_isinf(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4339,11 +4046,6 @@ static void iter_sfloat_isposinf(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isposinf.
-  @overload isposinf
-  @return [Numo::Bit] Condition of isposinf.
-*/
 static VALUE sfloat_isposinf(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4381,11 +4083,6 @@ static void iter_sfloat_isneginf(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isneginf.
-  @overload isneginf
-  @return [Numo::Bit] Condition of isneginf.
-*/
 static VALUE sfloat_isneginf(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4423,11 +4120,6 @@ static void iter_sfloat_isfinite(na_loop_t* const lp) {
   }
 }
 
-/*
-  Condition of isfinite.
-  @overload isfinite
-  @return [Numo::Bit] Condition of isfinite.
-*/
 static VALUE sfloat_isfinite(VALUE self) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { numo_cBit, 0 } };
@@ -4459,16 +4151,6 @@ static void iter_sfloat_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::SFloat] returns result of sum.
-*/
 static VALUE sfloat_sum(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4505,16 +4187,6 @@ static void iter_sfloat_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::SFloat] returns result of prod.
-*/
 static VALUE sfloat_prod(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4528,190 +4200,6 @@ static VALUE sfloat_prod(int argc, VALUE* argv, VALUE self) {
   return sfloat_extract(v);
 }
 
-static void iter_sfloat_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_sfloat_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::SFloat] returns result of mean.
-*/
-static VALUE sfloat_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_sfloat_mean, STRIDE_LOOP_NIP | NDF_FLAT_REDUCE, 2, 1, ain, aout };
-
-  reduce = na_reduce_dimension(argc, argv, 1, &self, &ndf, iter_sfloat_mean_nan);
-
-  v = na_ndloop(&ndf, 2, self, reduce);
-
-  return sfloat_extract(v);
-}
-
-static void iter_sfloat_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_sfloat_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::SFloat] returns result of stddev.
-*/
-static VALUE sfloat_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_sfloat_stddev, STRIDE_LOOP_NIP | NDF_FLAT_REDUCE, 2, 1, ain, aout };
-
-  reduce = na_reduce_dimension(argc, argv, 1, &self, &ndf, iter_sfloat_stddev_nan);
-
-  v = na_ndloop(&ndf, 2, self, reduce);
-
-  return rb_funcall(v, rb_intern("extract"), 0);
-}
-
-static void iter_sfloat_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_sfloat_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::SFloat] returns result of var.
-*/
-static VALUE sfloat_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_sfloat_var, STRIDE_LOOP_NIP | NDF_FLAT_REDUCE, 2, 1, ain, aout };
-
-  reduce = na_reduce_dimension(argc, argv, 1, &self, &ndf, iter_sfloat_var_nan);
-
-  v = na_ndloop(&ndf, 2, self, reduce);
-
-  return rb_funcall(v, rb_intern("extract"), 0);
-}
-
-static void iter_sfloat_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_sfloat_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::SFloat] returns result of rms.
-*/
-static VALUE sfloat_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_sfloat_rms, STRIDE_LOOP_NIP | NDF_FLAT_REDUCE, 2, 1, ain, aout };
-
-  reduce = na_reduce_dimension(argc, argv, 1, &self, &ndf, iter_sfloat_rms_nan);
-
-  v = na_ndloop(&ndf, 2, self, reduce);
-
-  return rb_funcall(v, rb_intern("extract"), 0);
-}
-
 static void iter_sfloat_min(na_loop_t* const lp) {
   size_t n;
   char *p1, *p2;
@@ -4735,16 +4223,6 @@ static void iter_sfloat_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::SFloat] returns result of min.
-*/
 static VALUE sfloat_min(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4781,16 +4259,6 @@ static void iter_sfloat_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::SFloat] returns result of max.
-*/
 static VALUE sfloat_max(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4827,16 +4295,6 @@ static void iter_sfloat_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::SFloat] returns result of ptp.
-*/
 static VALUE sfloat_ptp(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -4918,26 +4376,6 @@ static void iter_sfloat_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 sfloat_max_index(int argc, VALUE* argv, VALUE self) {
   narray_t* na;
   VALUE idx, reduce;
@@ -5036,26 +4474,6 @@ static void iter_sfloat_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 sfloat_min_index(int argc, VALUE* argv, VALUE self) {
   narray_t* na;
   VALUE idx, reduce;
@@ -5150,26 +4568,6 @@ static void iter_sfloat_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 sfloat_argmax(int argc, VALUE* argv, VALUE self) {
   narray_t* na;
   VALUE reduce;
@@ -5261,26 +4659,6 @@ static void iter_sfloat_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 sfloat_argmin(int argc, VALUE* argv, VALUE self) {
   narray_t* na;
   VALUE reduce;
@@ -5337,15 +4715,6 @@ static void iter_sfloat_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::SFloat,Numo::SFloat] min and max of self.
-*/
 static VALUE sfloat_minmax(int argc, VALUE* argv, VALUE self) {
   VALUE reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -5359,16 +4728,6 @@ static VALUE sfloat_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::SFloat]
-*/
-
 static void iter_sfloat_s_maximum(na_loop_t* const lp) {
   size_t i, n;
   char *p1, *p2, *p3;
@@ -5428,16 +4787,6 @@ static VALUE sfloat_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::SFloat]
-*/
-
 static void iter_sfloat_s_minimum(na_loop_t* const lp) {
   size_t i, n;
   char *p1, *p2, *p3;
@@ -5534,13 +4883,6 @@ static void iter_sfloat_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::SFloat] cumsum of self.
-*/
 static VALUE sfloat_cumsum(int argc, VALUE* argv, VALUE self) {
   VALUE reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -5591,13 +4933,6 @@ static void iter_sfloat_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::SFloat] cumprod of self.
-*/
 static VALUE sfloat_cumprod(int argc, VALUE* argv, VALUE self) {
   VALUE reduce;
   ndfunc_arg_in_t ain[2] = { { cT, 0 }, { sym_reduce, 0 } };
@@ -5702,17 +5037,6 @@ static VALUE sfloat_mulsum_self(int argc, VALUE* argv, VALUE self) {
   return sfloat_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 sfloat_mulsum(int argc, VALUE* argv, VALUE self) {
   //
   VALUE klass, v;
@@ -5775,23 +5099,6 @@ static void iter_sfloat_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::SFloat] 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 sfloat_seq(int argc, VALUE* args, VALUE self) {
   seq_opt_t* g;
   VALUE vbeg = Qnil, vstep = Qnil;
@@ -5854,27 +5161,6 @@ static void iter_sfloat_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::SFloat] 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 sfloat_logseq(int argc, VALUE* args, VALUE self) {
   logseq_opt_t* g;
   VALUE vbeg, vstep, vbase;
@@ -5923,15 +5209,6 @@ static void iter_sfloat_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::SFloat] eye of self.
-*/
 static VALUE sfloat_eye(int argc, VALUE* argv, VALUE self) {
   ndfunc_arg_in_t ain[1] = { { OVERWRITE, 2 } };
   ndfunc_t ndf = { iter_sfloat_eye, NO_LOOP, 1, 0, ain, 0 };
@@ -6024,26 +5301,6 @@ static void iter_sfloat_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::SFloat] 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 sfloat_rand(int argc, VALUE* args, VALUE self) {
   rand_opt_t g;
   VALUE v1 = Qnil, v2 = Qnil;
@@ -6123,36 +5380,6 @@ static void iter_sfloat_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::SFloat] 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 sfloat_rand_norm(int argc, VALUE* args, VALUE self) {
   int n;
   randn_opt_t g;
@@ -6191,13 +5418,6 @@ static void iter_sfloat_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::SFloat]
-*/
 static VALUE sfloat_poly(VALUE self, VALUE args) {
   int argc, i;
   VALUE* argv;
@@ -6283,27 +5503,27 @@ static VALUE sfloat_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
 
@@ -6314,19 +5534,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
 
@@ -6556,15 +5776,6 @@ static void iter_sfloat_sort_prnan(na_loop_t* const lp) {
   sfloat_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::SFloat] returns result of sort.
-  @example
-      Numo::DFloat[3,4,1,2].sort #=> Numo::DFloat[1,2,3,4]
-*/
 static VALUE sfloat_sort(int argc, VALUE* argv, VALUE self) {
   VALUE reduce;
   ndfunc_arg_in_t ain[2] = { { OVERWRITE, 0 }, { sym_reduce, 0 } };
@@ -6981,15 +6192,6 @@ static void sfloat_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 sfloat_sort_index(int argc, VALUE* argv, VALUE self) {
   size_t size;
   narray_t* na;
@@ -7075,16 +6277,6 @@ static void iter_sfloat_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::SFloat] returns median of self.
-*/
-
 static VALUE sfloat_median(int argc, VALUE* argv, VALUE self) {
   VALUE v, reduce;
   ndfunc_arg_in_t ain[2] = { { OVERWRITE, 0 }, { sym_reduce, 0 } };
@@ -7100,10 +6292,6 @@ static VALUE sfloat_median(int argc, VALUE* argv, VALUE self) {
   return sfloat_extract(v);
 }
 
-/*
-  module definition: Numo::SFloat::NMath
-*/
-
 VALUE mTM;
 
 static void iter_sfloat_math_s_sqrt(na_loop_t* const lp) {
@@ -7221,12 +6409,6 @@ static void iter_sfloat_math_s_sqrt(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate sqrt(x).
-  @overload sqrt(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of sqrt(x).
-*/
 static VALUE sfloat_math_s_sqrt(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7299,12 +6481,6 @@ static void iter_sfloat_math_s_cbrt(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate cbrt(x).
-  @overload cbrt(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of cbrt(x).
-*/
 static VALUE sfloat_math_s_cbrt(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7377,12 +6553,6 @@ static void iter_sfloat_math_s_log(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate log(x).
-  @overload log(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of log(x).
-*/
 static VALUE sfloat_math_s_log(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7455,12 +6625,6 @@ static void iter_sfloat_math_s_log2(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate log2(x).
-  @overload log2(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of log2(x).
-*/
 static VALUE sfloat_math_s_log2(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7533,12 +6697,6 @@ static void iter_sfloat_math_s_log10(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate log10(x).
-  @overload log10(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of log10(x).
-*/
 static VALUE sfloat_math_s_log10(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7611,12 +6769,6 @@ static void iter_sfloat_math_s_exp(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate exp(x).
-  @overload exp(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of exp(x).
-*/
 static VALUE sfloat_math_s_exp(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7689,12 +6841,6 @@ static void iter_sfloat_math_s_exp2(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate exp2(x).
-  @overload exp2(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of exp2(x).
-*/
 static VALUE sfloat_math_s_exp2(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7767,12 +6913,6 @@ static void iter_sfloat_math_s_exp10(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate exp10(x).
-  @overload exp10(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of exp10(x).
-*/
 static VALUE sfloat_math_s_exp10(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7845,12 +6985,6 @@ static void iter_sfloat_math_s_sin(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate sin(x).
-  @overload sin(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of sin(x).
-*/
 static VALUE sfloat_math_s_sin(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -7923,12 +7057,6 @@ static void iter_sfloat_math_s_cos(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate cos(x).
-  @overload cos(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of cos(x).
-*/
 static VALUE sfloat_math_s_cos(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8001,12 +7129,6 @@ static void iter_sfloat_math_s_tan(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate tan(x).
-  @overload tan(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of tan(x).
-*/
 static VALUE sfloat_math_s_tan(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8079,12 +7201,6 @@ static void iter_sfloat_math_s_asin(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate asin(x).
-  @overload asin(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of asin(x).
-*/
 static VALUE sfloat_math_s_asin(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8157,12 +7273,6 @@ static void iter_sfloat_math_s_acos(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate acos(x).
-  @overload acos(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of acos(x).
-*/
 static VALUE sfloat_math_s_acos(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8235,12 +7345,6 @@ static void iter_sfloat_math_s_atan(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate atan(x).
-  @overload atan(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of atan(x).
-*/
 static VALUE sfloat_math_s_atan(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8313,12 +7417,6 @@ static void iter_sfloat_math_s_sinh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate sinh(x).
-  @overload sinh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of sinh(x).
-*/
 static VALUE sfloat_math_s_sinh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8391,12 +7489,6 @@ static void iter_sfloat_math_s_cosh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate cosh(x).
-  @overload cosh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of cosh(x).
-*/
 static VALUE sfloat_math_s_cosh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8469,12 +7561,6 @@ static void iter_sfloat_math_s_tanh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate tanh(x).
-  @overload tanh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of tanh(x).
-*/
 static VALUE sfloat_math_s_tanh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8547,12 +7633,6 @@ static void iter_sfloat_math_s_asinh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate asinh(x).
-  @overload asinh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of asinh(x).
-*/
 static VALUE sfloat_math_s_asinh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8625,12 +7705,6 @@ static void iter_sfloat_math_s_acosh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate acosh(x).
-  @overload acosh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of acosh(x).
-*/
 static VALUE sfloat_math_s_acosh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8703,12 +7777,6 @@ static void iter_sfloat_math_s_atanh(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate atanh(x).
-  @overload atanh(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of atanh(x).
-*/
 static VALUE sfloat_math_s_atanh(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8781,12 +7849,6 @@ static void iter_sfloat_math_s_sinc(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate sinc(x).
-  @overload sinc(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of sinc(x).
-*/
 static VALUE sfloat_math_s_sinc(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8812,13 +7874,6 @@ static void iter_sfloat_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::SFloat] atan2(a1,a2).
-*/
 static VALUE sfloat_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 } };
@@ -8843,13 +7898,6 @@ static void iter_sfloat_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::SFloat] hypot(a1,a2).
-*/
 static VALUE sfloat_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 } };
@@ -8921,12 +7969,6 @@ static void iter_sfloat_math_s_erf(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate erf(x).
-  @overload erf(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of erf(x).
-*/
 static VALUE sfloat_math_s_erf(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -8999,12 +8041,6 @@ static void iter_sfloat_math_s_erfc(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate erfc(x).
-  @overload erfc(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of erfc(x).
-*/
 static VALUE sfloat_math_s_erfc(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -9077,12 +8113,6 @@ static void iter_sfloat_math_s_log1p(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate log1p(x).
-  @overload log1p(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of log1p(x).
-*/
 static VALUE sfloat_math_s_log1p(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -9155,12 +8185,6 @@ static void iter_sfloat_math_s_expm1(na_loop_t* const lp) {
   }
 }
 
-/*
-  Calculate expm1(x).
-  @overload expm1(x)
-  @param [Numo::NArray,Numeric] x  input value
-  @return [Numo::SFloat] result of expm1(x).
-*/
 static VALUE sfloat_math_s_expm1(VALUE mod, VALUE a1) {
   ndfunc_arg_in_t ain[1] = { { cT, 0 } };
   ndfunc_arg_out_t aout[1] = { { cT, 0 } };
@@ -9186,13 +8210,6 @@ static void iter_sfloat_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::SFloat] ldexp(a1,a2).
-*/
 static VALUE sfloat_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 } };
@@ -9218,15 +8235,6 @@ static void iter_sfloat_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::SFloat,Numo::Int32]  mantissa and exponent.
-
-*/
 static VALUE sfloat_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 } };
@@ -9254,16 +8262,18 @@ void Init_numo_sfloat(void) {
   id_nearly_eq = rb_intern("nearly_eq");
   id_to_a = rb_intern("to_a");
 
-  /*
-    Document-class: Numo::SFloat
-
-  */
+  /**
+   * Document-class: Numo::SFloat
+   *
+   * Single precision floating point number (32-bit float) N-dimensional array class.
+   */
   cT = rb_define_class_under(mNumo, "SFloat", cNArray);
 
   // alias of SFloat
   rb_define_const(mNumo, "Float32", numo_cSFloat);
 
   hCast = rb_hash_new();
+  /* Upcasting rules of SFloat. */
   rb_define_const(cT, "UPCAST", hCast);
   rb_hash_aset(hCast, rb_cArray, cT);
 
@@ -9290,147 +8300,995 @@ void Init_numo_sfloat(void) {
   rb_hash_aset(hCast, numo_cUInt8, numo_cSFloat);
   rb_obj_freeze(hCast);
 
-  /**/
+  /* Element size of SFloat in bits. */
   rb_define_const(cT, "ELEMENT_BIT_SIZE", INT2FIX(sizeof(dtype) * 8));
-  /**/
+  /* Element size of SFloat in bytes. */
   rb_define_const(cT, "ELEMENT_BYTE_SIZE", INT2FIX(sizeof(dtype)));
-  /**/
+  /* Stride size of contiguous SFloat array. */
   rb_define_const(cT, "CONTIGUOUS_STRIDE", INT2FIX(sizeof(dtype)));
-  /**/
+  /* Machine epsilon of SFloat */
   rb_define_const(cT, "EPSILON", M_EPSILON);
-  /**/
+  /* The largest respresentable value of SFloat */
   rb_define_const(cT, "MAX", M_MAX);
-  /**/
+  /* The smallest respresentable value of SFloat */
   rb_define_const(cT, "MIN", M_MIN);
   rb_define_alloc_func(cT, sfloat_s_alloc_func);
   rb_define_method(cT, "allocate", sfloat_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", sfloat_extract, 0);
-
+  /**
+   * Store elements to Numo::SFloat from other.
+   * @overload store(other)
+   *   @param [Object] other
+   *   @return [Numo::SFloat] self
+   */
   rb_define_method(cT, "store", sfloat_store, 1);
-
+  /**
+   * Cast object to Numo::SFloat.
+   * @overload cast(array)
+   *   @param [Numeric,Array] elements
+   *   @param [Array] array
+   *   @return [Numo::SFloat]
+   */
   rb_define_singleton_method(cT, "cast", sfloat_s_cast, 1);
+  /**
+   * Cast object to Numo::SFloat.
+   * @overload [](elements)
+   *   @param [Numeric,Array] elements
+   *   @param [Array] array
+   *   @return [Numo::SFloat]
+   */
+  rb_define_singleton_method(cT, "[]", sfloat_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::SFloat] an element or NArray view.
+   * @see Numo::NArray#[]
+   * @see #[]=
+   */
   rb_define_method(cT, "[]", sfloat_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, "[]=", sfloat_aset, -1);
+  /**
+   * Return NArray with cast to the type of self.
+   * @overload coerce_cast(type)
+   *   @return [nil]
+   */
   rb_define_method(cT, "coerce_cast", sfloat_coerce_cast, 1);
+  /**
+   * Convert self to Array.
+   * @overload to_a
+   *   @return [Array]
+   */
   rb_define_method(cT, "to_a", sfloat_to_a, 0);
+  /**
+   * Fill elements with other.
+   * @overload fill other
+   *   @param [Numeric] other
+   *   @return [Numo::SFloat] self.
+   */
   rb_define_method(cT, "fill", sfloat_fill, 1);
+  /**
+   * Format elements into strings.
+   * @overload format format
+   *   @param [String] format
+   *   @return [Numo::RObject] array of formatted strings.
+   */
   rb_define_method(cT, "format", sfloat_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", sfloat_format_to_a, -1);
+  /**
+   * Returns a string containing a human-readable representation of NArray.
+   * @overload inspect
+   *   @return [String]
+   */
   rb_define_method(cT, "inspect", sfloat_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", sfloat_each, 0);
+  /**
+   * Unary map.
+   * @overload map
+   *   @return [Numo::SFloat] map of self.
+   */
   rb_define_method(cT, "map", sfloat_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", sfloat_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", sfloat_map_with_index, 0);
+  /**
+   * abs of self.
+   * @overload abs
+   *   @return [Numo::SFloat] abs of self.
+   */
   rb_define_method(cT, "abs", sfloat_abs, 0);
+  /**
+   * Binary add.
+   * @overload + other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self + other
+   */
   rb_define_method(cT, "+", sfloat_add, 1);
+  /**
+   * Binary sub.
+   * @overload - other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self - other
+   */
   rb_define_method(cT, "-", sfloat_sub, 1);
+  /**
+   * Binary mul.
+   * @overload * other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self * other
+   */
   rb_define_method(cT, "*", sfloat_mul, 1);
+  /**
+   * Binary div.
+   * @overload / other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self / other
+   */
   rb_define_method(cT, "/", sfloat_div, 1);
+  /**
+   * Binary mod.
+   * @overload % other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self % other
+   */
   rb_define_method(cT, "%", sfloat_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", sfloat_divmod, 1);
+  /**
+   * Binary power.
+   * @overload ** other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self to the other-th power.
+   */
   rb_define_method(cT, "**", sfloat_pow, 1);
   rb_define_alias(cT, "pow", "**");
+  /**
+   * Unary minus.
+   * @overload -@
+   *   @return [Numo::SFloat] minus of self.
+   */
   rb_define_method(cT, "-@", sfloat_minus, 0);
+  /**
+   * Unary reciprocal.
+   * @overload reciprocal
+   *   @return [Numo::SFloat] reciprocal of self.
+   */
   rb_define_method(cT, "reciprocal", sfloat_reciprocal, 0);
+  /**
+   * Unary sign.
+   * @overload sign
+   *   @return [Numo::SFloat] sign of self.
+   */
   rb_define_method(cT, "sign", sfloat_sign, 0);
+  /**
+   * Unary square.
+   * @overload square
+   *   @return [Numo::SFloat] square of self.
+   */
   rb_define_method(cT, "square", sfloat_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", sfloat_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", sfloat_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", sfloat_nearly_eq, 1);
   rb_define_alias(cT, "close_to", "nearly_eq");
+  /**
+   * Unary floor.
+   * @overload floor
+   *   @return [Numo::SFloat] floor of self.
+   */
   rb_define_method(cT, "floor", sfloat_floor, 0);
+  /**
+   * Unary round.
+   * @overload round
+   *   @return [Numo::SFloat] round of self.
+   */
   rb_define_method(cT, "round", sfloat_round, 0);
+  /**
+   * Unary ceil.
+   * @overload ceil
+   *   @return [Numo::SFloat] ceil of self.
+   */
   rb_define_method(cT, "ceil", sfloat_ceil, 0);
+  /**
+   * Unary trunc.
+   * @overload trunc
+   *   @return [Numo::SFloat] trunc of self.
+   */
   rb_define_method(cT, "trunc", sfloat_trunc, 0);
+  /**
+   * Unary rint.
+   * @overload rint
+   *   @return [Numo::SFloat] rint of self.
+   */
   rb_define_method(cT, "rint", sfloat_rint, 0);
+  /**
+   * Binary copysign.
+   * @overload copysign other
+   *   @param [Numo::NArray,Numeric] other
+   *   @return [Numo::NArray] self copysign other
+   */
   rb_define_method(cT, "copysign", sfloat_copysign, 1);
+  /**
+   * Condition of signbit.
+   * @overload signbit
+   *   @return [Numo::Bit] Condition of signbit.
+   */
   rb_define_method(cT, "signbit", sfloat_signbit, 0);
+  /**
+   * modf of self.
+   * @overload modf
+   *   @return [Numo::SFloat] modf of self.
+   */
   rb_define_method(cT, "modf", sfloat_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", sfloat_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", sfloat_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", sfloat_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", sfloat_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", sfloat_clip, 2);
+  /**
+   * Condition of isnan.
+   * @overload isnan
+   *   @return [Numo::Bit] Condition of isnan.
+   */
   rb_define_method(cT, "isnan", sfloat_isnan, 0);
+  /**
+   * Condition of isinf.
+   * @overload isinf
+   *   @return [Numo::Bit] Condition of isinf.
+   */
   rb_define_method(cT, "isinf", sfloat_isinf, 0);
+  /**
+   * Condition of isposinf.
+   * @overload isposinf
+   *   @return [Numo::Bit] Condition of isposinf.
+   */
   rb_define_method(cT, "isposinf", sfloat_isposinf, 0);
+  /**
+   * Condition of isneginf.
+   * @overload isneginf
+   *   @return [Numo::Bit] Condition of isneginf.
+   */
   rb_define_method(cT, "isneginf", sfloat_isneginf, 0);
+  /**
+   * Condition of isfinite.
+   * @overload isfinite
+   *   @return [Numo::Bit] Condition of isfinite.
+   */
   rb_define_method(cT, "isfinite", sfloat_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::SFloat] returns result of sum.
+   */
   rb_define_method(cT, "sum", sfloat_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::SFloat] returns result of prod.
+   */
   rb_define_method(cT, "prod", sfloat_prod, -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::SFloat] returns result of mean.
+   */
   rb_define_method(cT, "mean", sfloat_mean, -1);
-  rb_define_method(cT, "stddev", sfloat_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::SFloat] returns result of var.
+   */
   rb_define_method(cT, "var", sfloat_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::SFloat] returns result of stddev.
+   */
+  rb_define_method(cT, "stddev", sfloat_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::SFloat] returns result of rms.
+   */
   rb_define_method(cT, "rms", sfloat_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::SFloat] returns result of min.
+   */
   rb_define_method(cT, "min", sfloat_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::SFloat] returns result of max.
+   */
   rb_define_method(cT, "max", sfloat_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::SFloat] returns result of ptp.
+   */
   rb_define_method(cT, "ptp", sfloat_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", sfloat_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", sfloat_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", sfloat_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", sfloat_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::SFloat,Numo::SFloat] min and max of self.
+   */
   rb_define_method(cT, "minmax", sfloat_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::SFloat]
+   */
   rb_define_module_function(cT, "maximum", sfloat_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::SFloat]
+   */
   rb_define_module_function(cT, "minimum", sfloat_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::SFloat] cumsum of self.
+   */
   rb_define_method(cT, "cumsum", sfloat_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::SFloat] cumprod of self.
+   */
   rb_define_method(cT, "cumprod", sfloat_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", sfloat_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::SFloat] 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", sfloat_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::SFloat] 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", sfloat_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::SFloat] eye of self.
+   */
   rb_define_method(cT, "eye", sfloat_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::SFloat] 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", sfloat_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::SFloat] 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", sfloat_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::SFloat]
+   */
   rb_define_method(cT, "poly", sfloat_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::SFloat] returns result of sort.
+   * @example
+   *   Numo::DFloat[3,4,1,2].sort #=> Numo::DFloat[1,2,3,4]
+   */
   rb_define_method(cT, "sort", sfloat_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", sfloat_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::SFloat] returns median of self.
+   */
   rb_define_method(cT, "median", sfloat_median, -1);
-  rb_define_singleton_method(cT, "[]", sfloat_s_cast, -2);
-
-  /*
-    Document-module: Numo::SFloat::NMath
-
-  */
 
+  /**
+   * Document-module: Numo::SFloat::Math
+   *
+   * This module contains mathematical functions for Numo::SFloat.
+   */
   mTM = rb_define_module_under(cT, "Math");
-
+  /**
+   * Calculate sqrt(x).
+   * @overload sqrt(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of sqrt(x).
+   */
   rb_define_module_function(mTM, "sqrt", sfloat_math_s_sqrt, 1);
+  /**
+   * Calculate cbrt(x).
+   * @overload cbrt(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of cbrt(x).
+   */
   rb_define_module_function(mTM, "cbrt", sfloat_math_s_cbrt, 1);
+  /**
+   * Calculate log(x).
+   * @overload log(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of log(x).
+   */
   rb_define_module_function(mTM, "log", sfloat_math_s_log, 1);
+  /**
+   * Calculate log2(x).
+   * @overload log2(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of log2(x).
+   */
   rb_define_module_function(mTM, "log2", sfloat_math_s_log2, 1);
+  /**
+   * Calculate log10(x).
+   * @overload log10(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of log10(x).
+   */
   rb_define_module_function(mTM, "log10", sfloat_math_s_log10, 1);
+  /**
+   * Calculate exp(x).
+   * @overload exp(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of exp(x).
+   */
   rb_define_module_function(mTM, "exp", sfloat_math_s_exp, 1);
+  /**
+   * Calculate exp2(x).
+   * @overload exp2(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of exp2(x).
+   */
   rb_define_module_function(mTM, "exp2", sfloat_math_s_exp2, 1);
+  /**
+   * Calculate exp10(x).
+   * @overload exp10(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of exp10(x).
+   */
   rb_define_module_function(mTM, "exp10", sfloat_math_s_exp10, 1);
+  /**
+   * Calculate sin(x).
+   * @overload sin(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of sin(x).
+   */
   rb_define_module_function(mTM, "sin", sfloat_math_s_sin, 1);
+  /**
+   * Calculate cos(x).
+   * @overload cos(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of cos(x).
+   */
   rb_define_module_function(mTM, "cos", sfloat_math_s_cos, 1);
+  /**
+   * Calculate tan(x).
+   * @overload tan(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of tan(x).
+   */
   rb_define_module_function(mTM, "tan", sfloat_math_s_tan, 1);
+  /**
+   * Calculate asin(x).
+   * @overload asin(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of asin(x).
+   */
   rb_define_module_function(mTM, "asin", sfloat_math_s_asin, 1);
+  /**
+   * Calculate acos(x).
+   * @overload acos(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of acos(x).
+   */
   rb_define_module_function(mTM, "acos", sfloat_math_s_acos, 1);
+  /**
+   * Calculate atan(x).
+   * @overload atan(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of atan(x).
+   */
   rb_define_module_function(mTM, "atan", sfloat_math_s_atan, 1);
+  /**
+   * Calculate sinh(x).
+   * @overload sinh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of sinh(x).
+   */
   rb_define_module_function(mTM, "sinh", sfloat_math_s_sinh, 1);
+  /**
+   * Calculate cosh(x).
+   * @overload cosh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of cosh(x).
+   */
   rb_define_module_function(mTM, "cosh", sfloat_math_s_cosh, 1);
+  /**
+   * Calculate tanh(x).
+   * @overload tanh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of tanh(x).
+   */
   rb_define_module_function(mTM, "tanh", sfloat_math_s_tanh, 1);
+  /**
+   * Calculate asinh(x).
+   * @overload asinh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of asinh(x).
+   */
   rb_define_module_function(mTM, "asinh", sfloat_math_s_asinh, 1);
+  /**
+   * Calculate acosh(x).
+   * @overload acosh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of acosh(x).
+   */
   rb_define_module_function(mTM, "acosh", sfloat_math_s_acosh, 1);
+  /**
+   * Calculate atanh(x).
+   * @overload atanh(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of atanh(x).
+   */
   rb_define_module_function(mTM, "atanh", sfloat_math_s_atanh, 1);
+  /**
+   * Calculate sinc(x).
+   * @overload sinc(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of sinc(x).
+   */
   rb_define_module_function(mTM, "sinc", sfloat_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::SFloat] atan2(a1,a2).
+   */
   rb_define_module_function(mTM, "atan2", sfloat_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::SFloat] hypot(a1,a2).
+   */
   rb_define_module_function(mTM, "hypot", sfloat_math_s_hypot, 2);
+  /**
+   * Calculate erf(x).
+   * @overload erf(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of erf(x).
+   */
   rb_define_module_function(mTM, "erf", sfloat_math_s_erf, 1);
+  /**
+   * Calculate erfc(x).
+   * @overload erfc(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of erfc(x).
+   */
   rb_define_module_function(mTM, "erfc", sfloat_math_s_erfc, 1);
+  /**
+   * Calculate log1p(x).
+   * @overload log1p(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of log1p(x).
+   */
   rb_define_module_function(mTM, "log1p", sfloat_math_s_log1p, 1);
+  /**
+   * Calculate expm1(x).
+   * @overload expm1(x)
+   *   @param [Numo::NArray,Numeric] x  input value
+   *   @return [Numo::SFloat] result of expm1(x).
+   */
   rb_define_module_function(mTM, "expm1", sfloat_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::SFloat] ldexp(a1,a2).
+   */
   rb_define_module_function(mTM, "ldexp", sfloat_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::SFloat,Numo::Int32]  mantissa and exponent.
+   */
   rb_define_module_function(mTM, "frexp", sfloat_math_s_frexp, 1);
 
   //  how to do this?