ruby.git/lib/rdoc/code_object/attr.rb, branch v3_4_9 The Ruby Programming Language Sync RDoc 6.14.0 2025-05-22T22:04:47+00:00 Stan Lo stan.lo@shopify.com 2025-05-22T21:49:04+00:00 03eb777c69d64aa4941891a784c1fd67b44ea42c 






[ruby/rdoc] Group code object files into the same directory
2024-07-02T10:15:00+00:00

Stan Lo
stan001212@gmail.com

2024-07-02T10:14:56+00:00

d7af8afe1b85b8de04cd77c673b0f6ef3f3627fa

(https://github.com/ruby/rdoc/pull/1114)

It's hard to distinguish code object classes by their file names alone.
And given that we have 18 such classes, it'd make the codebase a lot
easier to understand if we grouped them into a single directory.

Given that these classes are all autoloaded in `lib/rdoc.rb` instead
of required individually, this change should have minimum impact on
projects using RDoc as they generally just require `rdoc`, not individual
files. An example is Rails' `sdoc`:
https://github.com/rails/sdoc/blob/main/lib/sdoc/rdoc_monkey_patches.rb

https://github.com/ruby/rdoc/commit/4211292ffe





(https://github.com/ruby/rdoc/pull/1114)

It's hard to distinguish code object classes by their file names alone.
And given that we have 18 such classes, it'd make the codebase a lot
easier to understand if we grouped them into a single directory.

Given that these classes are all autoloaded in `lib/rdoc.rb` instead
of required individually, this change should have minimum impact on
projects using RDoc as they generally just require `rdoc`, not individual
files. An example is Rails' `sdoc`:
https://github.com/rails/sdoc/blob/main/lib/sdoc/rdoc_monkey_patches.rb

https://github.com/ruby/rdoc/commit/4211292ffe