为什么 ActiveSupport 中的 class_inheritable_reader 没有记录？

Question

竭尽全力试图找出 class_inheritable_reader 在 Rails 中的记录位置。

Google 搜索发现了它的存在，并在 gem 本身中查找方法：

def class_inheritable_reader(*syms)
  syms.each do |sym|
    next if sym.is_a?(Hash)
    class_eval <<-EOS
      def self.#{sym}                        # def self.before_add_for_comments
        read_inheritable_attribute(:#{sym})  #         read_inheritable_attribute(:before_add_for_comments)
      end                                    # end
                                             #
      def #{sym}                             # def before_add_for_comments
        self.class.#{sym}                    #   self.class.before_add_for_comments
      end                                    # end
    EOS
  end
end
....

但是查看 ActiveSupport 和来自 'rake doc:rails' 的 rdocs，您会发现没有文档...怎么会？

Answer 1

如果你打开机器上安装 gems 的文件夹，你可以导航到：

activesupport/lib/active_support/core_ext/class/inheritable_attributes.rb

查看类的实际实现位置。此外，您可以在 GitHub 上的 Rails 存储库中看到 latest version of the file。

该文件（如下）中有类级别的文档，但没有方法级别的文档，这就是您可能找不到任何东西的原因。

# Allows attributes to be shared within an inheritance hierarchy, but where each descendant gets a copy of
# their parents' attributes, instead of just a pointer to the same. This means that the child can add elements
# to, for example, an array without those additions being shared with either their parent, siblings, or
# children, which is unlike the regular class-level attributes that are shared across the entire hierarchy.

Answer 2

I found it on APIdock。它似乎是对 Class 的扩展。没有文档，但您可以看到实现。