RubyGems - ruby-gr - Versions diffs - 0.0.20 → 0.0.25 - Mend

ruby-gr 0.0.20 → 0.0.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

checksums.yaml +4 -4
data/LICENSE.txt +2 -2
data/README.md +44 -36
data/lib/gr.rb +1022 -843
data/lib/gr/ffi.rb +5 -2
data/lib/gr/plot.rb +93 -41
data/lib/gr3.rb +305 -246
data/lib/gr3/ffi.rb +1 -1
data/lib/gr_commons/define_methods.rb +5 -5
data/lib/gr_commons/fiddley.rb +7 -7
data/lib/gr_commons/gr_common_utils.rb +4 -4
data/lib/gr_commons/gr_commons.rb +5 -1
data/lib/gr_commons/gr_lib.rb +83 -0
data/lib/gr_commons/gr_logger.rb +106 -0
data/lib/gr_commons/jupyter_support.rb +5 -5
data/lib/gr_commons/{extern.rb → try_extern.rb} +1 -1
data/lib/gr_commons/version.rb +1 -1
data/lib/grm.rb +34 -17
data/lib/grm/ffi.rb +28 -14
metadata +21 -6
data/lib/gr/plot.rb.md +0 -172

checksums.yaml CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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|