ruby-gr 0.0.20 → 0.0.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29a78c0f4c5e3ab3afdc4245ab4dd6d9ce7d6c4f38638901a93487e366c219c6
-  data.tar.gz: 72f3fb64d9508c28338214583b185c041362f3e8b31a138ab9990cba4669b27a
+  metadata.gz: 684689c3494cbf841d908396c562fb418796d25afabd0a5d9c58497a8dca6a32
+  data.tar.gz: 3274ea957c350ddc0ec0abd5c260e54e933ab80930dba7bf5252d807bc47c770
 SHA512:
-  metadata.gz: e0b0766224a375477115ff004467b4b5196689bff28846efabd31f078bd7f36d00a5f736e088f0a8333327d9eb6f8d80e398365e79d26e99f6303e2975b66c1c
-  data.tar.gz: 69dbc6bc3859bad4e3d67c2d2131b48c41c659e79c2f9b8b0f3250fb15cb94a3c29cc0b10c217fd1b354784ac969f2d82d9be256f59e5f0224d4d597b94ea131
+  metadata.gz: 00b957ba8bf7f2f63b67cba456fd0016a8cc18503bbee605e3f02001e61ee377d02d7800eaacfe3077878a3cb92b8ecd9987378a40acae018ddc2428f699f2c4
+  data.tar.gz: ed6aaaf3a5ca30ecdf5695623b36036afe00610c720bef330ae25922fce12ad7c76a42ff8801066c3dccf4d973a77d83861651998b7da960c4b5bea7d236fa47

data/LICENSE.txt

@@ -1,7 +1,7 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 kojix2
-Copyright (c) 2019 Red Data Tools
+Copyright (c) 2019 - present kojix2
+Copyright (c) 2019 - present Red Data Tools
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,43 +1,47 @@
 # GR.rb
 
-[![The MIT License](https://img.shields.io/badge/license-MIT-orange.svg)](LICENSE.txt)
-[![Build Status](https://travis-ci.org/red-data-tools/GR.rb.svg?branch=master)](https://travis-ci.org/red-data-tools/GR.rb)
-[![Gem Version](https://badge.fury.io/rb/ruby-gr.svg)](https://badge.fury.io/rb/ruby-gr)
+[![Gem Version](https://img.shields.io/gem/v/ruby-gr?color=brightgreen)](https://rubygems.org/gems/ruby-gr)
+[![CI](https://github.com/red-data-tools/GR.rb/workflows/CI/badge.svg)](https://github.com/red-data-tools/GR.rb/actions)
 [![Gitter Chat](https://badges.gitter.im/red-data-tools/en.svg)](https://gitter.im/red-data-tools/en)
 [![Docs Latest](https://img.shields.io/badge/docs-latest-blue.svg)](https://rubydoc.info/gems/ruby-gr)
 
-![rdatasets-1](https://i.imgur.com/XEQ6wKs.png)
-![stem](https://i.imgur.com/3w0Ejrm.png)
-![histogram](https://i.imgur.com/xUdoA2s.png)
-![barplot](https://i.imgur.com/52bOFKE.png)
-![scatter3](https://i.imgur.com/yTTVetQ.png)
-![volume](https://i.imgur.com/CuRN6oC.png)
-![griddata](https://i.imgur.com/58HdYDo.png)
-![2darray](https://i.imgur.com/aKR2FJG.png)
-![2dpolararray](https://i.imgur.com/cmSrxvS.png)
-![hexbin](https://i.imgur.com/unWhQHr.png)
-![rdatasets-2](https://i.imgur.com/ZPit2F5.png)
-![rdatasets-3](https://i.imgur.com/TbNoxwy.png)
-![surface](https://i.imgur.com/sWdaHme.png)
-![face](https://i.imgur.com/uLCKi2r.png)
-![shade](https://i.imgur.com/VJmS3EQ.png)
+[![rdatasets-1](https://i.imgur.com/XEQ6wKs.png)](examples/rdatasets.rb)
+[![stem](https://i.imgur.com/3w0Ejrm.png)](examples/fast_plots.rb)
+[![histogram](https://i.imgur.com/xUdoA2s.png)](examples/fast_plots.rb)
+[![barplot](https://i.imgur.com/52bOFKE.png)](examples/fast_plots.rb)
+[![scatter3](https://i.imgur.com/yTTVetQ.png)](examples/fast_plots.rb)
+[![volume](https://i.imgur.com/CuRN6oC.png)](examples/fast_plots.rb)
+[![griddata](https://i.imgur.com/58HdYDo.png)](examples/griddata.rb)
+[![2darray](https://i.imgur.com/aKR2FJG.png)](examples/2darray.rb)
+[![2dpolararray](https://i.imgur.com/cmSrxvS.png)](examples/2dpolararray.rb)
+[![hexbin](https://i.imgur.com/unWhQHr.png)](examples/hexbin.rb)
+[![rdatasets-2](https://i.imgur.com/ZPit2F5.png)](examples/rdatasets.rb)
+[![rdatasets-3](https://i.imgur.com/TbNoxwy.png)](examples/rdatasets.rb)
+[![surface](https://i.imgur.com/sWdaHme.png)](examples/kws2.rb)
+[![face](https://i.imgur.com/uLCKi2r.png)](examples/face.rb)
+[![shade](https://i.imgur.com/VJmS3EQ.png)](examples/shade_ex.rb)
 
 :bar_chart:  [GR framework](https://github.com/sciapp/gr) - powerful visualization library - for Ruby
 
 ## Installation
 
-GR.rb supports Ruby 2.4+.
+GR.rb supports Ruby 2.5+.
 
-First, [install GR](#gr-installation). Next, set environment variable `GRDIR`. 
+First, [install GR](#gr-installation). Then install `ruby-gr` gem.
 
 ```sh
-export GRDIR="/your/path/to/gr"
+gem install ruby-gr
 ```
+Note: If you are using [RubyInstaller](https://rubyinstaller.org/) (Windows), pacman will automatically install [mingw-w64-gr](https://packages.msys2.org/base/mingw-w64-gr).
+
+Set environment variable `GRDIR`. 
 
 ```sh
-gem install ruby-gr
+export GRDIR="/your/path/to/gr"
 ```
 
+If you use package managers to install GR, [pkg-config](https://github.com/ruby-gnome/pkg-config) may automatically detect the shared library location without specifying the `GRDIR` environment variable. 
+
 ## Quick Start
 
 <p align="center">
@@ -83,7 +87,7 @@ GR.savefig("figure.png")
 
 ## API Overview
 
-There are two different approaches to plotting with GR.rb. One way is to call Matlab-like APIs. The other is to call GR/GR3 native functions. We are planning to prepare a more object-oriented interface based on [GRUtils.jl](https://github.com/heliosdrm/GRUtils.jl) in the future.
+There are two different approaches to plotting with GR.rb. One way is to call Matlab-like APIs. The other is to call GR/GR3 native functions. 
 
 #### GR::Plot - A simple, matlab-style API. 
 
@@ -93,6 +97,7 @@ GR.plot(x, y)
 ```
 
 List of vailable functions. See [GR.rb Wiki](https://github.com/red-data-tools/GR.rb/wiki) for details.
+Some GR module methods are overridden.
 
 [`plot`](../../wiki/Plotting-functions#plot)
 [`step`](../../wiki/Plotting-functions#step)
@@ -118,6 +123,8 @@ List of vailable functions. See [GR.rb Wiki](https://github.com/red-data-tools/G
 [`imshow`](../../wiki/Plotting-functions#imshow)
 [`isosurface`](../../wiki/Plotting-functions#isosurface)
 
+We are planning to prepare a [more object-oriented interface](https://github.com/kojix2/GRUtils.rb) based on [GRUtils.jl](https://github.com/heliosdrm/GRUtils.jl) in the future.
+
 #### GR - A module for calling native GR functions.
 
 2-D Plots and common 3-D Plots.
@@ -147,6 +154,8 @@ GR3.cameralookat(-3, 2, -2, 0, 0, 0, 0, 0, -1)
 - [GR Framework](https://gr-framework.org/)
 - [GR.rb API Documentation](https://rubydoc.info/gems/ruby-gr)
 
+Although GR.rb adds methods dynamically, we try our best to provide a complete yard document. However, if you want to see more up-to-date information, we recommend using the official GR reference.
+
 ## GR Installation
 
 ### Installing an official release (recommended)
@@ -161,10 +170,11 @@ export GRDIR="your/path/to/gr"
 
 * macOS Catalina and macOS Mojave: See the "How to open an app that hasn’t been notarized or is from an unidentified developer" section of [Safely open apps on your Mac](https://support.apple.com/en-us/HT202491) in the Apple documentation.
 
-### Using your package manager
+### Using package managers
 
 * The third party GR packages for Mac, Linux and Windows are available (for advanced users).
 * If you find any problem, please report the issue [here](https://github.com/red-data-tools/GR.rb/issues).
+* Note: These packages may not have some features, for example, video output.
 
 #### Mac - Homebrew
 
@@ -172,17 +182,11 @@ export GRDIR="your/path/to/gr"
 brew install libgr
 ```
 
-Set environment variable `GRDIR`.
-
-```sh
-export GRDIR=$(brew --prefix libgr)
-```
-
 #### Linux - APT Yum
 
-[packages.red-data-tools.org](https://github.com/red-data-tools/packages.red-data-tools.org) provides `libgr-dev` and `libgr3-dev`.
+[packages.red-data-tools.org](https://github.com/red-data-tools/packages.red-data-tools.org) provides `libgr-dev`, `libgr3-dev` and `libgrm-dev`
 
-#### Windows - MSYS2
+### Windows - MSYS2
 
 If you are using Rubyinstaller, pacman will automatically install [mingw-w64-gr](https://packages.msys2.org/base/mingw-w64-gr) when the gem is installed.
 
@@ -192,13 +196,17 @@ GR.rb will be the default backend for [Charty](https://github.com/red-data-tools
 
 ## Contributing
 
-* Report bugs
-* Fix bugs and submit pull requests
+GR.rb is a library under development, so even small improvements like typofix are welcome!
+Please feel free to send us your PR.
+
+* [Report bugs](https://github.com/red-data-tools/GR.rb/issues)
+* Fix bugs and [submit pull requests](https://github.com/red-data-tools/GR.rb/pulls)
 * Write, clarify, or fix documentation
 * Suggest or add new features
-* Create visualization library based on GR.rb
+* Update GR packages ( Homebrew, MinGW, red-data-tools )
+* Create visualization tools based on GR.rb
 
 ## Acknowledgements
 
-We would like to thank Josef Heinen, the creator of [GR.jl](https://github.com/jheinen/GR.jl), Florian Rhiem, the creator of  [python-gr](https://github.com/sciapp/python-gr), and [GR](https://github.com/sciapp/gr) developers.
+We would like to thank Josef Heinen, the creator of [GR](https://github.com/sciapp/gr) and [GR.jl](https://github.com/jheinen/GR.jl), Florian Rhiem, the creator of [python-gr](https://github.com/sciapp/python-gr), and all [GR](https://github.com/sciapp/gr) developers.
 

data/lib/gr.rb

@@ -36,7 +36,7 @@
 #               | +--------------+ |
 #               +------------------+
 #
-# (You can edit the above AA diagram with http://asciiflow.com/))
+# (You can edit the above AA diagram with http://asciiflow.com/)
 #
 # Fiddley is Ruby-FFI compatible API layer for Fiddle.
 #
@@ -48,31 +48,34 @@
 module GR
   class Error < StandardError; end
 
+  class NotFoundError < Error; end
+
   class << self
     attr_accessor :ffi_lib
   end
 
+  require_relative 'gr_commons/gr_commons'
+
   # Platforms |  path
   # Windows   |  bin/libgr.dll
-  # MacOSX    |  lib/libGR.so (NOT .dylib)
+  # MacOSX    |  lib/libGR.so (v0.53.0 .so)
   # Ubuntu    |  lib/libGR.so
-  if Object.const_defined?(:RubyInstaller)
-    ENV['GRDIR'] ||= [
-      RubyInstaller::Runtime.msys2_installation.msys_path,
-      RubyInstaller::Runtime.msys2_installation.mingwarch
-    ].join(File::ALT_SEPARATOR)
-    self.ffi_lib = File.expand_path('bin/libgr.dll', ENV['GRDIR'])
-    RubyInstaller::Runtime.add_dll_directory(File.dirname(ffi_lib))
-  else
-    raise Error, 'Please set env variable GRDIR' unless ENV['GRDIR']
-
-    self.ffi_lib = File.expand_path('lib/libGR.so', ENV['GRDIR'])
-  end
+  platform = RbConfig::CONFIG['host_os']
+  lib_names, pkg_name = \
+    case platform
+    when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
+      [['libGR.dll'], 'gr']
+    when /darwin|mac os/
+      [['libGR.dylib', 'libGR.so'], 'gr']
+    else
+      [['libGR.so'], 'gr']
+    end
+  lib_path = GRCommons::GRLib.search(lib_names, pkg_name)
 
-  # Change the default encoding to UTF-8.
-  ENV['GKS_ENCODING'] ||= 'utf8'
+  raise NotFoundError, "#{lib_names} not found" if lib_path.nil?
+
+  self.ffi_lib = lib_path
 
-  require_relative 'gr_commons/gr_commons'
   require_relative 'gr/version'
   require_relative 'gr/ffi'
   require_relative 'gr/grbase'
@@ -88,22 +91,21 @@ module GR
   # a Fiddley::MemoryPointer in the GRBase class.
   extend GRBase
 
-  # Now you can see a lot of methods just calling super here.
-  # They are written to help the yard generate the documentation.
   class << self
-    def initgr(*)
-      super
-    end
+    # @!method initgr
 
-    def opengks(*)
-      super
-    end
+    # @!method opengks
 
-    def closegks(*)
-      super
-    end
+    # @!method closegks
 
-    # inqdspsize
+    # Get the current display size.
+    #
+    # Depending on the current workstation type, the current display might be
+    # the primary screen (e.g. when using gksqt or GKSTerm) or a purely virtual
+    # display (e.g. when using Cairo). When a high DPI screen is used as the
+    # current display, width and height will be in logical pixels.
+    #
+    # @return [Array] meter_width, meter_height, width, height
     def inqdspsize
       inquiry %i[double double int int] do |*pts|
         super(*pts)
@@ -111,13 +113,12 @@ module GR
     end
 
     # Open a graphical workstation.
+    #
     # @param workstation_id [Integer] A workstation identifier.
     # @param connection [String] A connection identifier.
     # @param workstation_type [Integer] The desired workstation type.
     #  * 5         : Workstation Independent Segment Storage
-    #  * 7, 8      : Computer Graphics Metafile (CGM binary, clear text)
     #  * 41        : Windows GDI
-    #  * 51        : Mac Quickdraw
     #  * 61 - 64   : PostScript (b/w, color)
     #  * 101, 102  : Portable Document Format (plain, compressed)
     #  * 210 - 213 : X Windows
@@ -138,70 +139,82 @@ module GR
     #  * 410       : Socket driver
     #  * 415       : 0MQ driver
     #  * 420       : OpenGL
-    #  * 430       : HTML5 Canvas
-    def openws(*)
-      super
-    end
+    #
+    # @!method openws
 
     # Close the specified workstation.
+    #
     # @param workstation_id [Integer] A workstation identifier.
-    def closews(*)
-      super
-    end
+    #
+    # @!method closews
 
     # Activate the specified workstation.
+    #
     # @param workstation_id [Integer] A workstation identifier.
-    def activatews(*)
-      super
-    end
+    #
+    # @!method activatews
 
     # Deactivate the specified workstation.
+    #
     # @param workstation_id [Integer] A workstation identifier.
-    def deactivatews(*)
-      super
-    end
+    #
+    # @!method deactivatews
 
-    def configurews(*)
-      super
-    end
+    # Configure the specified workstation.
+    #
+    # @!method configurews
 
-    def clearws(*)
-      super
-    end
+    # Clear the specified workstation.
+    #
+    # @!method clearws
 
-    def updatews(*)
-      super
-    end
+    # Update the specified workstation.
+    #
+    # @!method updatews
 
     # Draw a polyline using the current line attributes,
     # starting from the first data point and ending at the last data point.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
+    #
+    # The values for x and y are in world coordinates.
+    # The attributes that control the appearance of a polyline are linetype,
+    # linewidth and color index.
+    #
     def polyline(x, y)
       n = equal_length(x, y)
       super(n, x, y)
     end
 
     # Draw marker symbols centered at the given data points.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
+    #
+    # The values for x and y are in world coordinates.
+    # The attributes that control the appearance of a polymarker are marker type,
+    # marker size scale factor and color index.
+    #
     def polymarker(x, y)
       n = equal_length(x, y)
       super(n, x, y)
     end
 
     # Draw a text at position `x`, `y` using the current text attributes.
-    # @param x [Numeric] The X coordinate of starting position of the text string
-    # @param y [Numeric] The Y coordinate of starting position of the text string
-    # @param string [String] The text to be drawn
+    #
+    # @param x      [Numeric] The X coordinate of starting position of the text
+    #                         string
+    # @param y      [Numeric] The Y coordinate of starting position of the text
+    #                         string
+    # @param string [String]  The text to be drawn
     #
     # The values for `x` and `y` are in normalized device coordinates.
-    # The attributes that control the appearance of text are text font and precision,
-    # character expansion factor, character spacing, text color index, character
-    # height, character up vector, text path and text alignment.
-    def text(*)
-      super
-    end
+    # The attributes that control the appearance of text are text font and
+    # precision, character expansion factor, character spacing, text color index,
+    # character height, character up vector, text path and text alignment.
+    #
+    # @!method text
 
     def inqtext(x, y, string)
       inquiry [{ double: 4 }, { double: 4 }] do |tbx, tby|
@@ -210,11 +223,13 @@ module GR
     end
 
     # Allows you to specify a polygonal shape of an area to be filled.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     #
-    # The attributes that control the appearance of fill areas are fill area interior
-    # style, fill area style index and fill area color index.
+    # The attributes that control the appearance of fill areas are fill area
+    # interior style, fill area style index and fill area color index.
+    #
     def fillarea(x, y)
       n = equal_length(x, y)
       super(n, x, y)
@@ -224,28 +239,33 @@ module GR
     # function partitions a rectangle given by two corner points into DIMX X DIMY
     # cells, each of them colored individually by the corresponding color index
     # of the given cell array.
-    # @param xmin [Numeric] Lower left point of the rectangle
-    # @param ymin [Numeric] Lower left point of the rectangle
-    # @param xmax [Numeric] Upper right point of the rectangle
-    # @param ymax [Numeric] Upper right point of the rectangle
-    # @param dimx [Integer] X dimension of the color index array
-    # @param dimy [Integer] Y dimension of the color index array
+    #
+    # @param xmin  [Numeric]       Lower left point of the rectangle
+    # @param ymin  [Numeric]       Lower left point of the rectangle
+    # @param xmax  [Numeric]       Upper right point of the rectangle
+    # @param ymax  [Numeric]       Upper right point of the rectangle
+    # @param dimx  [Integer]       X dimension of the color index array
+    # @param dimy  [Integer]       Y dimension of the color index array
     # @param color [Array, NArray] Color index array
     #
     # The values for `xmin`, `xmax`, `ymin` and `ymax` are in world coordinates.
+    #
     def cellarray(xmin, xmax, ymin, ymax, dimx, dimy, color)
       super(xmin, xmax, ymin, ymax, dimx, dimy, 1, 1, dimx, dimy, int(color))
     end
 
     # Display a two dimensional color index array with nonuniform cell sizes.
-    # @param x [Array, NArray] X coordinates of the cell edges
-    # @param y [Array, NArray] Y coordinates of the cell edges
-    # @param dimx [Integer] X dimension of the color index array
-    # @param dimy [Integer] Y dimension of the color index array
+    #
+    # @param x    [Array, NArray] X coordinates of the cell edges
+    # @param y    [Array, NArray] Y coordinates of the cell edges
+    # @param dimx [Integer]       X dimension of the color index array
+    # @param dimy [Integer]       Y dimension of the color index array
     # @param color [Array, NArray] Color index array
+    #
     # The values for `x` and `y` are in world coordinates. `x` must contain
     # `dimx` + 1 elements and `y` must contain `dimy` + 1 elements. The elements
     # i and i+1 are respectively the edges of the i-th cell in X and Y direction.
+    #
     def nonuniformcellarray(x, y, dimx, dimy, color)
       raise ArgumentError unless x.length == dimx + 1 && y.length == dimy + 1
 
@@ -254,20 +274,46 @@ module GR
 
     # Display a two dimensional color index array mapped to a disk using polar
     # coordinates.
-    # @param xorg [Numeric] X coordinate of the disk center in world coordinates
-    # @param yorg [Numeric] Y coordinate of the disk center in world coordinates
-    # @param phimin [Numeric] start angle of the disk sector in degrees
-    # @param phimax [Numeric] end angle of the disk sector in degrees
-    # @param rmin [Numeric] inner radius of the punctured disk in world coordinates
-    # @param rmax [Numeric] outer radius of the punctured disk in world coordinates
-    # @param dimiphi [Integer] Phi (X) dimension of the color index array
-    # @param dimr [Integer] iR (Y) dimension of the color index array
-    # @param color [Array, NArray] Color index array
     #
     # The two dimensional color index array is mapped to the resulting image by
-    # interpreting the X-axis of the array as the angle and the Y-axis as the raidus.
-    # The center point of the resulting disk is located at `xorg`, `yorg` and the
-    # radius of the disk is `rmax`.
+    # interpreting the X-axis of the array as the angle and the Y-axis as the
+    # raidus. The center point of the resulting disk is located at `xorg`, `yorg`
+    # and the radius of the disk is `rmax`.
+    #
+    # @param xorg    [Numeric]       X coordinate of the disk center in world
+    #                                coordinates
+    # @param yorg    [Numeric]       Y coordinate of the disk center in world
+    #                                coordinates
+    # @param phimin  [Numeric]       start angle of the disk sector in degrees
+    # @param phimax  [Numeric]       end angle of the disk sector in degrees
+    # @param rmin    [Numeric]       inner radius of the punctured disk in world
+    #                                coordinates
+    # @param rmax    [Numeric]       outer radius of the punctured disk in world
+    #                                coordinates
+    # @param dimiphi [Integer]       Phi (X) dimension of the color index array
+    # @param dimr    [Integer]       iR (Y) dimension of the color index array
+    # @param color   [Array, NArray] Color index array
+    #
+    # The additional parameters to the function can be used to further control
+    # the mapping from polar to cartesian coordinates.
+    #
+    # If `rmin` is greater than 0 the input data is mapped to a punctured disk
+    # (or annulus) with an inner radius of `rmin` and an outer radius `rmax`. If
+    # `rmin` is greater than `rmax` the Y-axis of the array is reversed.
+    #
+    # The parameter `phimin` and `phimax` can be used to map the data to a
+    # sector of the (punctured) disk starting at `phimin` and ending at `phimax`.
+    # If `phimin` is greater than `phimax` the X-axis is reversed. The visible
+    # sector is the one starting in mathematically positive direction
+    # (counterclockwise) at the smaller angle and ending at the larger angle.
+    # An example of the four possible options can be found below:
+    #
+    # * phimin 	phimax 	Result
+    # * 90 	    270 	  Left half visible, mapped counterclockwise
+    # * 270 	  90 	    Left half visible, mapped clockwise
+    # * -90 	  90 	    Right half visible, mapped counterclockwise
+    # * 90 	    -90 	  Right half visible, mapped clockwise
+    #
     def polarcellarray(x_org, y_org, phimin, phimax, rmin, rmax, dimphi, dimr, color)
       super(x_org, y_org, phimin, phimax, rmin, rmax, dimphi, dimr, 1, 1, dimphi, dimr, int(color))
     end
@@ -275,10 +321,12 @@ module GR
     # Generates a generalized drawing primitive (GDP) of the type you specify,
     # using specified points and any additional information contained in a data
     # record.
-    # @param x [Array, NArray] A list containing the X coordinates
-    # @param y [Array, NArray] A list containing the Y coordinates
-    # @param primid [Integer] Primitive identifier
+    #
+    # @param x      [Array, NArray] A list containing the X coordinates
+    # @param y      [Array, NArray] A list containing the Y coordinates
+    # @param primid [Integer]       Primitive identifier
     # @param datrec [Array, NArray] Primitive data record
+    #
     def gdp(x, y, primid, datrec)
       n = equal_length(x, y)
       ldr = datrec.length
@@ -287,21 +335,35 @@ module GR
 
     # Generate a cubic spline-fit,
     # starting from the first data point and ending at the last data point.
-    # @param x [Array, NArray] A list containing the X coordinates
-    # @param y [Array, NArray] A list containing the Y coordinates
-    # @param m [Integer] The number of points in the polygon to be drawn (`m` > len(`x`))
-    # @param method [Integer] The smoothing method
+    #
+    # @param x      [Array, NArray] A list containing the X coordinates
+    # @param y      [Array, NArray] A list containing the Y coordinates
+    # @param m      [Integer]       The number of points in the polygon to be
+    #                               drawn (`m` > len(`x`))
+    # @param method [Integer]       The smoothing method
     #  * If `method` is > 0, then a generalized cross-validated smoothing spline is calculated.
     #  * If `method` is 0, then an interpolating natural cubic spline is calculated.
     #  * If `method` is < -1, then a cubic B-spline is calculated.
+    #
     # The values for `x` and `y` are in world coordinates. The attributes that
     # control the appearance of a spline-fit are linetype, linewidth and color
     # index.
+    #
     def spline(x, y, m, method)
       n = equal_length(x, y)
       super(n, x, y, m, method)
     end
 
+    # Interpolate data from arbitrary points at points on a rectangular grid.
+    #
+    # @param xd [Array, NArray] X coordinates of the input points
+    # @param yd [Array, NArray] Y coordinates of the input points
+    # @param zd [Array, NArray] values of the points
+    # @param nx [Array, NArray] The number of points in X direction for the
+    #                           output grid
+    # @param ny [Array, NArray] The number of points in Y direction for the
+    #                           output grid
+    #
     def gridit(xd, yd, zd, nx, ny)
       nd = equal_length(xd, yd, zd)
       inquiry [{ double: nx }, { double: ny }, { double: nx * ny }] do |px, py, pz|
@@ -310,173 +372,130 @@ module GR
     end
 
     # Specify the line style for polylines.
+    #
     # @param style [Integer] The polyline line style
-    #  * 1  : LINETYPE_SOLID
-    #    *    Solid line
-    #  * 2  : LINETYPE_DASHED
-    #    *    Dashed line
-    #  * 3  : LINETYPE_DOTTED
-    #    *    Dotted line
-    #  * 4  : LINETYPE_DASHED_DOTTED
-    #    *    Dashed-dotted line
-    #  * -1 : LINETYPE_DASH_2_DOT
-    #    *    Sequence of one dash followed by two dots
-    #  * -2 : LINETYPE_DASH_3_DOT
-    #    *    Sequence of one dash followed by three dots
-    #  * -3 : LINETYPE_LONG_DASH
-    #    *    Sequence of long dashes
-    #  * -4 : LINETYPE_LONG_SHORT_DASH
-    #    *    Sequence of a long dash followed by a short dash
-    #  * -5 : LINETYPE_SPACED_DASH
-    #    *    Sequence of dashes double spaced
-    #  * -6 : LINETYPE_SPACED_DOT
-    #    *    Sequence of dots double spaced
-    #  * -7 : LINETYPE_DOUBLE_DOT
-    #    *    Sequence of pairs of dots
-    #  * -8 : LINETYPE_TRIPLE_DOT
-    #    *    Sequence of groups of three dots
-    def setlinetype(*)
-      super
-    end
+    #  * 1  : LINETYPE_SOLID           - Solid line
+    #  * 2  : LINETYPE_DASHED          - Dashed line
+    #  * 3  : LINETYPE_DOTTED          - Dotted line
+    #  * 4  : LINETYPE_DASHED_DOTTED   - Dashed-dotted line
+    #  * -1 : LINETYPE_DASH_2_DOT      - Sequence of one dash followed by two dots
+    #  * -2 : LINETYPE_DASH_3_DOT      - Sequence of one dash followed by three dots
+    #  * -3 : LINETYPE_LONG_DASH       - Sequence of long dashes
+    #  * -4 : LINETYPE_LONG_SHORT_DASH - Sequence of a long dash followed by a short dash
+    #  * -5 : LINETYPE_SPACED_DASH     - Sequence of dashes double spaced
+    #  * -6 : LINETYPE_SPACED_DOT      - Sequence of dots double spaced
+    #  * -7 : LINETYPE_DOUBLE_DOT      - Sequence of pairs of dots
+    #  * -8 : LINETYPE_TRIPLE_DOT      - Sequence of groups of three dots
+    #
+    # @!method setlinetype
 
     def inqlinetype
       inquiry_int { |pt| super(pt) }
     end
 
     # Define the line width of subsequent polyline output primitives.
+    #
+    # The line width is calculated as the nominal line width generated on the
+    # workstation multiplied by the line width scale factor. This value is mapped
+    # by the workstation to the nearest available line width. The default line
+    # width is 1.0, or 1 times the line width generated on the graphics device.
+    #
     # @param width [Numeric] The polyline line width scale factor
-    # The line width is calculated as the nominal line width generated
-    # on the workstation multiplied by the line width scale factor.
-    # This value is mapped by the workstation to the nearest available line width.
-    # The default line width is 1.0, or 1 times the line width generated on the graphics device.
-    def setlinewidth(*)
-      super
-    end
+    #
+    # @!method setlinewidth
 
     def inqlinewidth
       inquiry_double { |pt| super(pt) }
     end
 
     # Define the color of subsequent polyline output primitives.
+    #
     # @param color [Integer] The polyline color index (COLOR < 1256)
-    def setlinecolorind(*)
-      super
-    end
+    #
+    # @!method setlinecolorind
 
-    # inqlinecolorind
     def inqlinecolorind
       inquiry_int { |pt| super(pt) }
     end
 
     # Specifiy the marker type for polymarkers.
+    #
     # @param style [Integer] The polymarker marker type
-    #  * 1   : MARKERTYPE_DOT
-    #    *     Smallest displayable dot
-    #  * 2   : MARKERTYPE_PLUS
-    #    *     Plus sign
-    #  * 3   : MARKERTYPE_ASTERISK
-    #    *     Asterisk
-    #  * 4   : MARKERTYPE_CIRCLE
-    #    *     Hollow circle
-    #  * 5   : MARKERTYPE_DIAGONAL_CROSS
-    #    *     Diagonal cross
-    #  * -1  : MARKERTYPE_SOLID_CIRCLE
-    #    *     Filled circle
-    #  * -2  : MARKERTYPE_TRIANGLE_UP
-    #    *     Hollow triangle pointing upward
-    #  * -3  : MARKERTYPE_SOLID_TRI_UP
-    #    *     Filled triangle pointing upward
-    #  * -4  : MARKERTYPE_TRIANGLE_DOWN
-    #    *     Hollow triangle pointing downward
-    #  * -5  : MARKERTYPE_SOLID_TRI_DOWN
-    #    *     Filled triangle pointing downward
-    #  * -6  : MARKERTYPE_SQUARE
-    #    *     Hollow square
-    #  * -7  : MARKERTYPE_SOLID_SQUARE
-    #    *     Filled square
-    #  * -8  : MARKERTYPE_BOWTIE
-    #    *     Hollow bowtie
-    #  * -9  : MARKERTYPE_SOLID_BOWTIE
-    #    *     Filled bowtie
-    #  * -10 : MARKERTYPE_HGLASS
-    #    *     Hollow hourglass
-    #  * -11 : MARKERTYPE_SOLID_HGLASS
-    #    *     Filled hourglass
-    #  * -12 : MARKERTYPE_DIAMOND
-    #    *     Hollow diamond
-    #  * -13 : MARKERTYPE_SOLID_DIAMOND
-    #    *     Filled Diamond
-    #  * -14 : MARKERTYPE_STAR
-    #    *     Hollow star
-    #  * -15 : MARKERTYPE_SOLID_STAR
-    #    *     Filled Star
-    #  * -16 : MARKERTYPE_TRI_UP_DOWN
-    #    *     Hollow triangles pointing up and down overlaid
-    #  * -17 : MARKERTYPE_SOLID_TRI_RIGHT
-    #    *     Filled triangle point right
-    #  * -18 : MARKERTYPE_SOLID_TRI_LEFT
-    #    *     Filled triangle pointing left
-    #  * -19 : MARKERTYPE_HOLLOW PLUS
-    #    *     Hollow plus sign
-    #  * -20 : MARKERTYPE_SOLID PLUS
-    #    *     Solid plus sign
-    #  * -21 : MARKERTYPE_PENTAGON
-    #    *     Pentagon
-    #  * -22 : MARKERTYPE_HEXAGON
-    #    *     Hexagon
-    #  * -23 : MARKERTYPE_HEPTAGON
-    #    *     Heptagon
-    #  * -24 : MARKERTYPE_OCTAGON
-    #    *     Octagon
-    #  * -25 : MARKERTYPE_STAR_4
-    #    *     4-pointed star
-    #  * -26 : MARKERTYPE_STAR_5
-    #    *     5-pointed star (pentagram)
-    #  * -27 : MARKERTYPE_STAR_6
-    #    *     6-pointed star (hexagram)
-    #  * -28 : MARKERTYPE_STAR_7
-    #    *     7-pointed star (heptagram)
-    #  * -29 : MARKERTYPE_STAR_8
-    #    *     8-pointed star (octagram)
-    #  * -30 : MARKERTYPE_VLINE
-    #    *     verical line
-    #  * -31 : MARKERTYPE_HLINE
-    #    *     horizontal line
-    #  * -32 : MARKERTYPE_OMARK
-    #    *     o-mark
+    #  * 1   : MARKERTYPE_DOT             - Smallest displayable dot
+    #  * 2   : MARKERTYPE_PLUS            - Plus sign
+    #  * 3   : MARKERTYPE_ASTERISK        - Asterisk
+    #  * 4   : MARKERTYPE_CIRCLE          - Hollow circle
+    #  * 5   : MARKERTYPE_DIAGONAL_CROSS  - Diagonal cross
+    #  * -1  : MARKERTYPE_SOLID_CIRCLE    - Filled circle
+    #  * -2  : MARKERTYPE_TRIANGLE_UP     - Hollow triangle pointing upward
+    #  * -3  : MARKERTYPE_SOLID_TRI_UP    - Filled triangle pointing upward
+    #  * -4  : MARKERTYPE_TRIANGLE_DOWN   - Hollow triangle pointing downward
+    #  * -5  : MARKERTYPE_SOLID_TRI_DOWN  - Filled triangle pointing downward
+    #  * -6  : MARKERTYPE_SQUARE          - Hollow square
+    #  * -7  : MARKERTYPE_SOLID_SQUARE    - Filled square
+    #  * -8  : MARKERTYPE_BOWTIE          - Hollow bowtie
+    #  * -9  : MARKERTYPE_SOLID_BOWTIE    - Filled bowtie
+    #  * -10 : MARKERTYPE_HGLASS          - Hollow hourglass
+    #  * -11 : MARKERTYPE_SOLID_HGLASS    - Filled hourglass
+    #  * -12 : MARKERTYPE_DIAMOND         - Hollow diamond
+    #  * -13 : MARKERTYPE_SOLID_DIAMOND   - Filled Diamond
+    #  * -14 : MARKERTYPE_STAR            - Hollow star
+    #  * -15 : MARKERTYPE_SOLID_STAR      - Filled Star
+    #  * -16 : MARKERTYPE_TRI_UP_DOWN     - Hollow triangles pointing up and down overlaid
+    #  * -17 : MARKERTYPE_SOLID_TRI_RIGHT - Filled triangle point right
+    #  * -18 : MARKERTYPE_SOLID_TRI_LEFT  - Filled triangle pointing left
+    #  * -19 : MARKERTYPE_HOLLOW PLUS     -  Hollow plus sign
+    #  * -20 : MARKERTYPE_SOLID PLUS      - Solid plus sign
+    #  * -21 : MARKERTYPE_PENTAGON        - Pentagon
+    #  * -22 : MARKERTYPE_HEXAGON         - Hexagon
+    #  * -23 : MARKERTYPE_HEPTAGON        - Heptagon
+    #  * -24 : MARKERTYPE_OCTAGON         - Octagon
+    #  * -25 : MARKERTYPE_STAR_4          - 4-pointed star
+    #  * -26 : MARKERTYPE_STAR_5          - 5-pointed star (pentagram)
+    #  * -27 : MARKERTYPE_STAR_6          - 6-pointed star (hexagram)
+    #  * -28 : MARKERTYPE_STAR_7          - 7-pointed star (heptagram)
+    #  * -29 : MARKERTYPE_STAR_8          - 8-pointed star (octagram)
+    #  * -30 : MARKERTYPE_VLINE           - verical line
+    #  * -31 : MARKERTYPE_HLINE           - horizontal line
+    #  * -32 : MARKERTYPE_OMARK           - o-mark
+    #
     # Polymarkers appear centered over their specified coordinates.
-    def setmarkertype(*)
-      super
-    end
+    #
+    # @!method setmarkertype
 
     def inqmarkertype
       inquiry_int { |pt| super(pt) }
     end
 
     # Specify the marker size for polymarkers.
+    #
+    # The polymarker size is calculated as the nominal size generated on the
+    # graphics device multiplied by the marker size scale factor.
+    #
     # @param size [Numeric] Scale factor applied to the nominal marker size
-    # The polymarker size is calculated as the nominal size generated on the graphics device
-    # multiplied by the marker size scale factor.
-    def setmarkersize(*)
-      super
-    end
+    #
+    # @!method setmarkersize
 
     # Inquire the marker size for polymarkers.
+    #
+    # @return [Numeric] Scale factor applied to the nominal marker size
+    #
     def inqmarkersize
       inquiry_double { |pt| super(pt) }
     end
 
     # Define the color of subsequent polymarker output primitives.
+    #
     # @param color [Integer] The polymarker color index (COLOR < 1256)
-    def setmarkercolorind(*)
-      super
-    end
+    #
+    # @!method setmarkercolorind
 
     def inqmarkercolorind
       inquiry_int { |pt| super(pt) }
     end
 
     # Specify the text font and precision for subsequent text output primitives.
+    #
     # @param font [Integer] Text font
     #  * 101 : FONT_TIMES_ROMAN
     #  * 102 : FONT_TIMES_ITALIC
@@ -509,185 +528,217 @@ module GR
     #  * 129 : FONT_PALATINO_BOLDITALIC
     #  * 130 : FONT_ZAPFCHANCERY_MEDIUMITALIC
     #  * 131 : FONT_ZAPFDINGBATS
+    #  * 232 : FONT_COMPUTERMODERN
+    #  * 233 : FONT_DEJAVUSANS
+    #
     # @param precision [Integer] Text precision
-    #  * 0 : TEXT_PRECISION_STRING
-    #    *   String precision (higher quality)
-    #  * 1 : TEXT_PRECISION_CHAR
-    #    *   Character precision (medium quality)
-    #  * 2 : TEXT_PRECISION_STROKE
-    #    *   Stroke precision (lower quality)
+    #  * 0 : TEXT_PRECISION_STRING  - String precision (higher quality)
+    #  * 1 : TEXT_PRECISION_CHAR    - Character precision (medium quality)
+    #  * 2 : TEXT_PRECISION_STROKE  - Stroke precision (lower quality)
+    #  * 3 : TEXT_PRECISION_OUTLINE - Outline precision (highest quality)
+    #
     # The appearance of a font depends on the text precision value specified.
     # STRING, CHARACTER or STROKE precision allows for a greater or lesser
     # realization of the text primitives, for efficiency. STRING is the default
-    # precision for GR and produces the highest quality output.
-    def settextfontprec(*)
-      super
-    end
+    # precision for GR and produces the highest quality output using either
+    # native font rendering or FreeType. OUTLINE uses the GR path rendering
+    # functions to draw individual glyphs and produces the highest quality output.
+    #
+    # @!method settextfontprec
 
     # Set the current character expansion factor (width to height ratio).
-    # @param factor [Numeric] Text expansion factor applied to the nominal text width-to-height ratio
-    # `setcharexpan` defines the width of subsequent text output primitives. The expansion
-    # factor alters the width of the generated characters, but not their height. The default
-    # text expansion factor is 1, or one times the normal width-to-height ratio of the text.
-    def setcharexpan(*)
-      super
-    end
+    #
+    # `setcharexpan` defines the width of subsequent text output primitives.
+    # The expansion factor alters the width of the generated characters, but not
+    # their height. The default text expansion factor is 1, or one times the
+    # normal width-to-height ratio of the text.
+    #
+    # @param factor [Numeric] Text expansion factor applied to the nominal text
+    #                         width-to-height ratio
+    #
+    # @!method setcharexpan
 
-    def setcharspace(*)
-      super
-    end
+    # @!method setcharspace
 
     # Sets the current text color index.
-    # @param color [Integer] The text color index (COLOR < 1256)
+    #
     # `settextcolorind` defines the color of subsequent text output primitives.
-    # GR uses the default foreground color (black=1) for the default text color index.
-    def settextcolorind(*)
-      super
-    end
+    # GR uses the default foreground color (black=1) for the default text color
+    # index.
+    #
+    # @param color [Integer] The text color index (COLOR < 1256)
+    #
+    # @!method settextcolorind
 
     # Gets the current text color index.
+    #
     # This function gets the color of text output primitives.
+    #
     # @return [Integer] color The text color index (COLOR < 1256)
     def inqtextcolorind
       inquiry_int { |pt| super(pt) }
     end
 
     # Set the current character height.
+    #
+    # `setcharheight` defines the height of subsequent text output primitives.
+    # Text height is defined as a percentage of the default window. GR uses the
+    # default text height of 0.027 (2.7% of the height of the default window).
+    #
     # @param height [Numeric] Text height value
-    # `setcharheight` defines the height of subsequent text output primitives. Text height
-    # is defined as a percentage of the default window. GR uses the default text height of
-    # 0.027 (2.7% of the height of the default window).
-    def setcharheight(*)
-      super
+    #
+    # @!method setcharheight
+
+    # Gets the current character height.
+    #
+    # This function gets the height of text output primitives. Text height is
+    # defined as a percentage of the default window. GR uses the default text
+    # height of 0.027 (2.7% of the height of the default window).
+    #
+    # @return [Numeric] Text height value
+    def inqcharheight
+      inquiry_double { |pt| super(pt) }
     end
 
     # Set the current character text angle up vector.
-    # @param ux [Numeric] Text up vector
-    # @param uy [Numeric] Text up vector
-    # `setcharup` defines the vertical rotation of subsequent text output primitives.
-    # The text up vector is initially set to (0, 1), horizontal to the baseline.
-    def setcharup(*)
-      super
-    end
+    #
+    # `setcharup` defines the vertical rotation of subsequent text output
+    # primitives. The text up vector is initially set to (0, 1), horizontal to
+    # the baseline.
+    #
+    # @param ux [Numeric] X coordinate of the text up vector
+    # @param uy [Numeric] Y coordinate of the text up vector
+    #
+    # @!method setcharup
 
     # Define the current direction in which subsequent text will be drawn.
+    #
     # @param path [Integer] Text path
-    #  * 0 : TEXT_PATH_RIGHT
-    #    *   left-to-right
-    #  * 1 : TEXT_PATH_LEFT
-    #    *   right-to-left
-    #  * 2 : TEXT_PATH_UP
-    #    *   downside-up
-    #  * 3 : TEXT_PATH_DOWN
-    #    *   upside-down
-    def settextpath(*)
-      super
-    end
+    #  * 0 : TEXT_PATH_RIGHT - left-to-right
+    #  * 1 : TEXT_PATH_LEFT  - right-to-left
+    #  * 2 : TEXT_PATH_UP    - downside-up
+    #  * 3 : TEXT_PATH_DOWN  - upside-down
+    #
+    # @!method settextpath
 
     # Set the current horizontal and vertical alignment for text.
+    #
     # @param horizontal [Integer] Horizontal text alignment
-    #  * 0 : TEXT_HALIGN_NORMAL
-    #  * 1 : TEXT_HALIGN_LEFT
-    #    *   Left justify
-    #  * 2 : TEXT_HALIGN_CENTER
-    #    *   Center justify
-    #  * 3 : TEXT_HALIGN_RIGHT
-    #    *   Right justify
+    #  * 0 : TEXT_HALIGN_NORMALlygon using the fill color index
+
+    #  * 1 : TEXT_HALIGN_LEFT   - Left justify
+    #  * 2 : TEXT_HALIGN_CENTER - Center justify
+    #  * 3 : TEXT_HALIGN_RIGHT  - Right justify
+    #
     # @param vertical [Integer] Vertical text alignment
     #  * 0 : TEXT_VALIGN_NORMAL   
-    #  * 1 : TEXT_VALIGN_TOP
-    #    *   Align with the top of the characters
-    #  * 2 : TEXT_VALIGN_CAP
-    #    *   Aligned with the cap of the characters
-    #  * 3 : TEXT_VALIGN_HALF
-    #    *   Aligned with the half line of the characters
-    #  * 4 : TEXT_VALIGN_BASE
-    #    *   Aligned with the base line of the characters
-    #  * 5 : TEXT_VALIGN_BOTTOM
-    #    *   Aligned with the bottom line of the characters
-    # `settextalign` specifies how the characters in a text primitive will be aligned
-    # in horizontal and vertical space. The default text alignment indicates horizontal left
-    # alignment and vertical baseline alignment.
-    def settextalign(*)
-      super
-    end
+    #  * 1 : TEXT_VALIGN_TOP    - Align with the top of the characters
+    #  * 2 : TEXT_VALIGN_CAP    - Aligned with the cap of the characters
+    #  * 3 : TEXT_VALIGN_HALF   - Aligned with the half line of the characters
+    #  * 4 : TEXT_VALIGN_BASE   - Aligned with the base line of the characters
+    #  * 5 : TEXT_VALIGN_BOTTOM - Aligned with the bottom line of the characters
+    #
+    # `settextalign` specifies how the characters in a text primitive will be
+    # aligned in horizontal and vertical space. The default text alignment
+    # indicates horizontal left alignment and vertical baseline alignment.
+    #
+    # @!method settextalign
 
     # Set the fill area interior style to be used for fill areas.
+    #
     # @param style [Integer] The style of fill to be used
-    #  * 0 : HOLLOW
-    #    *   No filling. Just draw the bounding polyline
-    #  * 1 : SOLID
-    #    *   Fill the interior of the polygon using the fill color index
-    #  * 2 : PATTERN
-    #    *   Fill the interior of the polygon using the style index as a pattern index
-    #  * 3 : HATCH
-    #    *   Fill the interior of the polygon using the style index as a cross-hatched style
+    #  * 0 : HOLLOW  - No filling. Just draw the bounding polyline
+    #  * 1 : SOLID   - Fill the interior of the polygon using the fill color index
+    #  * 2 : PATTERN - Fill the interior of the polygon using the style index as a pattern index
+    #  * 3 : HATCH   - Fill the interior of the polygon using the style index as a cross-hatched style
+    #  * 4 : SOLID_WITH_BORDER - Fill the interior of the polygon using the fill color index and draw the bounding polyline
+    #
     # `setfillintstyle` defines the interior style  for subsequent fill area output
     # primitives. The default interior style is HOLLOW.
-    def setfillintstyle(*)
-      super
-    end
+    #
+    # @!method setfillintstyle
 
     # Returns the fill area interior style to be used for fill areas.
+    #
+    # This function gets the currently set fill style.
+    #
+    # @return [Integer] The currently set fill style
     def inqfillintstyle
       inquiry_int { |pt| super(pt) }
     end
 
     # Sets the fill style to be used for subsequent fill areas.
+    #
+    # `setfillstyle` specifies an index when PATTERN fill or HATCH fill is
+    # requested by the`setfillintstyle` function. If the interior style is set
+    # to PATTERN, the fill style index points to a device-independent pattern
+    # table. If interior style is set to HATCH the fill style index indicates
+    # different hatch styles. If HOLLOW or SOLID is specified for the interior
+    # style, the fill style index is unused.
+    #
     # @param index [Integer] The fill style index to be used
-    # `setfillstyle` specifies an index when PATTERN fill or HATCH fill is requested by the
-    # `setfillintstyle` function. If the interior style is set to PATTERN, the fill style
-    # index points to a device-independent pattern table. If interior style is set to HATCH
-    # the fill style index indicates different hatch styles. If HOLLOW or SOLID is specified
-    # for the interior style, the fill style index is unused.
-    def setfillstyle(*)
-      super
-    end
+    #
+    # @!method setfillstyle
 
     # Returns the current fill area color index.
+    #
+    # This function gets the color index for PATTERN and HATCH fills.
+    #
+    # @return [Integer] The currently set fill style color index
     def inqfillstyle
       inquiry_int { |pt| super(pt) }
     end
 
     # Sets the current fill area color index.
+    #
+    # `setfillcolorind` defines the color of subsequent fill area output
+    # primitives. GR uses the default foreground color (black=1) for the default
+    # fill area color index.
+    #
     # @param color [Integer] The text color index (COLOR < 1256)
-    # `setfillcolorind` defines the color of subsequent fill area output primitives.
-    # GR uses the default foreground color (black=1) for the default fill area color index.
-    def setfillcolorind(*)
-      super
-    end
+    #
+    # @!method setfillcolorind
 
     # Returns the current fill area color index.
+    #
+    # This function gets the color of fill area output primitives.
+    #
+    # @return [Integer] The text color index (COLOR < 1256)
     def inqfillcolorind
       inquiry_int { |pt| super(pt) }
     end
 
-    # `setcolorrep` allows to redefine an existing color index representation by specifying
-    # an RGB color triplet.
+    # Redefine an existing color index representation by specifying an RGB color
+    # triplet.
+    #
     # @param index [Integer] Color index in the range 0 to 1256
-    # @param red [Numeric] Red intensity in the range 0.0 to 1.0
+    # @param red   [Numeric] Red intensity in the range 0.0 to 1.0
     # @param green [Numeric] Green intensity in the range 0.0 to 1.0
-    # @param blue [Numeric] Blue intensity in the range 0.0 to 1.0
-    def setcolorrep(*)
-      super
-    end
+    # @param blue  [Numeric] Blue intensity in the range 0.0 to 1.0
+    #
+    # @!method setcolorrep
 
-    # `setwindow` establishes a window, or rectangular subspace, of world coordinates to be
-    # plotted. If you desire log scaling or mirror-imaging of axes, use the SETSCALE function.
-    # @param xmin [Numeric] The left horizontal coordinate of the window (`xmin` < `xmax`).
+    # `setwindow` establishes a window, or rectangular subspace, of world
+    # coordinates to be plotted. If you desire log scaling or mirror-imaging of
+    # axes, use the SETSCALE function.
+    #
+    # `setwindow` defines the rectangular portion of the World Coordinate space
+    # (WC) to be associated with the specified normalization transformation. The
+    # WC window and the Normalized Device Coordinates (NDC) viewport define the
+    # normalization transformation through which all output primitives are
+    # mapped. The WC window is mapped onto the rectangular NDC viewport which is,
+    # in turn, mapped onto the display surface of the open and active workstation,
+    # in device coordinates. By default, GR uses the range [0,1] x [0,1], in
+    # world coordinates, as the normalization transformation window.
+    #
+    # @param xmin [Numeric] The left horizontal coordinate of the window
+    #                       (`xmin` < `xmax`).
     # @param xmax [Numeric] The right horizontal coordinate of the window.
-    # @param ymin [Numeric] The bottom vertical coordinate of the window (`ymin` < `ymax`).
+    # @param ymin [Numeric] The bottom vertical coordinate of the window
+    #                       (`ymin` < `ymax`).
     # @param ymax [Numeric] The top vertical coordinate of the window.
-    # `setwindow` defines the rectangular portion of the World Coordinate space (WC) to be
-    # associated with the specified normalization transformation. The WC window and the
-    # Normalized Device Coordinates (NDC) viewport define the normalization transformation
-    # through which all output primitives are mapped. The WC window is mapped onto the
-    # rectangular NDC viewport which is, in turn, mapped onto the display surface of the
-    # open and active workstation, in device coordinates. By default, GR uses the range
-    # \[0,1] x [0,1], in world coordinates, as the normalization transformation window.
-    def setwindow(*)
-      super
-    end
+    #
+    # @!method setwindow
 
     # inqwindow
     def inqwindow
@@ -696,20 +747,25 @@ module GR
       end
     end
 
-    # `setviewport` establishes a rectangular subspace of normalized device coordinates.
+    # `setviewport` establishes a rectangular subspace of normalized device
+    # coordinates.
+    #
+    # `setviewport` defines the rectangular portion of the Normalized Device
+    # Coordinate (NDC) space to be associated with the specified normalization
+    # transformation. The NDC viewport and World Coordinate (WC) window define
+    # the normalization transformation through which all output primitives pass.
+    # The WC window is mapped onto the rectangular NDC viewport which is, in
+    # turn, mapped onto the display surface of the open and active workstation,
+    # in device coordinates.
+    #
     # @param xmin [Numeric] The left horizontal coordinate of the viewport.
-    # @param xmax [Numeric] The right horizontal coordinate of the viewport (0 <= `xmin` < `xmax` <= 1).
+    # @param xmax [Numeric] The right horizontal coordinate of the viewport
+    #                       (0 <= `xmin` < `xmax` <= 1).
     # @param ymin [Numeric] The bottom vertical coordinate of the viewport.
-    # @param ymax [Numeric] The top vertical coordinate of the viewport (0 <= `ymin` < `ymax` <= 1).
-    # `setviewport` defines the rectangular portion of the Normalized Device Coordinate
-    # (NDC) space to be associated with the specified normalization transformation. The
-    # NDC viewport and World Coordinate (WC) window define the normalization transformation
-    # through which all output primitives pass. The WC window is mapped onto the rectangular
-    # NDC viewport which is, in turn, mapped onto the display surface of the open and active
-    # workstation, in device coordinates.
-    def setviewport(*)
-      super
-    end
+    # @param ymax [Numeric] The top vertical coordinate of the viewport
+    #                       (0 <= `ymin` < `ymax` <= 1).
+    #
+    # @!method setviewport
 
     # inqviewport
     def inqviewport
@@ -718,99 +774,103 @@ module GR
       end
     end
 
-    # `selntran` selects a predefined transformation from world coordinates to normalized
-    # device coordinates.
+    # `selntran` selects a predefined transformation from world coordinates to
+    # normalized device coordinates.
+    #
     # @param transform [Integer] A normalization transformation number.
-    #  * 0    : Selects the identity transformation in which both the window and viewport have the range of 0 to 1
-    #  * >= 1 : Selects a normalization transformation as defined by `setwindow` and `setviewport`
-    def selntran(*)
-      super
-    end
+    #  * 0    : Selects the identity transformation in which both the window and
+    #           viewport have the range of 0 to 1
+    #  * >= 1 : Selects a normalization transformation as defined by `setwindow`
+    #           and `setviewport`
+    #
+    # @!method selntran
 
     # Set the clipping indicator.
-    # @params indicator [Integer] An indicator specifying whether clipping is on or off.
+    #
+    # @param indicator [Integer] An indicator specifying whether clipping is on
+    #                             or off.
     # * 0 : Clipping is off. Data outside of the window will be drawn.
     # * 1 : Clipping is on. Data outside of the window will not be drawn.
-    # `setclip` enables or disables clipping of the image drawn in the current window.
-    # Clipping is defined as the removal of those portions of the graph that lie outside of
-    # the defined viewport. If clipping is on, GR does not draw generated output primitives
-    # past the viewport boundaries. If clipping is off, primitives may exceed the viewport
-    # boundaries, and they will be drawn to the edge of the workstation window.
-    # By default, clipping is on.
-    def setclip(*)
-      super
-    end
-
-    # Set the area of the NDC viewport that is to be drawn in the workstation window.
-    # @param xmin [Numeric] The left horizontal coordinate of the workstation window.
-    # @param xmax [Numeric] The right horizontal coordinate of the workstation window (0 <= `xmin` < `xmax` <= 1).
-    # @param ymin [Numeric] The bottom vertical coordinate of the workstation window.
-    # @param ymax [Numeric] The top vertical coordinate of the workstation window (0 <= `ymin` < `ymax` <= 1).
-    # `setwswindow` defines the rectangular area of the Normalized Device Coordinate space
-    # to be output to the device. By default, the workstation transformation will map the
-    # range [0,1] x [0,1] in NDC onto the largest square on the workstation’s display
-    # surface. The aspect ratio of the workstation window is maintained at 1 to 1.
-    def setwswindow(*)
-      super
-    end
+    #
+    # `setclip` enables or disables clipping of the image drawn in the current
+    # window. Clipping is defined as the removal of those portions of the graph
+    # that lie outside of the defined viewport. If clipping is on, GR does not
+    # draw generated output primitives past the viewport boundaries. If clipping
+    # is off, primitives may exceed the viewport boundaries, and they will be
+    # drawn to the edge of the workstation window. By default, clipping is on.
+    #
+    # @!method setclip
+
+    # Set the area of the NDC viewport that is to be drawn in the workstation
+    # window.
+    #
+    # `setwswindow` defines the rectangular area of the Normalized Device
+    # Coordinate space to be output to the device. By default, the workstation
+    # transformation will map the range [0,1] x [0,1] in NDC onto the largest
+    # square on the workstation’s display surface. The aspect ratio of the
+    # workstation window is maintained at 1 to 1.
+    #
+    # @param xmin [Numeric] The left horizontal coordinate of the workstation
+    #                       window.
+    # @param xmax [Numeric] The right horizontal coordinate of the workstation
+    #                       window (0 <= `xmin` < `xmax` <= 1).
+    # @param ymin [Numeric] The bottom vertical coordinate of the workstation
+    #                       window.
+    # @param ymax [Numeric] The top vertical coordinate of the workstation
+    #                       window (0 <= `ymin` < `ymax` <= 1).
+    #
+    # @!method setwswindow
 
     # Define the size of the workstation graphics window in meters.
-    # @param xmin [Numeric] The left horizontal coordinate of the workstation viewport.
-    # @param xmax [Numeric] The right horizontal coordinate of the workstation viewport.
-    # @param ymin [Numeric] The bottom vertical coordinate of the workstation viewport.
-    # @param ymax [Numeric] The top vertical coordinate of the workstation viewport.
-    # `setwsviewport` places a workstation window on the display of the specified size in
-    # meters. This command allows the workstation window to be accurately sized for a
-    # display or hardcopy device, and is often useful for sizing graphs for desktop
-    # publishing applications.
-    def setwsviewport(*)
-      super
-    end
+    #
+    # `setwsviewport` places a workstation window on the display of the
+    # specified size in meters. This command allows the workstation window to be
+    # accurately sized for a display or hardcopy device, and is often useful for
+    # sizing graphs for desktop publishing applications.
+    #
+    # @param xmin [Numeric] The left horizontal coordinate of the workstation
+    #                       viewport.
+    # @param xmax [Numeric] The right horizontal coordinate of the workstation
+    #                       viewport.
+    # @param ymin [Numeric] The bottom vertical coordinate of the workstation
+    #                       viewport.
+    # @param ymax [Numeric] The top vertical coordinate of the workstation
+    #                       viewport.
+    #
+    # @!method setwsviewport
 
-    def createseg(*)
-      super
-    end
+    # @!method createseg
 
-    def copysegws(*)
-      super
-    end
+    # @!method copysegws
 
-    def redrawsegws(*)
-      super
-    end
+    # @!method redrawsegws
 
-    def setsegtran(*)
-      super
-    end
+    # @!method setsegtran
 
-    def closeseg(*)
-      super
-    end
+    # @!method closeseg
 
-    def emergencyclosegks(*)
-      super
-    end
+    # @!method emergencyclosegks
 
-    def updategks(*)
-      super
-    end
+    # @!method updategks
 
-    # Set the abstract Z-space used for mapping three-dimensional output primitives into
-    # the current world coordinate space.
-    # @param zmin [Numeric] Minimum value for the Z-axis.
-    # @param zmax [Numeric] Maximum value for the Z-axis.
+    # Set the abstract Z-space used for mapping three-dimensional output
+    # primitives into the current world coordinate space.
+    #
+    # `setspace` establishes the limits of an abstract Z-axis and defines the
+    # angles for rotation and for the viewing angle (tilt) of a simulated
+    # three-dimensional graph, used for mapping corresponding output primitives
+    # into the current window. These settings are used for all subsequent
+    # three-dimensional output primitives until other values are specified.
+    # Angles of rotation and viewing angle must be specified between 0° and 90°.
+    #
+    # @param zmin     [Numeric] Minimum value for the Z-axis.
+    # @param zmax     [Numeric] Maximum value for the Z-axis.
     # @param rotation [Integer] Angle for the rotation of the X axis, in degrees.
-    # @param tilt [integer] Viewing angle of the Z axis in degrees.
-    # @return [Integer]
-    # `setspace` establishes the limits of an abstract Z-axis and defines the angles for
-    # rotation and for the viewing angle (tilt) of a simulated three-dimensional graph,
-    # used for mapping corresponding output primitives into the current window.
-    # These settings are used for all subsequent three-dimensional output primitives until
-    # other values are specified. Angles of rotation and viewing angle must be specified
-    # between 0° and 90°.
-    def setspace(*)
-      super
-    end
+    # @param tilt     [integer] Viewing angle of the Z axis in degrees.
+    #
+    # @return         [Integer]
+    #
+    # @!method setspace
 
     def inqspace
       inquiry %i[double double int int] do |*pts|
@@ -818,64 +878,63 @@ module GR
       end
     end
 
-    # `setscale` sets the type of transformation to be used for subsequent GR output
-    # primitives.
+    # `setscale` sets the type of transformation to be used for subsequent GR
+    # output primitives.
+    #
     # @param options [Integer] Scale specification
-    #  * 1 :  OPTION_X_LOG
-    #    *    Logarithmic X-axis
-    #  * 2 :  OPTION_Y_LOG
-    #    *    Logarithmic Y-axis
-    #  * 4 :  OPTION_Z_LOG
-    #    *    Logarithmic Z-axis
-    #  * 8 :  OPTION_FLIP_X
-    #    *    Flip X-axis
-    #  * 16 : OPTION_FLIP_Y
-    #    *    Flip Y-axis
-    #  * 32 : OPTION_FLIP_Z
-    #    *    Flip Z-axis
+    #  * 1 :  OPTION_X_LOG - Logarithmic X-axis
+    #  * 2 :  OPTION_Y_LOG - Logarithmic Y-axis
+    #  * 4 :  OPTION_Z_LOG - Logarithmic Z-axis
+    #  * 8 :  OPTION_FLIP_X - Flip X-axis
+    #  * 16 : OPTION_FLIP_Y - Flip Y-axis
+    #  * 32 : OPTION_FLIP_Z - Flip Z-axis
+    #
     # @return [Integer]
+    #
     # `setscale` defines the current transformation according to the given scale
-    # specification which may be or'ed together using any of the above options. GR uses
-    # these options for all subsequent output primitives until another value is provided.
-    # The scale options are used to transform points from an abstract logarithmic or
-    # semi-logarithmic coordinate system, which may be flipped along each axis, into the
-    # world coordinate system.
-    # Note: When applying a logarithmic transformation to a specific axis, the system
-    # assumes that the axes limits are greater than zero.
-    def setscale(*)
-      super
-    end
+    # specification which may be or'ed together using any of the above options.
+    # GR uses these options for all subsequent output primitives until another
+    # value is provided. The scale options are used to transform points from an
+    # abstract logarithmic or semi-logarithmic coordinate system, which may be
+    # flipped along each axis, into the world coordinate system.
+    #
+    # Note: When applying a logarithmic transformation to a specific axis, the
+    # system assumes that the axes limits are greater than zero.
+    #
+    # @!method setscale
 
     # inqscale
     def inqscale
       inquiry_int { |pt| super(pt) }
     end
 
-    # Draw a text at position `x`, `y` using the current text attributes. Strings can be
-    # defined to create basic mathematical expressions and Greek letters.
+    # Draw a text at position `x`, `y` using the current text attributes.
+    # Strings can be defined to create basic mathematical expressions and Greek
+    # letters.
+    #
+    # The values for X and Y are in normalized device coordinates.
+    # The attributes that control the appearance of text are text font and
+    # precision, character expansion factor, character spacing, text color index,
+    # character height, character up vector, text path and text alignment.
+    #
     # @param x [Numeric] The X coordinate of starting position of the text string
     # @param y [Numeric] The Y coordinate of starting position of the text string
-    # @param string [String] The text to be drawn
+    # @param string [String]  The text to be drawn
     # @return [Integer]
     #
-    # The values for X and Y are in normalized device coordinates.
-    # The attributes that control the appearance of text are text font and precision,
-    # character expansion factor, character spacing, text color index, character
-    # height, character up vector, text path and text alignment.
-    #
     # The character string is interpreted to be a simple mathematical formula.
     # The following notations apply:
     #
-    # Subscripts and superscripts: These are indicated by carets ('^') and underscores
-    # \('_'). If the sub/superscript contains more than one character, it must be enclosed
-    # in curly braces ('{}').
+    # Subscripts and superscripts: These are indicated by carets ('^') and
+    # underscores \('_'). If the sub/superscript contains more than one character,
+    # it must be enclosed in curly braces ('{}').
     #
-    # Fractions are typeset with A '/' B, where A stands for the numerator and B for the
-    # denominator.
+    # Fractions are typeset with A '/' B, where A stands for the numerator and B
+    # for the denominator.
     #
     # To include a Greek letter you must specify the corresponding keyword after a
-    # backslash ('\') character. The text translator produces uppercase or lowercase
-    # Greek letters depending on the case of the keyword.
+    # backslash ('\') character. The text translator produces uppercase or
+    # lowercase Greek letters depending on the case of the keyword.
     #  * Α α - alpha
     #  * Β β - beta
     #  * Γ γ - gamma
@@ -901,11 +960,10 @@ module GR
     #  * Ψ ψ - psi
     #  * Ω ω - omega
     # Note: `\v` is a replacement for `\nu` which would conflict with `\n` (newline)
-    # For more sophisticated mathematical formulas, you should use the `gr.mathtex`
+    # For more sophisticated mathematical formulas, you should use the `mathtex`
     # function.
-    def textext(*)
-      super
-    end
+    #
+    # @!method textext
 
     # inqtextext
     def inqtextext(x, y, string)
@@ -914,11 +972,17 @@ module GR
       end
     end
 
-    # Draw X and Y coordinate axes with linearly and/or logarithmically spaced tick marks.
-    # @param x_tick [Numeric] The interval between minor tick marks on the X axis.
-    # @param y_tick [Numeric] The interval between minor tick marks on the Y axis.
-    # @param x_org [Numeric] The world coordinates of the origin (point of intersection) of the X axis.
-    # @param y_org [Numeric] The world coordinates of the origin (point of intersection) of the Y axis.
+    # Draw X and Y coordinate axes with linearly and/or logarithmically spaced
+    # tick marks.
+    #
+    # @param x_tick [Numeric]
+    #   The interval between minor tick marks on the X axis.
+    # @param y_tick [Numeric]
+    #   The interval between minor tick marks on the Y axis.
+    # @param x_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the X axis.
+    # @param y_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the Y axis.
     # @param major_x [Integer]
     #   Unitless integer values specifying the number of minor tick intervals
     #   between major tick marks. Values of 0 or 1 imply no minor ticks.
@@ -932,74 +996,142 @@ module GR
     #   coordinate unit. Major tick marks are twice as long as minor tick marks.
     #   A negative value reverses the tick marks on the axes from inward facing
     #   to outward facing (or vice versa).
-    def axes(*)
-      super
-    end
+    #
+    # Tick marks are positioned along each axis so that major tick marks fall on
+    # the axes origin (whether visible or not). Major tick marks are labeled
+    # with the corresponding data values. Axes are drawn according to the scale
+    # of the window. Axes and tick marks are drawn using solid lines; line color
+    # and width can be modified using the gr_setlinetype and gr_setlinewidth
+    # functions. Axes are drawn according to the linear or logarithmic
+    # transformation established by the gr_setscale function.
+    #
+    # @!method axes
 
     alias axes2d axes
 
-    def axeslbl(*)
-      super
-    end
-
-    # Draw a linear and/or logarithmic grid.
-    # @param x_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param y_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param x_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
-    # @param y_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
+    # Create axes in the current workspace and supply a custom function for
+    # changing the behaviour of the tick labels.
+    #
+    # @note This method uses GRCommons::Fiddley::Function as a callback function.
+    #       Please read the source code If you have to use it. There are some
+    #       examples of the use of this function in the Plot class..
+    #
+    # Similar to gr_axes() but allows more fine-grained control over tick labels
+    # and text positioning by supplying callback functions. Within the callback
+    # function you can use normal GR text primitives for performing any
+    # manipulations on the label text.
+    # See gr_axes() for more details on drawing axes.
+    #
+    # @param x_tick [Numeric]
+    #   The interval between minor tick marks on the X axis.
+    # @param y_tick  [Numeric]
+    #   The interval between minor tick marks on the Y axis.
+    # @param x_org   [Numeric]
+    #   The world coordinate of the origin (point of intersection) of the X axis.
+    # @param y_org   [Numeric]
+    #   The world coordinate of the origin (point of intersection) of the Y axis.
     # @param major_x [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
+    #   Unitless integer value specifying the number of minor tick intervals
+    #   between major tick marks on the X axis. Values of 0 or 1 imply no minor
+    #   ticks. Negative values specify no labels will be drawn for the associated
+    #   axis.
     # @param major_y [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
+    #   Unitless integer value specifying the number of minor tick intervals
+    #   between major tick marks on the Y axis. Values of 0 or 1 imply no minor
+    #   ticks. Negative values specify no labels will be drawn for the associated
+    #   axis.
+    # @param tick_size [Numeric]
+    #   The length of minor tick marks specified in a normalized device
+    #   coordinate unit. Major tick marks are twice as long as minor tick marks.
+    #   A negative value reverses the tick marks on the axes from inward facing
+    #   to outward facing (or vice versa).
+    # @param fpx [Pointer]
+    #   Function pointer to a function that returns a label for a given tick on
+    #   the X axis. The callback function should have the following arguments.
+    # @param fpy [Pointer] Exactly same as the fpx above, but for the the Y axis.
     #
-    # Major grid lines correspond to the axes origin and major tick marks whether visible
-    # or not. Minor grid lines are drawn at points equal to minor tick marks. Major grid
-    # lines are drawn using black lines and minor grid lines are drawn using gray lines.
-    def grid(*)
-      super
-    end
+    # * fpx/fpy
+    #   * param x [Numeric] NDC of the label in X direction.
+    #   * param y [Numeric] NDC of the label in Y direction.
+    #   * param svalue [String] Internal string representation of the text drawn by GR at (x,y).
+    #   * param value [Numeric] Floating point representation of the label drawn at (x,y).
+    #
+    # @!method axeslbl
 
     # Draw a linear and/or logarithmic grid.
-    # @param x_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param y_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param z_tick [Numeric] The length in world coordinates of the interval between minor grid lines.
-    # @param x_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
-    # @param y_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
-    # @param z_org [Numeric] The world coordinates of the origin (point of intersection) of the grid.
-    # @param major_x [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
-    # @param major_y [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
-    # @param major_z [Integer]
-    #   Unitless integer values specifying the number of minor grid lines
-    #   between major grid lines. Values of 0 or 1 imply no grid lines.
     #
-    # Major grid lines correspond to the axes origin and major tick marks whether visible
-    # or not. Minor grid lines are drawn at points equal to minor tick marks. Major grid
-    # lines are drawn using black lines and minor grid lines are drawn using gray lines.
-    def grid3d(*)
-      super
-    end
+    # Major grid lines correspond to the axes origin and major tick marks whether
+    # visible or not. Minor grid lines are drawn at points equal to minor tick
+    # marks. Major grid lines are drawn using black lines and minor grid lines
+    # are drawn using gray lines.
+    #
+    # @param x_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param y_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param x_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param y_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param major_x [Integer] Unitless integer values specifying the number of
+    #                          minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    # @param major_y [Integer] Unitless integer values specifying the number of
+    #                          minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    #
+    # @!method grid
+
+    # Draw a linear and/or logarithmic grid.
+    #
+    # Major grid lines correspond to the axes origin and major tick marks whether
+    # visible or not. Minor grid lines are drawn at points equal to minor tick
+    # marks. Major grid lines are drawn using black lines and minor grid lines
+    # are drawn using gray lines.
+    #
+    # @param x_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param y_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param z_tick  [Numeric] The length in world coordinates of the interval
+    #                          between minor grid lines.
+    # @param x_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param y_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param z_org   [Numeric] The world coordinates of the origin (point of
+    #                          intersection) of the grid.
+    # @param major_x [Integer] Unitless integer values specifying the number
+    #                          of minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    # @param major_y [Integer] Unitless integer values specifying the number
+    #                          of minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    # @param major_z [Integer] Unitless integer values specifying the number of
+    #                          minor grid lines between major grid lines.
+    #                          Values of 0 or 1 imply no grid lines.
+    #
+    # @!method grid3d
 
     # Draw a standard vertical error bar graph.
-    # @param x [Array, NArray] A list of length N containing the X coordinates
-    # @param y [Array, NArray] A list of length N containing the Y coordinates
+    #
+    # @param x  [Array, NArray] A list of length N containing the X coordinates
+    # @param y  [Array, NArray] A list of length N containing the Y coordinates
     # @param e1 [Array, NArray] The absolute values of the lower error bar data
     # @param e2 [Array, NArray] The absolute values of the lower error bar data
+    #
     def verrorbars(x, y, e1, e2)
       n = equal_length(x, y, e1, e2)
       super(n, x, y, e1, e2)
     end
 
     # Draw a standard horizontal error bar graph.
+    #
     # @param x [Array, NArray] A list of length N containing the X coordinates
     # @param y [Array, NArray] A list of length N containing the Y coordinates
     # @param e1 [Array, NArray] The absolute values of the lower error bar data
     # @param e2 [Array, NArray] The absolute values of the lower error bar data
+    #
     def herrorbars(x, y, e1, e2)
       n = equal_length(x, y, e1, e2)
       super(n, x, y, e1, e2)
@@ -1007,24 +1139,30 @@ module GR
 
     # Draw a 3D curve using the current line attributes,
     # starting from the first data point and ending at the last data point.
-    # @param x [Array, NArray] A list of length N containing the X coordinates
-    # @param y [Array, NArray] A list of length N containing the Y coordinates
-    # @param z [Array, NArray] A list of length N containing the Z coordinates
+    #
     # The values for `x`, `y` and `z` are in world coordinates. The attributes that
     # control the appearance of a polyline are linetype, linewidth and color
     # index.
+    #
+    # @param x [Array, NArray] A list of length N containing the X coordinates
+    # @param y [Array, NArray] A list of length N containing the Y coordinates
+    # @param z [Array, NArray] A list of length N containing the Z coordinates
+    #
     def polyline3d(x, y, z)
       n = equal_length(x, y, z)
       super(n, x, y, z)
     end
 
     # Draw marker symbols centered at the given 3D data points.
-    # @param x [Array, NArray] A list of length N containing the X coordinates
-    # @param y [Array, NArray] A list of length N containing the Y coordinates
-    # @param z [Array, NArray] A list of length N containing the Z coordinates
+    #
     # The values for `x`, `y` and `z` are in world coordinates. The attributes
     # that control the appearance of a polymarker are marker type, marker size
     # scale factor and color index.
+    #
+    # @param x [Array, NArray] A list of length N containing the X coordinates
+    # @param y [Array, NArray] A list of length N containing the Y coordinates
+    # @param z [Array, NArray] A list of length N containing the Z coordinates
+    #
     def polymarker3d(x, y, z)
       n = equal_length(x, y, z)
       super(n, x, y, z)
@@ -1032,12 +1170,24 @@ module GR
 
     # Draw X, Y and Z coordinate axes with linearly and/or logarithmically
     # spaced tick marks.
+    #
+    # Tick marks are positioned along each axis so that major tick marks fall on
+    # the axes origin (whether visible or not). Major tick marks are labeled with
+    # the corresponding data values. Axes are drawn according to the scale of the
+    # window. Axes and tick marks are drawn using solid lines; line color and
+    # width can be modified using the `setlinetype` and `setlinewidth` functions.
+    # Axes are drawn according to the linear or logarithmic transformation
+    # established by the `setscale` function.
+    #
     # @param x_tick [Numeric] The interval between minor tick marks on the X axis.
     # @param y_tick [Numeric] The interval between minor tick marks on the Y axis.
     # @param z_tick [Numeric] The interval between minor tick marks on the Z axis.
-    # @param x_org [Numeric] The world coordinates of the origin (point of intersection) of the X axes.
-    # @param y_org [Numeric] The world coordinates of the origin (point of intersection) of the Y axes.
-    # @param z_org [Numeric] The world coordinates of the origin (point of intersection) of the Z axes.
+    # @param x_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the X axes.
+    # @param y_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the Y axes.
+    # @param z_org  [Numeric]
+    #   The world coordinates of the origin (point of intersection) of the Z axes.
     # @param major_x [Integer]
     #   Unitless integer values specifying the number of minor tick intervals
     #   between major tick marks. Values of 0 or 1 imply no minor ticks.
@@ -1055,48 +1205,41 @@ module GR
     #   coordinate unit. Major tick marks are twice as long as minor tick marks.
     #   A negative value reverses the tick marks on the axes from inward facing
     #   to outward facing (or vice versa).
-    # Tick marks are positioned along each axis so that major tick marks fall on the axes
-    # origin (whether visible or not). Major tick marks are labeled with the corresponding
-    # data values. Axes are drawn according to the scale of the window. Axes and tick marks
-    # are drawn using solid lines; line color and width can be modified using the
-    # `setlinetype` and `setlinewidth` functions. Axes are drawn according to
-    # the linear or logarithmic transformation established by the `setscale` function.
-    def axes3d(*)
-      super
-    end
+    #
+    # @!method axes3d
 
     # Display axis titles just outside of their respective axes.
+    #
     # @param x_title [String] The text to be displayed on the X axis
     # @param x_title [String] The text to be displayed on the Y axis
     # @param x_title [String] The text to be displayed on the Z axis
-    def titles3d(*)
-      super
-    end
+    #
+    # @!method titles3d
 
     # Draw a three-dimensional surface plot for the given data points.
+    #
+    # `x` and `y` define a grid. `z` is a singly dimensioned array containing at
+    # least `nx` * `ny` data points. Z describes the surface height at each point
+    # on the grid. Data is ordered as shown in the table:
+    #
+    # @note `surface` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     # @param z [Array, NArray]
     #   A list of length `len(x)` * `len(y)` or an appropriately dimensioned
     #   array containing the Z coordinates
     # @param option [Integer] Surface display option
-    #  * 0 LINES
-    #    * Use X Y polylines to denote the surface
-    #  * 1 MESH
-    #    * Use a wire grid to denote the surface
-    #  * 2 FILLED_MESH
-    #    * Applies an opaque grid to the surface
-    #  * 3 Z_SHADED_MESH
-    #    * Applies Z-value shading to the surface
-    #  * 4 COLORED_MESH
-    #    * Applies a colored grid to the surface
-    #  * 5 CELL_ARRAY
-    #    * Applies a grid of individually-colored cells to the surface
-    #  * 6 SHADED_MESH
-    #    * Applies light source shading to the 3-D surface
-    # `x` and `y` define a grid. `z` is a singly dimensioned array containing at least
-    # `nx` * `ny` data points. Z describes the surface height at each point on the grid.
-    # Data is ordered as shown in the table:
+    #  * 0 LINES         - Use X Y polylines to denote the surface
+    #  * 1 MESH          - Use a wire grid to denote the surface
+    #  * 2 FILLED_MESH   - Applies an opaque grid to the surface
+    #  * 3 Z_SHADED_MESH - Applies Z-value shading to the surface
+    #  * 4 COLORED_MESH  - Applies a colored grid to the surface
+    #  * 5 CELL_ARRAY    - Applies a grid of individually-colored cells to the surface
+    #  * 6 SHADED_MESH   - Applies light source shading to the 3-D surface
+    #
     def surface(x, y, z, option)
       # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
@@ -1104,12 +1247,17 @@ module GR
       super(nx, ny, x, y, z, option)
     end
 
-    # Draw contours of a three-dimensional data set
-    # whose values are specified over a rectangular mesh.
-    # Contour lines may optionally be labeled.
+    # Draw contours of a three-dimensional data set whose values are specified
+    # over a rectangular mesh. Contour lines may optionally be labeled.
+    #
+    # @note `contour` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
-    # @param h [Array, NArray] A list containing the Z coordinate for the height values
+    # @param h [Array, NArray]
+    #   A list containing the Z coordinate for the height values
     # @param z [Array, NArray]
     #   A list containing the Z coordinate for the height values
     #   A list of length `len(x)` * `len(y)` or an appropriately dimensioned
@@ -1119,6 +1267,7 @@ module GR
     #   every third line. A value of 1 will label every line. A value of 0
     #   produces no labels. To produce colored contour lines, add an offset
     #   of 1000 to `major_h`.
+    #
     def contour(x, y, h, z, major_h)
       # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
@@ -1127,8 +1276,13 @@ module GR
       super(nx, ny, nh, x, y, h, z, major_h)
     end
 
-    # Draw filled contours of a three-dimensional data set
-    # whose values are specified over a rectangular mesh.
+    # Draw filled contours of a three-dimensional data set whose values are
+    # specified over a rectangular mesh.
+    #
+    # @note `contourf` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     # @param h [Array, NArray]
@@ -1138,6 +1292,7 @@ module GR
     # @param z [Array, NArray]
     #   A list of length `len(x)` * `len(y)` or an appropriately dimensioned
     #   array containing the Z coordinates
+    #
     def contourf(x, y, h, z, major_h)
       # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
@@ -1147,28 +1302,59 @@ module GR
     end
 
     # Draw a contour plot for the given triangle mesh.
+    #
+    # @param x      [Array, NArray] A list containing the X coordinates
+    # @param y      [Array, NArray] A list containing the Y coordinates
+    # @param z      [Array, NArray] A list containing the Z coordinates
+    # @param lavels [Array, NArray] A list of contour levels
+    #
     def tricontour(x, y, z, levels)
       npoints = x.length # equal_length ?
       nlevels = levels.length
       super(npoints, x, y, z, nlevels, levels)
     end
 
+    # @note `hexbin` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
     # @return [Integer]
     def hexbin(x, y, nbins)
       n = x.length
       super(n, x, y, nbins)
     end
 
-    def setcolormap(*)
-      super
-    end
+    # Set the currently used colormap.
+    #
+    # * A list of colormaps can be found at: https://gr-framework.org/colormaps.html
+    # Using a negative index will use the reverse of the selected colormap.
+    #
+    # @param index [Integer] Colormap index
+    #
+    # @!method setcolormap
 
     # inqcolormap
     def inqcolormap
       inquiry_int { |pt| super(pt) }
     end
 
-    # TODO: GR.jl python-gr different API
+    # Define a colormap by a list of RGB colors.
+    # @note GR.jl and python-gr have different APIsI
+    #
+    # This function defines a colormap using the n given color intensities.
+    # If less than 256 colors are provided the colors intensities are linear
+    # interpolated. If x is NULL the given color values are evenly distributed
+    # in the colormap. Otherwise the normalized value of x defines the position
+    # of the color in the colormap.
+    #
+    # @param r [Array, NArray] The red intensities in range 0.0 to 1.0
+    # @param g [Array, NArray] The green intensities in range 0.0 to 1.0
+    # @param b [Array, NArray] The blue intensities in range 0.0 to 1.0
+    # @param positions [Array, NArray]
+    #   The positions of the corresponding color in the resulting colormap or nil.
+    #   The values of positions must increase monotonically from 0.0 to 1.0.
+    #   If positions is nil the given colors are evenly distributed in the colormap.
+    #
     def setcolormapfromrgb(r, g, b, positions: nil)
       n = equal_length(r, g, b)
       if positions.nil?
@@ -1179,9 +1365,7 @@ module GR
       super(n, r, g, b, positions)
     end
 
-    def colorbar(*)
-      super
-    end
+    # @!method colorbar
 
     def inqcolor(color)
       inquiry_int do |rgb|
@@ -1190,9 +1374,7 @@ module GR
     end
 
     # @return [Integer]
-    def inqcolorfromrgb(*)
-      super
-    end
+    # @!method inqcolorfromrgb
 
     def hsvtorgb(h, s, v)
       inquiry %i[double double double] do |r, g, b|
@@ -1201,14 +1383,10 @@ module GR
     end
 
     # @return [Numeric]
-    def tick(*)
-      super
-    end
+    # @!method tick
 
     # @return [Integer]
-    def validaterange(*)
-      super
-    end
+    # @!method validaterange
 
     def adjustlimits(amin, amax)
       inquiry %i[double double] do |pamin, pamax|
@@ -1227,24 +1405,28 @@ module GR
     end
 
     # Open and activate a print device.
+    #
+    # `beginprint` opens an additional graphics output device. The device type is obtained
+    # from the given file extension
+    #
     # @param pathname [String] Filename for the print device.
     #  The following file types are supported:
-    #  * .ps, .eps : PostScript
-    #  * .pdf : Portable Document Format
-    #  * .bmp : Windows Bitmap (BMP)
+    #  * .ps, .eps   : PostScript
+    #  * .pdf        : Portable Document Format
+    #  * .bmp        : Windows Bitmap (BMP)
     #  * .jpeg, .jpg : JPEG image file
-    #  * .png : Portable Network Graphics file (PNG)
+    #  * .png        : Portable Network Graphics file (PNG)
     #  * .tiff, .tif : Tagged Image File Format (TIFF)
-    #  * .fig : Xfig vector graphics file
-    #  * .svg : Scalable Vector Graphics
-    #  * .wmf : Windows Metafile
-    # `beginprint` opens an additional graphics output device. The device type is obtained
-    # from the given file extension.
-    def beginprint(*)
-      super
-    end
+    #  * .svg        : Scalable Vector Graphics
+    #  * .wmf        : Windows Metafile
+    #  * .mp4        : MPEG-4 video file
+    #  * .webm 	     : WebM video file
+    #  * .ogg 	     : Ogg video file
+    #
+    # @!method beginprint
 
     # Open and activate a print device with the given layout attributes.
+    #
     # @param pathname [String] Filename for the print device.
     # @param mode [String] Output mode (Color, GrayScale)
     # @param fmt [String] Output format
@@ -1280,13 +1462,10 @@ module GR
     #  * Ledger : 0.432 x 0.279
     #  * Tabloid : 0.279 x 0.432
     # @param orientation [String] Page orientation (Landscape, Portait)
-    def beginprintext(*)
-      super
-    end
+    #
+    # @!method beginprintext
 
-    def endprint(*)
-      super
-    end
+    # @!method endprint
 
     def ndctowc(x, y)
       inquiry %i[double double] do |px, py|
@@ -1314,67 +1493,74 @@ module GR
     end
 
     # Draw a rectangle using the current line attributes.
+    #
     # @param xmin [Numeric] Lower left edge of the rectangle
     # @param xmax [Numeric] Lower right edge of the rectangle
     # @param ymin [Numeric] Upper left edge of the rectangle
     # @param ymax [Numeric] Upper right edge of the rectangle
-    def drawrect(*)
-      super
-    end
+    #
+    # @!method drawrect
 
     # Draw a filled rectangle using the current fill attributes.
+    #
     # @param xmin [Numeric] Lower left edge of the rectangle
     # @param xmax [Numeric] Lower right edge of the rectangle
     # @param ymin [Numeric] Upper left edge of the rectangle
     # @param ymax [Numeric] Upper right edge of the rectangle
-    def fillrect(*)
-      super
-    end
+    #
+    # @!method fillrect
 
     # Draw a circular or elliptical arc covering the specified rectangle.
+    #
+    # The resulting arc begins at `a1` and ends at `a2` degrees. Angles are
+    # interpreted such that 0 degrees is at the 3 o'clock position. The center
+    # of the arc is the center of the given rectangle.
+    #
     # @param xmin [Numeric] Lower left edge of the rectangle
     # @param xmax [Numeric] Lower right edge of the rectangle
     # @param ymin [Numeric] Upper left edge of the rectangle
     # @param ymax [Numeric] Upper right edge of the rectangle
-    # @param a1 [Numeric] The start angle
-    # @param a2 [Numeric] The end angle
-    # The resulting arc begins at `a1` and ends at `a2` degrees. Angles are interpreted
-    # such that 0 degrees is at the 3 o'clock position. The center of the arc is the center
-    # of the given rectangle.
-    def drawarc(*)
-      super
-    end
+    # @param a1   [Numeric] The start angle
+    # @param a2   [Numeric] The end angle
+    #
+    # @!method drawarc
 
     # Fill a circular or elliptical arc covering the specified rectangle.
+    #
+    # The resulting arc begins at `a1` and ends at `a2` degrees. Angles are
+    # interpreted such that 0 degrees is at the 3 o'clock position. The center
+    # of the arc is the center of the given rectangle.
+    #
     # @param xmin [Numeric] Lower left edge of the rectangle
     # @param xmax [Numeric] Lower right edge of the rectangle
     # @param ymin [Numeric] Upper left edge of the rectangle
     # @param ymax [Numeric] Upper right edge of the rectangle
     # @param a1 [Numeric] The start angle
     # @param a2 [Numeric] The end angle
-    # The resulting arc begins at `a1` and ends at `a2` degrees. Angles are interpreted
-    # such that 0 degrees is at the 3 o'clock position. The center of the arc is the center
-    # of the given rectangle.
-    def fillarc(*)
-      super
-    end
+    #
+    # @!method fillarc
 
-    # Draw simple and compound outlines consisting of line segments and bezier curves.
+    # Draw simple and compound outlines consisting of line segments and bezier
+    # curves.
+    #
     # @param points [Array, NArray] (N, 2) array of (x, y) vertices
     # @parm codes [Array, NArray] N-length array of path codes
-    #  *  STOP : end the entire path
-    #  *  MOVETO : move to the given vertex
-    #  *  LINETO : draw a line from the current position to the given vertex
-    #  *  CURVE3 : draw a quadratic Bézier curve
-    #  *  CURVE4 : draw a cubic Bézier curve
+    #  *  STOP      : end the entire path
+    #  *  MOVETO    : move to the given vertex
+    #  *  LINETO    : draw a line from the current position to the given vertex
+    #  *  CURVE3    : draw a quadratic Bézier curve
+    #  *  CURVE4    : draw a cubic Bézier curve
     #  *  CLOSEPOLY : draw a line segment to the start point of the current path
-    # @parm fill [Integer] A flag indication whether resulting path is to be filled or not
+    # @parm fill [Integer]
+    #   A flag indication whether resulting path is to be filled or not
+    #
     def drawpath(points, codes, fill)
       len = codes.length
       super(len, points, uint8(codes), fill)
     end
 
     # Set the arrow style to be used for subsequent arrow commands.
+    #
     # @param style [Integer] The arrow style to be used
     #  The default arrow style is 1.
     #  * 1  : simple, single-ended
@@ -1396,29 +1582,30 @@ module GR
     #  * 17 : double line, single-ended
     #  * 18 : double line, double-ended
     # `setarrowstyle` defines the arrow style for subsequent arrow primitives.
-    def setarrowstyle(*)
-      super
-    end
+    #
+    # @!method setarrowstyle
 
     # Set the arrow size to be used for subsequent arrow commands.
-    # @param size [Numeric] The arrow size to be used
+    #
     # `setarrowsize` defines the arrow size for subsequent arrow primitives.
     # The default arrow size is 1.
-    def setarrowsize(*)
-      super
-    end
+    #
+    # @param size [Numeric] The arrow size to be used
+    #
+    # @!method setarrowsize
 
     # Draw an arrow between two points.
+    #
+    # Different arrow styles (angles between arrow tail and wing, optionally
+    # filled heads, double headed arrows) are available and can be set with the
+    # `setarrowstyle` function.
+    #
     # @param x1 [Numeric] Starting point of the arrow (tail)
     # @param y1 [Numeric] Starting point of the arrow (tail)
     # @param x2 [Numeric] Head of the arrow
     # @param y2 [Numeric] Head of the arrow
-    # Different arrow styles (angles between arrow tail and wing, optionally filled
-    # heads, double headed arrows) are available and can be set with the `setarrowstyle`
-    # function.
-    def drawarrow(*)
-      super
-    end
+    #
+    # @!method drawarrow
 
     # @return [Integer]
     def readimage(path)
@@ -1434,35 +1621,35 @@ module GR
     end
 
     # Draw an image into a given rectangular area.
-    # @param xmin [Numeric] First corner point of the rectangle
-    # @param ymin [Numeric] First corner point of the rectangle
-    # @param xmax [Numeric] Second corner point of the rectangle
-    # @param ymax [Numeric] Second corner point of the rectangle
-    # @param width [Integer] The width and the height of the image
+    #
+    # The points (`xmin`, `ymin`) and (`xmax`, `ymax`) are world coordinates
+    # defining diagonally opposite corner points of a rectangle. This rectangle
+    # is divided into `width` by `height` cells. The two-dimensional array `data`
+    # specifies colors for each cell.
+    #
+    # @param xmin   [Numeric] First corner point of the rectangle
+    # @param ymin   [Numeric] First corner point of the rectangle
+    # @param xmax   [Numeric] Second corner point of the rectangle
+    # @param ymax   [Numeric] Second corner point of the rectangle
+    # @param width  [Integer] The width and the height of the image
     # @param height [Integer] The width and the height of the image
-    # @param data [Array, NArray] An array of color values dimensioned `width` by `height`
-    # @param model [Integer] Color model ( default = 0 )
+    # @param data   [Array, NArray] An array of color values dimensioned `width` by `height`
+    # @param model  [Integer] Color model ( default = 0 )
     #  The available color models are:
-    #  * 0 : MODEL_RGB
-    #    *   AABBGGRR
-    #  * 1 : MODEL_HSV
-    #    *   AAVVSSHH
-    # The points (`xmin`, `ymin`) and (`xmax`, `ymax`) are world coordinates defining
-    # diagonally opposite corner points of a rectangle. This rectangle is divided into
-    # `width` by `height` cells. The two-dimensional array `data` specifies colors
-    # for each cell.
+    #  * 0 : MODEL_RGB - AABBGGRR
+    #  * 1 : MODEL_HSV - AAVVSSHH
+    #
     def drawimage(xmin, xmax, ymin, ymax, width, height, data, model = 0)
       super(xmin, xmax, ymin, ymax, width, height, uint(data), model)
     end
 
     # @return [Integer]
-    def importgraphics(*)
-      super
-    end
+    # @!method importgraphics
 
-    # `setshadow` allows drawing of shadows, realized by images painted underneath,
-    # and offset from, graphics objects such that the shadow mimics the effect of a light
-    # source cast on the graphics objects.
+    # `setshadow` allows drawing of shadows, realized by images painted
+    # underneath, and offset from, graphics objects such that the shadow mimics
+    # the effect of a light source cast on the graphics objects.
+    #
     # @param offsetx [Numeric]
     #   An x-offset, which specifies how far in the horizontal direction the
     #   shadow is offset from the object
@@ -1471,18 +1658,19 @@ module GR
     #   is offset from the object
     # @param blur [Numeric]
     #   A blur value, which specifies whether the object has a hard or a diffuse edge
-    def setshadow(*)
-      super
-    end
+    #
+    # @!method setshadow
 
     # Set the value of the alpha component associated with GR colors.
+    #
     # @param alpha [Numeric] An alpha value (0.0 - 1.0)
-    def settransparency(*)
-      super
-    end
+    #
+    # @!method settransparency
 
     # Change the coordinate transformation according to the given matrix.
+    #
     # @param mat [Array, NArray] 2D transformation matrix
+    #
     def setcoordxform(mat)
       raise if mat.size != 6
 
@@ -1490,17 +1678,15 @@ module GR
     end
 
     # Open a file for graphics output.
+    #
     # @param path [String] Filename for the graphics file.
-    # `begingraphics` allows to write all graphics output into a XML-formatted file until
-    # the `endgraphics` functions is called. The resulting file may later be imported with
-    # the `importgraphics` function.
-    def begingraphics(*)
-      super
-    end
+    # `begingraphics` allows to write all graphics output into a XML-formatted
+    # file until the `endgraphics` functions is called. The resulting file may
+    # later be imported with the `importgraphics` function.
+    #
+    # @!method begingraphics
 
-    def endgraphics(*)
-      super
-    end
+    # @!method endgraphics
 
     # @return [String]
     def getgraphics(*)
@@ -1508,18 +1694,16 @@ module GR
     end
 
     # @return [Integer]
-    def drawgraphics(*)
-      super
-    end
+    # @!method drawgraphics
 
-    # Generate a character string starting at the given location. Strings can be defined
-    # to create mathematical symbols and Greek letters using LaTeX syntax.
-    # @param x [Numeric] Position of the text string specified in world coordinates
-    # @param y [Numeric] Position of the text string specified in world coordinates
+    # Generate a character string starting at the given location. Strings can be
+    # defined to create mathematical symbols and Greek letters using LaTeX syntax.
+    #
+    # @param x [Numeric] X coordinate of the starting position of the text string
+    # @param y [Numeric] Y coordinate of the starting position of the text string
     # @param string [String] The text string to be drawn
-    def mathtex(*)
-      super
-    end
+    #
+    # @!method mathtex
 
     # inqmathtex
     def inqmathtex(x, y, string)
@@ -1528,21 +1712,13 @@ module GR
       end
     end
 
-    def beginselection(*)
-      super
-    end
+    # @!method beginselection
 
-    def endselection(*)
-      super
-    end
+    # @!method endselection
 
-    def moveselection(*)
-      super
-    end
+    # @!method moveselection
 
-    def resizeselection(*)
-      super
-    end
+    # @!method resizeselection
 
     def inqbbox
       inquiry %i[double double double double] do |*pts|
@@ -1551,39 +1727,23 @@ module GR
     end
 
     # @return [Numeric]
-    def precision(*)
-      super
-    end
+    # @!method precision
 
-    def setregenflags(*)
-      super
-    end
+    # @!method setregenflags
 
     # @return [Integer]
-    def inqregenflags(*)
-      super
-    end
+    # @!method inqregenflags
 
-    def savestate(*)
-      super
-    end
+    # @!method savestate
 
-    def restorestate(*)
-      super
-    end
+    # @!method restorestate
 
-    def selectcontext(*)
-      super
-    end
+    # @!method selectcontext
 
-    def destroycontext(*)
-      super
-    end
+    # @!method destroycontext
 
     # @return [Integer]
-    def uselinespec(*)
-      super
-    end
+    # @!method uselinespec
 
     def delaunay(x, y)
       # Feel free to make a pull request if you catch a mistake
@@ -1606,6 +1766,11 @@ module GR
     end
 
     # Reduces the number of points of the x and y array.
+    #
+    # @param n [Integer] The requested number of points
+    # @param x [Array, NArray] The x value array
+    # @param y [Array, NArray] The y value array
+    #
     def reducepoints(xd, yd, n)
       nd = equal_length(xd, yd)
       inquiry [{ double: n }, { double: n }] do |x, y|
@@ -1615,9 +1780,11 @@ module GR
     end
 
     # Draw a triangular surface plot for the given data points.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     # @param z [Array, NArray] A list containing the Z coordinates
+    #
     def trisurface(x, y, z)
       n = [x, y, z].map(&:length).min
       super(n, x, y, z)
@@ -1634,6 +1801,7 @@ module GR
     end
 
     # Draw a quiver plot on a grid of nx*ny points.
+    #
     # @param nx [Integer] The number of points along the x-axis of the grid
     # @param ny [Integer] The number of points along the y-axis of the grid
     # @param x [Array, NArray] A list containing the X coordinates
@@ -1643,7 +1811,9 @@ module GR
     # @param color [Integer]
     #   A bool to indicate whether or not the arrows should be colored using
     #   the current colormap
+    #
     # The values for `x` and `y` are in world coordinates.
+    #
     def quiver(x, y, u, v, color)
       # TODO: check: Arrays have incorrect length or dimension.
       nx = x.length
@@ -1655,23 +1825,22 @@ module GR
     # input points are located on a grid, described by `x`, `y` and `z`.
     # The target grid ist described by `xq` and `yq`.
     # Returns an array containing the resulting z-values.
-    # @param x [Array, NArray] Array containing the input grid's x-values
-    # @param y [Array, NArray] Array containing the input grid's y-values
-    # @param z [Array, NArray] Array containing the input grid's z-values (number of values: nx * ny)
+    #
+    # @param x  [Array, NArray] Array containing the input grid's x-values
+    # @param y  [Array, NArray] Array containing the input grid's y-values
+    # @param z  [Array, NArray] Array containing the input grid's z-values (number of values: nx * ny)
     # @param xq [Array, NArray] Array containing the target grid's x-values
     # @param yq [Array, NArray] Array containing the target grid's y-values
     # @param method [Integer] Used method for interpolation
     #  The available methods for interpolation are the following:
-    #  * 0 : INTERP2_NEAREST
-    #    *   Nearest neighbour interpolation
-    #  * 1 : INTERP2_LINEAR
-    #    *   Linear interpolation
-    #  * 2 : INTERP_2_SPLINE
-    #    *   Interpolation using natural cubic splines
-    #  * 3 : INTERP2_CUBIC
-    #    *   Cubic interpolation
+    #  * 0 : INTERP2_NEAREST - Nearest neighbour interpolation
+    #  * 1 : INTERP2_LINEAR  - Linear interpolation
+    #  * 2 : INTERP_2_SPLINE - Interpolation using natural cubic splines
+    #  * 3 : INTERP2_CUBIC   - Cubic interpolation
     # @param extrapval [Numeric] The extrapolation value
-    def interp2(x, y, z, xq, yq, method, extrapval) # flatten
+    #
+    # flatten
+    def interp2(x, y, z, xq, yq, method, extrapval)
       nx = x.length
       ny = y.length
       # nz = z.length
@@ -1683,34 +1852,34 @@ module GR
     end
 
     # Returns the combined version strings of the GR runtime.
+    #
     # @return [String]
     def version
       super.to_s
     end
 
-    def shade(*)
-      super
-    end
+    # @note `hexbin` is overwritten by `require gr/plot`.
+    #       The original method is moved to the underscored name.
+    #       The yard document will show the method name after evacuation.
+    #
+    # @!method shade
 
     # Display a point set as a aggregated and rasterized image.
-    # @param x [Array, NArray] A pointer to the X coordinates
-    # @param y [Array, NArray] A pointer to the Y coordinates
-    # @param dims [Array, NArray] The size of the grid used for rasterization
-    # @param xform [Integer] The transformation type used for color mapping
-    #  The available transformation types are:
-    #  * 0 : XFORM_BOOLEAN
-    #    *   boolean
-    #  * 1 : XFORM_LINEAR
-    #    *   linear
-    #  * 2 : XFORM_LOG
-    #    *   logarithmic
-    #  * 3 : XFORM_LOGLOG
-    #    *   double logarithmic
-    #  * 4 : XFORM_CUBIC
-    #    *   cubic
-    #  * 5 : XFORM_EQUALIZED
-    #    *   histogram equalized
+    #
     # The values for `x` and `y` are in world coordinates.
+    #
+    # @param x     [Array, NArray] A pointer to the X coordinates
+    # @param y     [Array, NArray] A pointer to the Y coordinates
+    # @param dims  [Array, NArray] The size of the grid used for rasterization
+    # @param xform [Integer]       The transformation type used for color mapping
+    #  The available transformation types are:
+    #  * 0 : XFORM_BOOLEAN   - boolean
+    #  * 1 : XFORM_LINEAR    - linear
+    #  * 2 : XFORM_LOG       - logarithmic
+    #  * 3 : XFORM_LOGLOG    - double logarithmic
+    #  * 4 : XFORM_CUBIC     - cubic
+    #  * 5 : XFORM_EQUALIZED - histogram equalized
+    #
     def shadepoints(x, y, dims: [1200, 1200], xform: 1)
       n = x.length
       w, h = dims
@@ -1718,31 +1887,34 @@ module GR
     end
 
     # Display a line set as an aggregated and rasterized image.
-    # @param x [Array, NArray] A pointer to the X coordinates
-    # @param y [Array, NArray] A pointer to the Y coordinates
-    # @param dims [Array, NArray] The size of the grid used for rasterization
-    # @param xform [Integer] The transformation type used for color mapping
-    #  The available transformation types are:
-    #  * 0 : XFORM_BOOLEAN
-    #    *   boolean
-    #  * 1 : XFORM_LINEAR
-    #    *   linear
-    #  * 2 : XFORM_LOG
-    #    *   logarithmic
-    #  * 3 : XFORM_LOGLOG
-    #    *   double logarithmic
-    #  * 4 : XFORM_CUBIC
-    #    *   cubic
-    #  * 5 : XFORM_EQUALIZED
-    #    *   histogram equalized
+    #
     # The values for `x` and `y` are in world coordinates.
     # NaN values can be used to separate the point set into line segments.
+    #
+    # @param x     [Array, NArray] A pointer to the X coordinates
+    # @param y     [Array, NArray] A pointer to the Y coordinates
+    # @param dims  [Array, NArray] The size of the grid used for rasterization
+    # @param xform [Integer] The transformation type used for color mapping
+    #  The available transformation types are:
+    #  * 0 : XFORM_BOOLEAN   - boolean
+    #  * 1 : XFORM_LINEAR    - linear
+    #  * 2 : XFORM_LOG       - logarithmic
+    #  * 3 : XFORM_LOGLOG    - double logarithmic
+    #  * 4 : XFORM_CUBIC     - cubic
+    #  * 5 : XFORM_EQUALIZED - histogram equalized
+    #
     def shadelines(x, y, dims: [1200, 1200], xform: 1)
       n = x.length
       w, h = dims
       super(n, x, y, xform, w, h)
     end
 
+    # @note This method uses GRCommons::Fiddley::Function as a callback function.
+    #       Please read the source code If you have to use it.
+    #       This method is not sure if it works properly.
+    #
+    # @!method findboundary
+
     # panzoom
     def panzoom(x, y, zoom)
       inquiry %i[double double double double] do |xmin, xmax, ymin, ymax|
@@ -1750,7 +1922,8 @@ module GR
       end
     end
 
-    # Set the resample method used for gr.drawimage().
+    # Set the resample method used for `drawimage`.
+    #
     # @param resample_method [Integer] the new resample method.
     #  The available options are:
     #  * 0x00000000 : RESAMPLE_DEFAULT
@@ -1761,7 +1934,8 @@ module GR
     #    *            linear
     #  * 0x03030303 : RESAMPLE_LANCZOS
     #    *            Lanczos
-    #  Alternatively, combinations of these methods can be selected for horizontal or vertical upsampling or downsampling:
+    #  Alternatively, combinations of these methods can be selected for
+    #  horizontal or vertical upsampling or downsampling:
     #  * 0x00000000 : UPSAMPLE_VERTICAL_DEFAULT
     #    *            default for vertical upsampling
     #  * 0x00000000 : UPSAMPLE_HORIZONTAL_DEFAULT
@@ -1794,11 +1968,12 @@ module GR
     #    *            lanczos for vertical downsampling
     #  * 0x03000000 : DOWNSAMPLE_HORIZONTAL_LANCZOS
     #    *            lanczos for horizontal downsampling
-    def setresamplemethod(*)
-      super
-    end
+    #
+    # @!method setresamplemethod
 
-    # Inquire the resample method used for gr.drawimage().
+    # Inquire the resample method used for `drawimage`
+    #
+    # @return [Integer] Resample flag
     def inqresamplemethod
       inquiry_uint do |resample_method|
         super(resample_method)
@@ -1806,6 +1981,7 @@ module GR
     end
 
     # Draw paths using the given vertices and path codes.
+    #
     # @param x [Array, NArray] A list containing the X coordinates
     # @param y [Array, NArray] A list containing the Y coordinates
     # @param codes [String] A list containing the path codes
@@ -1830,128 +2006,133 @@ module GR
     #    * close path and fill         -
     #  * F
     #    * close path, fill and stroke -
+    #
     # See https://gr-framework.org/python-gr.html#gr.path for more details.
+    #
     def path(x, y, codes)
       n = equal_length(x, y)
       super(n, x, y, codes)
     end
 
     # Define the border width of subsequent path output primitives.
+    #
     # @param width [Numeric] The border width scale factor
-    def setborderwidth(*)
-      super
-    end
+    #
+    # @!method setborderwidth
 
     def inqborderwidth
       inquiry_double { |pt| super(pt) }
     end
 
     # Define the color of subsequent path output primitives.
+    #
     # @param color [Integer] The border color index (COLOR < 1256)
-    def setbordercolorind(*)
-      super
-    end
+    #
+    # @!method setbordercolorind
 
     def inqbordercolorind
       inquiry_int { |pt| super(pt) }
     end
 
     # Set the projection type with this flag.
+    #
     # @param flag [Integer] projection type
     #  The available options are:
-    #  * 0 : GR_PROJECTION_DEFAULT
-    #    * default
-    #  * 1 : GR_PROJECTION_ORTHOGRAPHIC
-    #    * orthographic
-    #  * 2 : GR_PROJECTION_PERSPECTIVE
-    #    * perspective
-    def setprojectiontype(*)
-      super
-    end
+    #  * 0 : GR_PROJECTION_DEFAULT      - default
+    #  * 1 : GR_PROJECTION_ORTHOGRAPHIC - orthographic
+    #  * 2 : GR_PROJECTION_PERSPECTIVE  - perspective
+    #
+    # @!method setprojectiontype
 
     # Return the projection type.
     def inqprojectiontype
       inquiry_int { |pt| super(pt) }
     end
 
+    # Set the far and near clipping plane for perspective projection and the
+    # vertical field ov view.
+    # Switches projection type to perspective.
+    #
+    # @param near_plane [Numeric] distance to near clipping plane
+    # @param far_plane  [Numeric] distance to far clipping plane
+    # @param fov        [Numeric] vertical field of view,
+    #                             input must be between 0 and 180 degrees
+    #
+    # @!method setperspectiveprojection
+
+    # Return the parameters for the perspective projection.
+    def inqperspectiveprojection
+      inquiry %i[double double double] do |*pts|
+        super(*pts)
+      end
+    end
+
     # Method to set the camera position, the upward facing direction and the
     # focus point of the shown volume.
-    # @param camera_pos_x [Numeric] x component of the cameraposition in world coordinates
-    # @param camera_pos_y [Numeric] y component of the cameraposition in world coordinates
-    # @param camera_pos_z [Numeric] z component of the cameraposition in world coordinates
-    # @param up_x [Numeric] x component of the up vector
-    # @param up_y [Numeric] y component of the up vector
-    # @param up_z [Numeric] z component of the up vector
+    #
+    # @param camera_pos_x  [Numeric] x component of the cameraposition in world coordinates
+    # @param camera_pos_y  [Numeric] y component of the cameraposition in world coordinates
+    # @param camera_pos_z  [Numeric] z component of the cameraposition in world coordinates
+    # @param up_x          [Numeric] x component of the up vector
+    # @param up_y          [Numeric] y component of the up vector
+    # @param up_z          [Numeric] z component of the up vector
     # @param focus_point_x [Numeric] x component of focus-point inside volume
     # @param focus_point_y [Numeric] y component of focus-point inside volume
     # @param focus_point_z [Numeric] z component of focus-point inside volume
-    def settransformationparameters(*)
-      super
-    end
+    #
+    # @!method settransformationparameters
 
     # Return the camera position, up vector and focus point.
+    #
     def inqtransformationparameters
       inquiry([:double] * 9) do |*pts|
         super(*pts)
       end
     end
 
-    # Set the far and near clipping plane for perspective projection and the
-    # vertical field ov view.
-    # Switches projection type to perspective.
-    # @param near_plane [Numeric] distance to near clipping plane
-    # @param far_plane [Numeric] distance to far clipping plane
-    # @param fov [Numeric] vertical field of view, input must be between 0 and 180 degrees
-    def setperspectiveprojection(*)
-      super
-    end
-
-    # Return the parameters for the perspective projection.
-    def inqperspectiveprojection
-      inquiry %i[double double double] do |*pts|
-        super(*pts)
-      end
-    end
-
     # Set parameters for orthographic transformation.
     # Switches projection type to orthographic.
-    # @param left [Numeric] xmin of the volume in worldcoordinates
-    # @param right [Numeric] xmax of volume in worldcoordinates
-    # @param bottom [Numeric] ymin of volume in worldcoordinates
-    # @param top [Numeric] ymax of volume in worldcoordinates
+    #
+    # @param left       [Numeric] xmin of the volume in worldcoordinates
+    # @param right      [Numeric] xmax of volume in worldcoordinates
+    # @param bottom     [Numeric] ymin of volume in worldcoordinates
+    # @param top        [Numeric] ymax of volume in worldcoordinates
     # @param near_plane [Numeric] distance to near clipping plane
-    # @param far_plane [Numeric] distance to far clipping plane
-    def setorthographicprojection(*)
-      super
-    end
+    # @param far_plane  [Numeric] distance to far clipping plane
+    #
+    # @!method setorthographicprojection
 
     # Return the camera position, up vector and focus point.
+    #
     def inqorthographicprojection
       inquiry([:double] * 6) do |*pts|
         super(*pts)
       end
     end
 
-    # Interface for interaction with the rotation of the model.
-    # For this a virtual Arcball is used.
+    # Rotate the current scene according to a virtual arcball.
+    #
+    # This function requires values between 0 (left side or bottom of the drawing
+    # area) and 1 (right side or top of the drawing area).
+    #
     # @param start_mouse_pos_x [Numeric] x component of the start mouse position
     # @param start_mouse_pos_y [Numeric] y component of the start mouse position
-    # @param end_mouse_pos_x [Numeric] x component of the end mouse position
-    # @param end_mouse_pos_y [Numeric] y component of the end mouse position
-    def camerainteraction(*)
-      super
-    end
+    # @param end_mouse_pos_x   [Numeric] x component of the end mouse position
+    # @param end_mouse_pos_y   [Numeric] y component of the end mouse position
+    #
+    # @!method camerainteraction
 
-    # Set the three dimensional window. Only used for perspective and orthographic projection.
+    # Set the three dimensional window.
+    # Only used for perspective and orthographic projection.
+    #
     # @param xmin [Numeric] min x-value
     # @param xmax [Numeric] max x-value
     # @param ymin [Numeric] min y-value
     # @param ymax [Numeric] max y-value
     # @param zmin [Numeric] min z-value
     # @param zmax [Numeric] max z-value
-    def setwindow3d(*)
-      super
-    end
+    #
+    # @!method setwindow3d
 
     # Return the three dimensional window.
     def inqwindow3d
@@ -1961,15 +2142,16 @@ module GR
     end
 
     # Set the scale factor for each axis. A one means no scale.
-    # All factor have to be != 0.
+    # The scaling factors must not be zero. .
+    #
     # @param x_axis_scale [Numeric] factor for scaling the x-axis
     # @param y_axis_scale [Numeric] factor for scaling the y-axis
     # @param z_axis_scale [Numeric] factor for scaling the z-axis
-    def setscalefactors3d(*)
-      super
-    end
+    #
+    # @!method setscalefactors3d
 
     # Returns the scale factors for each axis.
+    #
     def inqscalefactors3d
       inquiry %i[double double double] do |*opts|
         super(*opts)
@@ -1977,24 +2159,23 @@ module GR
     end
 
     # Set the camera for orthographic or perspective projection.
+    #
     # The center of the 3d window is used as the focus point and the camera is
     # positioned relative to it, using camera distance, rotation and tilt similar
-    # to gr_setspace. This function can be used if the user prefers spherical
+    # to `setspace`. This function can be used if the user prefers spherical
     # coordinates to setting the camera position directly, but has reduced
     # functionality in comparison to GR.settransformationparameters,
     # GR.setperspectiveprojection and GR.setorthographicprojection.
+    #
     # @param phi [Numeric] azimuthal angle of the spherical coordinates
     # @param theta [Numeric] polar angle of the spherical coordinates
     # @param fov [Numeric] vertical field of view (0 or NaN for orthographic projection)
     # @param camera_distance [Numeric] distance between the camera and the focus point
     #   (0 or NaN for the radius of the object's smallest bounding sphere)
-    def setspace3d(*)
-      super
-    end
+    #
+    # @!method setspace3d
 
-    def text3d(*)
-      super
-    end
+    # @!method text3d
 
     def inqtext3d(x, y, z, string, axis)
       inquiry [{ double: 16 }, { double: 16 }] do |tbx, tby|
@@ -2002,9 +2183,7 @@ module GR
       end
     end
 
-    def settextencoding(*)
-      super
-    end
+    # @!method settextencoding
 
     def inqtextencoding
       inquiry_int do |encoding|