Documentation updates.

Author: cfis

README.md

@@ -2,9 +2,9 @@
 
 Wrapping C and C++ libraries by hand for use in Ruby has traditionally been a long, arduous task. For large, complex libraries it can take months. As a result, many C/C++ libraries are either never exposed to Ruby or their bindings quickly become outdated, especially in scientific and technical domains.
 
-`ruby-bindgen's` solves this problem by automatically creating bindings from C and C++ header files. It can even generate a CMake build system if needed. It has been battle tested against large C/C++ libraries such as Proj and OpenCv.
+`ruby-bindgen` solves this problem by automatically creating bindings from C and C++ header files. It can even generate a CMake build system if needed. It has been battle-tested against large C/C++ libraries such as Proj and OpenCV.
 
-For much more information read the extensive [documenation](https://ruby-rice.github.io/ruby-bindgen/).
+For much more information, read the extensive [documentation](https://ruby-rice.github.io/ruby-bindgen/).
 
 ## Quick Start
 

docs/architecture.md

@@ -98,7 +98,6 @@ lib/ruby-bindgen/
 ├── version.rb
 ├── refinements/               # Extensions to ffi-clang classes
 │   ├── cursor.rb
-│   ├── source_range.rb
 │   ├── type.rb
 │   ├── string.rb
 └── generators/
@@ -119,15 +118,15 @@ Most generator methods delegate to ERB templates for code generation. Each templ
 For example, the Rice generator's `cxx_method.erb` template generates a `define_method` call:
 
 ```cpp
-define_method<<%= method_signature(cursor) %>("<%= cursor.ruby_name %>", &<%= cursor.qualified_name %>,
-  <%= arguments(cursor) %>).
+define_method<%= signature %>("<%= name %>", &<%= qualified_parent %>::<%= cursor.spelling %>,
+  <%= all_args.join(", ") %>)
 ```
 
 ## Key Classes
 
 ### Config
 
-The `Config` class loads the YAML configuration file and resolves platform-specific settings. It detects whether to use `clang:` or `clang-cl:` based on `RUBY_PLATFORM` (`mswin` and `mingw` use `clang-cl:`), resolves relative paths against the config file's directory, and provides hash-like access to all configuration values.
+The `Config` class loads the YAML configuration file and resolves platform-specific settings. It detects whether to use `clang:` or `clang-cl:` based on `RUBY_PLATFORM` (`mswin` uses `clang-cl:`; Linux, macOS, and MinGW use `clang:`), resolves relative paths against the config file's directory, and provides hash-like access to all configuration values.
 
 ### Inputter
 
@@ -177,10 +176,9 @@ The `Namer` class converts C++ names to Ruby conventions:
 
 `ruby-bindgen` extends ffi-clang's classes using Ruby refinements in `lib/ruby-bindgen/refinements/`:
 
-- **Cursor** - adds `ruby_name`, `cruby_name`, `qualified_name`, and methods for finding children by kind
-- **Type** - adds `fully_qualified_spelling` for reconstructing C++ type names with proper namespace qualification and template arguments
+- **Cursor** - adds `ruby_name`, `cruby_name`, and `anonymous_definer`
+- **Type** - adds `fully_qualified_name` compatibility and helpers for reconstructing C++ type names with proper namespace qualification and template arguments
 - **String** - adds `camelize` and `underscore` for name conversion
-- **SourceRange** - adds `text` for extracting source text from a range
 
 ## Rice Generator Details
 

docs/contributing.md

@@ -17,6 +17,7 @@ Guidelines for changing `ruby-bindgen` and its generated-output tests.
 Run all tests before updating expected files:
 
 ```bash
+bundle exec ruby -Ilib -Itest test/ffi_test.rb
 bundle exec ruby -Ilib -Itest test/rice_test.rb
 bundle exec ruby -Ilib -Itest test/cmake_test.rb
 ```

docs/index.md

@@ -2,9 +2,9 @@
 
 Wrapping C and C++ libraries by hand is a long, arduous task. For large, complex libraries it can take months. As a result, many C/C++ libraries are either never exposed to Ruby or their bindings quickly become outdated, especially in scientific and technical domains.
 
-`ruby-bindgen` and its ecosystem solve this problem by automating binding generation. For simpler libraries, it can generate ready to use bindings. For more complex libraries, it can also generate bindings but some [customizations](#customization) may be needed.
+`ruby-bindgen` and its ecosystem solve this problem by automating binding generation. For simpler libraries, it can generate ready-to-use bindings. For more complex libraries, it can also generate bindings but some [customizations](#customization) may be needed.
 
-As an example, there are older, hand-crafted Ruby [bindings](https://github.com/ruby-opencv/ruby-opencv) for [OpenCV](https://opencv.org/). However, they are based on the C API which was subsequently remove by the OpenCV project. `ruby-bindgen` was used to create new OpenCv [bindings](https://github.com/cfis/opencv-ruby) based on the new C++ API. The bindings wrap over [1,000](https://cfis.github.io/opencv-ruby/) C++ classes and almost [10,000](https://cfis.github.io/opencv-ruby/) method calls. Imagine having to do that by hand!
+As an example, there are older, hand-crafted Ruby [bindings](https://github.com/ruby-opencv/ruby-opencv) for [OpenCV](https://opencv.org/). However, they are based on the C API which was subsequently removed by the OpenCV project. `ruby-bindgen` was used to create new OpenCV [bindings](https://github.com/cfis/opencv-ruby) based on the new C++ API. The bindings wrap over [1,000](https://cfis.github.io/opencv-ruby/) C++ classes and almost [10,000](https://cfis.github.io/opencv-ruby/) method calls. Imagine having to do that by hand!
 
 ## Ecosystem
 `ruby-bindgen` is part of the C/C++ to Ruby toolchain.

docs/type_spelling.md

@@ -124,7 +124,7 @@ C++11 `using` declarations.
 
 Concrete types and template instantiations.
 
-- Start from `fully_qualified_spelling`
+- Start from `fully_qualified_name`
 - Optionally consult `canonical.spelling`
     - Only when it does not introduce implementation types
 - Qualify template arguments using `qualify_template_args`
@@ -189,7 +189,7 @@ The current design reflects these constraints deliberately.
 
 - Qualified name helpers:
   `lib/ruby-bindgen/refinements/type.rb`
-  (`fully_qualified_spelling`)
+  (`fully_qualified_name`)
 
 - Template argument qualification:
   `lib/ruby-bindgen/generators/rice/rice.rb`