Add GitHub link to generated code

Author: sue445

_tools/ruby_h_to_go/lib/ruby_h_to_go/function_definition.rb

@@ -48,12 +48,16 @@ def generate_go_content
 
       go_function_typeref = typeref.go_function_typeref
 
+      github_url = generate_include_github_url(header_dir:, ruby_header_file: filepath)
+
       go_function_lines = [
         "// #{go_function_name} calls `#{name}` in C",
         "//",
         "// Original definition is following",
         "//",
         "//\t#{definition}",
+        "//",
+        "// ref. #{github_url}",
       ]
 
       go_function_lines << "func #{go_function_name}(#{go_function_args.join(", ")}) #{go_function_typeref} {"

_tools/ruby_h_to_go/lib/ruby_h_to_go/struct_definition.rb

@@ -34,10 +34,14 @@ def write_go_file(dist_dir)
 
     # @return [String]
     def generate_go_content
+      github_url = generate_include_github_url(header_dir:, ruby_header_file: filepath)
+
       go_type_name = snake_to_camel(name)
 
       <<~GO
         // #{go_type_name} is a type for passing `C.#{name}` in and out of package
+        //
+        // ref. #{github_url}
         type #{go_type_name} C.#{name}
 
       GO

_tools/ruby_h_to_go/lib/ruby_h_to_go/type_definition.rb

@@ -33,10 +33,14 @@ def write_go_file(dist_dir)
 
     # @return [String]
     def generate_go_content
+      github_url = generate_include_github_url(header_dir:, ruby_header_file: filepath)
+
       go_type_name = snake_to_camel(name)
 
       <<~GO
         // #{go_type_name} is a type for passing `C.#{name}` in and out of package
+        //
+        // ref. #{github_url}
         type #{go_type_name} C.#{name}
 
       GO

_tools/ruby_h_to_go/spec/ruby_h_to_go/function_definition_spec.rb

@@ -29,6 +29,8 @@
           // Original definition is following
           //
           //	void rb_define_method(VALUE klass, const char *mid, VALUE (*func)(ANYARGS), int arity)
+          //
+          // ref. https://github.com/ruby/ruby/blob/master/include/ruby/internal/method.h
           func RbDefineMethod(klass VALUE, mid string, arg3 unsafe.Pointer, arity int)  {
           char, clean := string2Char(mid)
           defer clean()
@@ -67,6 +69,8 @@
           // Original definition is following
           //
           //	VALUE rb_block_call(VALUE obj, ID mid, int argc, const VALUE *argv, rb_block_call_func_t proc, VALUE data2)
+          //
+          // ref. https://github.com/ruby/ruby/blob/master/include/ruby/internal/iterator.h
           func RbBlockCall(obj VALUE, mid ID, argc int, argv *VALUE, proc RbBlockCallFuncT, data2 VALUE) VALUE {
           var cArgv C.VALUE
           ret := VALUE(C.rb_block_call(C.VALUE(obj), C.ID(mid), C.int(argc), &cArgv, C.rb_block_call_func_t(proc), C.VALUE(data2)))
@@ -103,6 +107,8 @@
           // Original definition is following
           //
           //	VALUE rb_funcallv(VALUE recv, ID mid, int argc, const VALUE *argv)
+          //
+          // ref. https://github.com/ruby/ruby/blob/master/include/ruby/internal/eval.h
           func RbFuncallv(recv VALUE, mid ID, argc int, argv []VALUE) VALUE {
           ret := VALUE(C.rb_funcallv(C.VALUE(recv), C.ID(mid), C.int(argc), toCArray[VALUE, C.VALUE](argv)))
           return ret
@@ -135,6 +141,8 @@
           // Original definition is following
           //
           //	void *rb_thread_call_with_gvl(void *(*func)(void *), void *data1)
+          //
+          // ref. https://github.com/ruby/ruby/blob/master/include/rubythread.h
           func RbThreadCallWithGvl(arg1 unsafe.Pointer, data1 unsafe.Pointer) unsafe.Pointer {
           ret := unsafe.Pointer(C.rb_thread_call_with_gvl(toCPointer(arg1), toCPointer(data1)))
           return ret
@@ -167,6 +175,8 @@
           // Original definition is following
           //
           //	int rb_uv_to_utf8(char buf[6], unsigned long uv)
+          //
+          // ref. https://github.com/ruby/ruby/blob/master/include/intern/bignum.h
           func RbUvToUtf8(buf []Char, uv uint) int {
           ret := int(C.rb_uv_to_utf8(toCArray[Char, C.char](buf), C.ulong(uv)))
           return ret

_tools/ruby_h_to_go/spec/ruby_h_to_go/struct_definition_spec.rb

@@ -17,6 +17,8 @@
       let(:go_content) do
         <<~GO
           // RbDataTypeStruct is a type for passing `C.rb_data_type_struct` in and out of package
+          //
+          // ref. https://github.com/ruby/ruby/blob/master/include/ruby/internal/core/rtypeddata.h
           type RbDataTypeStruct C.rb_data_type_struct
 
         GO

_tools/ruby_h_to_go/spec/ruby_h_to_go/type_definition_spec.rb

@@ -17,6 +17,8 @@
       let(:go_content) do
         <<~GO
           // VALUE is a type for passing `C.VALUE` in and out of package
+          //
+          // ref. https://github.com/ruby/ruby/blob/master/include/ruby/internal/value.h
           type VALUE C.VALUE
 
         GO