From: Jan Svitok Date: 2006-10-19T23:41:13+09:00 Subject: Re: Why Class decls and API docs don't Match On 10/19/06, gsm.beamon@gmail.com wrote: > Then how come layout can't be found can't be found in > ActionController::Base? > For in all C++/java/Eiffel languages layout() would be a method in > ActionController::Base > or its superclasses. Period. I can see your point. The problem here is that Ruby is a dynamic language. You cannot be sure what ends up where, unlike in C++/Java. RDoc catches (or at least tries to catch) those includes that occur within the class definition. Catching those that happen halfway through the program isn't that easy. The case with class method is exactly this case - the inclusion is triggered by calling extend ActionController::Layout::ClassMethods on AC::Base in AC::L::CM.included callback that is called by include AC::L in AC::B. You see it's pretty indirect. Still you have script/console, that allows you to ask AC::B about its methods.