cumo 0.5.0 → 0.5.1

data/ext/cumo/narray/data.c

@@ -195,21 +195,21 @@ check_axis(int axis, int ndim)
   @example
     x = Cumo::Int32[[1,2,3]]
 
-    p x.swapaxes(0,1)
-    # Cumo::Int32(view)#shape=[3,1]
+    x.swapaxes(0,1)
+    # => Cumo::Int32(view)#shape=[3,1]
     # [[1],
     #  [2],
     #  [3]]
 
-    p x = Cumo::Int32[[[0,1],[2,3]],[[4,5],[6,7]]]
-    # Cumo::Int32#shape=[2,2,2]
+    x = Cumo::Int32[[[0,1],[2,3]],[[4,5],[6,7]]]
+    # => Cumo::Int32#shape=[2,2,2]
     # [[[0, 1],
     #   [2, 3]],
     #  [[4, 5],
     #   [6, 7]]]
 
-    p x.swapaxes(0,2)
-    # Cumo::Int32(view)#shape=[2,2,2]
+    x.swapaxes(0,2)
+    # => Cumo::Int32(view)#shape=[2,2,2]
     # [[[0, 4],
     #   [2, 6]],
     #  [[1, 5],
@@ -510,7 +510,6 @@ cumo_na_flatten_dim(VALUE self, int sd)
     case CUMO_NARRAY_FILEMAP_T:
         stride = cumo_na_element_stride(self);
         for (i=sd+1; i--; ) {
-            //printf("data: i=%d shpae[i]=%ld stride=%ld\n",i,shape[i],stride);
             CUMO_SDX_SET_STRIDE(na2->stridx[i],stride);
             stride *= shape[i];
         }
@@ -533,12 +532,10 @@ cumo_na_flatten_dim(VALUE self, int sd)
                 CUMO_SDX_SET_INDEX(na2->stridx[i],idx2);
             } else {
                 na2->stridx[i] = na1->stridx[i];
-                //printf("view: i=%d stridx=%d\n",i,CUMO_SDX_GET_STRIDE(sdx));
             }
         }
         // flat dimenion == last dimension
         if (RTEST(cumo_na_check_ladder(self,sd))) {
-        //if (0) {
             na2->stridx[sd] = na1->stridx[nd-1];
         } else {
             // set index
@@ -607,28 +604,30 @@ void cumo_na_diagonal_stride_index_kernel_launch(size_t *idx, ssize_t s0, size_t
   @return [Cumo::NArray]  diagonal view of NArray.
   @example
     a = Cumo::DFloat.new(4,5).seq
-    => Cumo::DFloat#shape=[4,5]
-    [[0, 1, 2, 3, 4],
-     [5, 6, 7, 8, 9],
-     [10, 11, 12, 13, 14],
-     [15, 16, 17, 18, 19]]
+    # => Cumo::DFloat#shape=[4,5]
+    # [[0, 1, 2, 3, 4],
+    #  [5, 6, 7, 8, 9],
+    #  [10, 11, 12, 13, 14],
+    #  [15, 16, 17, 18, 19]]
     b = a.diagonal(1)
-    => Cumo::DFloat(view)#shape=[4]
-    [1, 7, 13, 19]
+    # => Cumo::DFloat(view)#shape=[4]
+    # [1, 7, 13, 19]
+
     b.store(0)
     a
-    => Cumo::DFloat#shape=[4,5]
-    [[0, 0, 2, 3, 4],
-     [5, 6, 0, 8, 9],
-     [10, 11, 12, 0, 14],
-     [15, 16, 17, 18, 0]]
+    # => Cumo::DFloat#shape=[4,5]
+    # [[0, 0, 2, 3, 4],
+    #  [5, 6, 0, 8, 9],
+    #  [10, 11, 12, 0, 14],
+    #  [15, 16, 17, 18, 0]]
+
     b.store([1,2,3,4])
     a
-    => Cumo::DFloat#shape=[4,5]
-    [[0, 1, 2, 3, 4],
-     [5, 6, 2, 8, 9],
-     [10, 11, 12, 3, 14],
-     [15, 16, 17, 18, 4]]
+    # => Cumo::DFloat#shape=[4,5]
+    # [[0, 1, 2, 3, 4],
+    #  [5, 6, 2, 8, 9],
+    #  [10, 11, 12, 3, 14],
+    #  [15, 16, 17, 18, 4]]
  */
 static VALUE
 cumo_na_diagonal(int argc, VALUE *argv, VALUE self)

data/ext/cumo/narray/gen/tmpl/accum.c

@@ -56,8 +56,8 @@ static void
 <% else %>
   @overload <%=name%>(axis:nil, keepdims:false)
 <% end %>
-  @param [Numeric,Array,Range] axis (keyword) Affected dimensions.
-  @param [TrueClass] keepdims (keyword) If true, the reduced axes are left in the result array as dimensions with size one.
+  @param [Numeric,Array,Range] axis  Performs <%=name%> along the axis.
+  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as dimensions with size one.
   @return [Cumo::<%=class_name%>] returns result of <%=name%>.
 */
 static VALUE

data/ext/cumo/narray/gen/tmpl/accum_binary.c

@@ -91,7 +91,7 @@ static VALUE
   @overload <%=op_map%>(other, axis:nil, keepdims:false)
 <% end %>
   @param [Cumo::NArray,Numeric] other
-  @param [Numeric,Array,Range] axis (keyword) Affected dimensions.
+  @param [Numeric,Array,Range] axis  Performs <%=name%> along the axis.
   @param [TrueClass] keepdims (keyword) If true, the reduced axes are left in the result array as dimensions with size one.
 <% if is_float %>
   @param [TrueClass] nan (keyword) If true, apply NaN-aware algorithm (avoid NaN if exists).

data/ext/cumo/narray/gen/tmpl/aref.c

@@ -21,35 +21,35 @@ static VALUE
 
   @example
       a = Cumo::DFloat.new(4,5).seq
-      => Cumo::DFloat#shape=[4,5]
-      [[0, 1, 2, 3, 4],
-       [5, 6, 7, 8, 9],
-       [10, 11, 12, 13, 14],
-       [15, 16, 17, 18, 19]]
+      # => Cumo::DFloat#shape=[4,5]
+      # [[0, 1, 2, 3, 4],
+      #  [5, 6, 7, 8, 9],
+      #  [10, 11, 12, 13, 14],
+      #  [15, 16, 17, 18, 19]]
 
       a[7]
-      => Cumo::DFloat#shape=[]
-      6.0
+      # => Cumo::DFloat#shape=[]
+      # 6.0
 
       a[1,1]
-      => Cumo::DFloat#shape=[]
-      6.0
+      # => Cumo::DFloat#shape=[]
+      # 6.0
 
       a[1..3,1]
-      => Cumo::DFloat#shape=[3]
-      [6, 11, 16]
+      # => Cumo::DFloat#shape=[3]
+      # [6, 11, 16]
 
       a[1,[1,3,4]]
-      => Cumo::DFloat#shape=[3]
-      [6, 8, 9]
+      # => Cumo::DFloat#shape=[3]
+      # [6, 8, 9]
 
       a[true,2].fill(99)
       a
-      => Cumo::DFloat#shape=[4,5]
-      [[0, 1, 99, 3, 4],
-       [5, 6, 99, 8, 9],
-       [10, 11, 99, 13, 14],
-       [15, 16, 99, 18, 19]]
+      # => Cumo::DFloat#shape=[4,5]
+      # [[0, 1, 99, 3, 4],
+      #  [5, 6, 99, 8, 9],
+      #  [10, 11, 99, 13, 14],
+      #  [15, 16, 99, 18, 19]]
  */
 static VALUE
 <%=c_func(-1)%>(int argc, VALUE *argv, VALUE self)

data/ext/cumo/narray/gen/tmpl/aset.c

@@ -10,31 +10,31 @@
 
   @example
       a = Cumo::DFloat.new(3,4).seq
-      => Cumo::DFloat#shape=[3,4]
-      [[0, 1, 2, 3],
-       [4, 5, 6, 7],
-       [8, 9, 10, 11]]
+      # => Cumo::DFloat#shape=[3,4]
+      # [[0, 1, 2, 3],
+      #  [4, 5, 6, 7],
+      #  [8, 9, 10, 11]]
 
       a[1,2]=99
       a
-      => Cumo::DFloat#shape=[3,4]
-      [[0, 1, 2, 3],
-       [4, 5, 99, 7],
-       [8, 9, 10, 11]]
+      # => Cumo::DFloat#shape=[3,4]
+      # [[0, 1, 2, 3],
+      #  [4, 5, 99, 7],
+      #  [8, 9, 10, 11]]
 
       a[1,[0,2]] = [101,102]
       a
-      => Cumo::DFloat#shape=[3,4]
-      [[0, 1, 2, 3],
-       [101, 5, 102, 7],
-       [8, 9, 10, 11]]
+      # => Cumo::DFloat#shape=[3,4]
+      # [[0, 1, 2, 3],
+      #  [101, 5, 102, 7],
+      #  [8, 9, 10, 11]]
 
       a[1,true]=99
       a
-      => Cumo::DFloat#shape=[3,4]
-      [[0, 1, 2, 3],
-       [99, 99, 99, 99],
-       [8, 9, 10, 11]]
+      # => Cumo::DFloat#shape=[3,4]
+      # [[0, 1, 2, 3],
+      #  [99, 99, 99, 99],
+      #  [8, 9, 10, 11]]
 
 */
 static VALUE

data/ext/cumo/narray/gen/tmpl/batch_norm.c

@@ -157,8 +157,11 @@ static VALUE
     status = cumo_cuda_cudnn_CreateTensorDescriptor(&x_desc, x_cont, cudnn_dtype);
     if (status != CUDNN_STATUS_SUCCESS) goto BATCH_NORM_ERROR;
 
+    status = cudnnCreateTensorDescriptor(&bn_desc);
+    if (status != CUDNN_STATUS_SUCCESS) goto BATCH_NORM_ERROR;
+
     mode = cumo_cuda_cudnn_GetBatchNormMode(axis_ndim, int_axis);
-    status = cumo_cuda_cudnn_CreateBNTensorDescriptor(&bn_desc, x_desc, mode);
+    status = cudnnDeriveBNTensorDescriptor(bn_desc, x_desc, mode);
     if (status != CUDNN_STATUS_SUCCESS) goto BATCH_NORM_ERROR;
     // TODO: bn_desc may return another type, and may need to cast gamma, beta, mean, var
 

data/ext/cumo/narray/gen/tmpl/batch_norm_backward.c

@@ -134,8 +134,11 @@ static VALUE
     status = cumo_cuda_cudnn_CreateTensorDescriptor(&x_desc, x_cont, cudnn_dtype);
     if (status != CUDNN_STATUS_SUCCESS) goto BATCH_NORM_BACKWARD_ERROR;
 
+    status = cudnnCreateTensorDescriptor(&bn_desc);
+    if (status != CUDNN_STATUS_SUCCESS) goto BATCH_NORM_BACKWARD_ERROR;
+
     mode = cumo_cuda_cudnn_GetBatchNormMode(axis_ndim, int_axis);
-    status = cumo_cuda_cudnn_CreateBNTensorDescriptor(&bn_desc, x_desc, mode);
+    status = cudnnDeriveBNTensorDescriptor(bn_desc, x_desc, mode);
     if (status != CUDNN_STATUS_SUCCESS) goto BATCH_NORM_BACKWARD_ERROR;
     // TODO: bn_desc may return another type, and may need to cast gamma, gy, mean, var
 

data/ext/cumo/narray/gen/tmpl/bincount.c

@@ -116,22 +116,22 @@ static VALUE
     otherwise returns UInt32 or UInt64 depending on the size along last axis.
   @example
     Cumo::Int32[0..4].bincount
-    => Cumo::UInt32#shape=[5]
-       [1, 1, 1, 1, 1]
+    # => Cumo::UInt32#shape=[5]
+    #    [1, 1, 1, 1, 1]
 
     Cumo::Int32[0, 1, 1, 3, 2, 1, 7].bincount
-    => Cumo::UInt32#shape=[8]
-       [1, 3, 1, 1, 0, 0, 0, 1]
+    # => Cumo::UInt32#shape=[8]
+    #    [1, 3, 1, 1, 0, 0, 0, 1]
 
     x = Cumo::Int32[0, 1, 1, 3, 2, 1, 7, 23]
     x.bincount.size == x.max+1
-    => true
+    # => true
 
     w = Cumo::DFloat[0.3, 0.5, 0.2, 0.7, 1.0, -0.6]
     x = Cumo::Int32[0, 1, 1, 2, 2, 2]
     x.bincount(w)
-    => Cumo::DFloat#shape=[3]
-       [0.3, 0.7, 1.1]
+    # => Cumo::DFloat#shape=[3]
+    #    [0.3, 0.7, 1.1]
 
 */
 static VALUE

data/ext/cumo/narray/gen/tmpl/clip.c

@@ -75,28 +75,24 @@ static void
 
   @example
       a = Cumo::Int32.new(10).seq
-      p a.clip(1,8)
-      # Cumo::Int32#shape=[10]
-      # [1, 1, 2, 3, 4, 5, 6, 7, 8, 8]
-
-      p a
-      # Cumo::Int32#shape=[10]
+      # => Cumo::Int32#shape=[10]
       # [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
 
-      p a.inplace.clip(3,6)
-      # Cumo::Int32(view)#shape=[10]
-      # [3, 3, 3, 3, 4, 5, 6, 6, 6, 6]
+      a.clip(1,8)
+      # => Cumo::Int32#shape=[10]
+      # [1, 1, 2, 3, 4, 5, 6, 7, 8, 8]
 
-      p a
-      # Cumo::Int32#shape=[10]
+      a.inplace.clip(3,6)
+      a
+      # => Cumo::Int32#shape=[10]
       # [3, 3, 3, 3, 4, 5, 6, 6, 6, 6]
 
-      p a = Cumo::Int32.new(10).seq
-      # Cumo::Int32#shape=[10]
+      b = Cumo::Int32.new(10).seq
+      # => Cumo::Int32#shape=[10]
       # [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
 
-      p a.clip([3,4,1,1,1,4,4,4,4,4], 8)
-      # Cumo::Int32#shape=[10]
+      b.clip([3,4,1,1,1,4,4,4,4,4], 8)
+      # => Cumo::Int32#shape=[10]
       # [3, 4, 2, 3, 4, 5, 6, 7, 8, 8]
 */
 static VALUE

data/ext/cumo/narray/gen/tmpl/cum.c

@@ -30,7 +30,7 @@ static void
 /*
   <%=name%> of self.
   @overload <%=name%>(axis:nil, nan:false)
-  @param [Numeric,Array,Range] axis  Affected dimensions.
+  @param [Numeric,Array,Range] axis  Performs <%=name%> along the axis.
   @param [TrueClass] nan  If true, apply NaN-aware algorithm (avoid NaN if exists).
   @return [Cumo::<%=class_name%>] <%=name%> of self.
 */

data/ext/cumo/narray/gen/tmpl/each.c

@@ -34,8 +34,10 @@ static void
   passing that element as a parameter.
   @overload <%=name%>
   @return [Cumo::NArray] self
-  For a block {|x| ... }
-  @yield [x]  x is element of NArray.
+  For a block `{|x| ... }`,
+  @yieldparam [Numeric] x  an element of NArray.
+  @see #each_with_index
+  @see #map
 */
 static VALUE
 <%=c_func(0)%>(VALUE self)

data/ext/cumo/narray/gen/tmpl/each_with_index.c

@@ -55,9 +55,12 @@ static void
   Invokes the given block once for each element of self,
   passing that element and indices along each axis as parameters.
   @overload <%=name%>
+  For a block `{|x,i,j,...| ... }`,
+  @yieldparam [Numeric] x  an element
+  @yieldparam [Integer] i,j,...  multitimensional indices
   @return [Cumo::NArray] self
-  For a block {|x,i,j,...| ... }
-  @yield [x,i,j,...]  x is an element, i,j,... are multidimensional indices.
+  @see #each
+  @see #map_with_index
 */
 static VALUE
 <%=c_func(0)%>(VALUE self)

data/ext/cumo/narray/gen/tmpl/fixed_batch_norm.c

@@ -106,8 +106,11 @@ static VALUE
     status = cumo_cuda_cudnn_CreateTensorDescriptor(&x_desc, x_cont, cudnn_dtype);
     if (status != CUDNN_STATUS_SUCCESS) goto FIXED_BATCH_NORM_ERROR;
 
+    status = cudnnCreateTensorDescriptor(&bn_desc);
+    if (status != CUDNN_STATUS_SUCCESS) goto FIXED_BATCH_NORM_ERROR;
+
     mode = cumo_cuda_cudnn_GetBatchNormMode(axis_ndim, int_axis);
-    status = cumo_cuda_cudnn_CreateBNTensorDescriptor(&bn_desc, x_desc, mode);
+    status = cudnnDeriveBNTensorDescriptor(bn_desc, x_desc, mode);
     if (status != CUDNN_STATUS_SUCCESS) goto FIXED_BATCH_NORM_ERROR;
     // TODO: bn_desc may return another type, and may need to cast gamma, beta, mean, var
 

data/ext/cumo/narray/gen/tmpl/logseq.c

@@ -62,7 +62,7 @@ static void
 
 /*
   Set logarithmic sequence of numbers to self. The sequence is obtained from
-     base**(beg+i*step)
+     `base**(beg+i*step)`
   where i is 1-dimensional index.
   Applicable classes: DFloat, SFloat, DComplex, SCopmplex.
 
@@ -74,11 +74,12 @@ static void
 
   @example
     Cumo::DFloat.new(5).logseq(4,-1,2)
-    => Cumo::DFloat#shape=[5]
-      [16, 8, 4, 2, 1]
+    # => Cumo::DFloat#shape=[5]
+    #   [16, 8, 4, 2, 1]
+
     Cumo::DComplex.new(5).logseq(0,1i*Math::PI/3,Math::E)
-    => Cumo::DComplex#shape=[5]
-      [1+7.26156e-310i, 0.5+0.866025i, -0.5+0.866025i, -1+1.22465e-16i, ...]
+    # => Cumo::DComplex#shape=[5]
+    #   [1+7.26156e-310i, 0.5+0.866025i, -0.5+0.866025i, -1+1.22465e-16i, ...]
 */
 static VALUE
 <%=c_func(-1)%>(int argc, VALUE *args, VALUE self)

data/ext/cumo/narray/gen/tmpl/map_with_index.c

@@ -78,14 +78,13 @@ static void
   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 <%=name%>
-
-  For a block {|x,i,j,...| ... }
-  @yield [x,i,j,...]  x is an element, i,j,... are multidimensional indices.
-
+  For a block `{|x,i,j,...| ... }`,
+  @yieldparam [Numeric] x  an element
+  @yieldparam [Integer] i,j,...  multitimensional indices
   @return [Cumo::NArray] mapped array
-
+  @see #map
+  @see #each_with_index
 */
 static VALUE
 <%=c_func(0)%>(VALUE self)

data/ext/cumo/narray/gen/tmpl/median.c

@@ -40,8 +40,8 @@ static void
 <% else %>
   @overload <%=name%>(axis:nil, keepdims:false)
 <% end %>
-  @param [Numeric,Array,Range] axis (keyword) Affected dimensions.
-  @param [TrueClass] keepdims (keyword) If true, the reduced axes are left in the result array as dimensions with size one.
+  @param [Numeric,Array,Range] axis  Finds <%=name%> along the axis.
+  @param [TrueClass] keepdims  If true, the reduced axes are left in the result array as dimensions with size one.
   @return [Cumo::<%=class_name%>] returns <%=name%> of self.
 */
 

data/ext/cumo/narray/gen/tmpl/minmax.c

@@ -26,7 +26,7 @@ static void
 <% else %>
   @overload <%=name%>(axis:nil, keepdims:false)
 <% end %>
-  @param [Numeric,Array,Range] axis (keyword) Affected dimensions.
+  @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 [Cumo::<%=class_name%>,Cumo::<%=class_name%>] min and max of self.
 */

data/ext/cumo/narray/gen/tmpl/poly.c

@@ -18,10 +18,10 @@ static void
 }
 
 /*
-  Polynomial.: a0 + a1*x + a2*x**2 + a3*x**3 + ... + an*x**n
-  @overload <%=name%> a0, a1, ...
-  @param [Cumo::NArray,Numeric] a0
-  @param [Cumo::NArray,Numeric] a1 , ...
+  Calculate polynomial.
+    `x.poly(a0,a1,a2,...,an) = a0 + a1*x + a2*x**2 + ... + an*x**n`
+  @overload <%=name%> a0, a1, ..., an
+  @param [Cumo::NArray,Numeric] a0,a1,...,an
   @return [Cumo::<%=class_name%>]
 */
 static VALUE

data/ext/cumo/narray/gen/tmpl/rand.c

@@ -115,14 +115,16 @@ static void
   @return [Cumo::<%=class_name%>] self.
   @example
     Cumo::DFloat.new(6).rand
-    => Cumo::DFloat#shape=[6]
-       [0.0617545, 0.373067, 0.794815, 0.201042, 0.116041, 0.344032]
+    # => Cumo::DFloat#shape=[6]
+    #    [0.0617545, 0.373067, 0.794815, 0.201042, 0.116041, 0.344032]
+
     Cumo::DComplex.new(6).rand(5+5i)
-    => Cumo::DComplex#shape=[6]
-       [2.69974+3.68908i, 0.825443+0.254414i, 0.540323+0.34354i, 4.52061+2.39322i, ...]
+    # => Cumo::DComplex#shape=[6]
+    #    [2.69974+3.68908i, 0.825443+0.254414i, 0.540323+0.34354i, 4.52061+2.39322i, ...]
+
     Cumo::Int32.new(6).rand(2,5)
-    => Cumo::Int32#shape=[6]
-       [4, 3, 3, 2, 4, 2]
+    # => Cumo::Int32#shape=[6]
+    #    [4, 3, 3, 2, 4, 2]
 */
 static VALUE
 <%=c_func(-1)%>(int argc, VALUE *args, VALUE self)

data/ext/cumo/narray/gen/tmpl/rand_norm.c

@@ -77,24 +77,26 @@ static void
   @return [Cumo::<%=class_name%>] self.
   @example
     Cumo::DFloat.new(5,5).rand_norm
-    => Cumo::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]]
+    # => Cumo::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]]
+
     Cumo::DFloat.new(5,5).rand_norm(10,0.1)
-    => Cumo::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]]
+    # => Cumo::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]]
+
     Cumo::DComplex.new(3,3).rand_norm(5+5i)
-    => Cumo::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]]
+    # => Cumo::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
 <%=c_func(-1)%>(int argc, VALUE *args, VALUE self)

data/ext/cumo/narray/gen/tmpl/seq.c

@@ -80,11 +80,12 @@ static void
   @return [Cumo::<%=class_name%>] self.
   @example
     Cumo::DFloat.new(6).seq(1,-0.2)
-    => Cumo::DFloat#shape=[6]
-       [1, 0.8, 0.6, 0.4, 0.2, 0]
+    # => Cumo::DFloat#shape=[6]
+    #    [1, 0.8, 0.6, 0.4, 0.2, 0]
+
     Cumo::DComplex.new(6).seq(1,-0.2+0.2i)
-    => Cumo::DComplex#shape=[6]
-       [1+0i, 0.8+0.2i, 0.6+0.4i, 0.4+0.6i, 0.2+0.8i, 0+1i]
+    # => Cumo::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
 <%=c_func(-1)%>(int argc, VALUE *args, VALUE self)

data/ext/cumo/narray/gen/tmpl/sort.c

@@ -22,10 +22,10 @@ static void
 <% else %>
   @overload <%=name%>(axis:nil)
 <% end %>
-  @param [Numeric,Array,Range] axis  Affected dimensions.
+  @param [Numeric,Array,Range] axis  Performs <%=name%> along the axis.
   @return [Cumo::<%=class_name%>] returns result of <%=name%>.
   @example
-      Cumo::DFloat[3,4,1,2].sort => Cumo::DFloat[1,2,3,4]
+      Cumo::DFloat[3,4,1,2].sort # => Cumo::DFloat[1,2,3,4]
 */
 static VALUE
 <%=c_func(-1)%>(int argc, VALUE *argv, VALUE self)

data/ext/cumo/narray/gen/tmpl/sort_index.c

@@ -52,10 +52,10 @@ static void
 <% else %>
   @overload <%=name%>(axis:nil)
 <% end %>
-  @param [Numeric,Array,Range] axis  Affected dimensions.
+  @param [Numeric,Array,Range] axis  Performs <%=name%> along the axis.
   @return [Integer,Cumo::Int] returns result index of <%=name%>.
   @example
-      Cumo::NArray[3,4,1,2].sort_index => Cumo::Int32[2,3,0,1]
+      Cumo::NArray[3,4,1,2].sort_index # => Cumo::Int32[2,3,0,1]
 */
 static VALUE
 <%=c_func(-1)%>(int argc, VALUE *argv, VALUE self)

data/ext/cumo/narray/gen/tmpl_bit/aref.c

@@ -2,42 +2,36 @@ static VALUE
 <%=c_func(-1)%>_cpu(int argc, VALUE *argv, VALUE self);
 
 /*
-  Array element referenece or slice view.
+  Array indexing.
   @overload [](dim0,...,dimL)
-  @param [Numeric,Range,etc] dim0,...,dimL  Multi-dimensional Index.
-  @return [Numeric,NArray::<%=class_name%>] Element object or NArray view.
+  @param [Numeric,Range,Array,Cumo::Bit,Cumo::Int32,Cumo::Int64] dim0,...,dimL  Multi-dimensional Index.
+  @return [Cumo::Bit,Numeric] Element value or NArray view.
 
-  --- Returns the element at +dim0+, +dim1+, ... are Numeric indices
-  for each dimension, or returns a NArray View as a sliced subarray if
-  +dim0+, +dim1+, ... includes other than Numeric index, e.g., Range
-  or Array or true.
+  --- Returns an element at `dim0`, `dim1`, ... are Numeric indices for each dimension, or returns a NArray View as a sliced array if `dim0`, `dim1`, ... includes other than Numeric index, e.g., Range or Array or true.
+
+  @see #[]=
 
   @example
-      a = Cumo::DFloat.new(4,5).seq
-      => Cumo::DFloat#shape=[4,5]
-      [[0, 1, 2, 3, 4],
-       [5, 6, 7, 8, 9],
-       [10, 11, 12, 13, 14],
-       [15, 16, 17, 18, 19]]
-
-      a[1,1]
-      => 6.0
-
-      a[1..3,1]
-      => Cumo::DFloat#shape=[3]
-      [6, 11, 16]
-
-      a[1,[1,3,4]]
-      => Cumo::DFloat#shape=[3]
-      [6, 8, 9]
-
-      a[true,2].fill(99)
-      a
-      => Cumo::DFloat#shape=[4,5]
-      [[0, 1, 99, 3, 4],
-       [5, 6, 99, 8, 9],
-       [10, 11, 99, 13, 14],
-       [15, 16, 99, 18, 19]]
+      a = Cumo::Int32.new(3,4).seq
+      # => Cumo::Int32#shape=[3,4]
+      # [[0, 1, 2, 3],
+      #  [4, 5, 6, 7],
+      #  [8, 9, 10, 11]]
+
+      b = (a%2).eq(0)
+      # => Cumo::Bit#shape=[3,4]
+      # [[1, 0, 1, 0],
+      #  [1, 0, 1, 0],
+      #  [1, 0, 1, 0]]
+
+      b[true,(0..-1)%2]
+      # => Cumo::Bit(view)#shape=[3,2]
+      # [[1, 1],
+      #  [1, 1],
+      #  [1, 1]]
+
+      b[1,1]
+      # => 0
  */
 static VALUE
 <%=c_func(-1)%>(int argc, VALUE *argv, VALUE self)