On Jan 12, 2006, at 7:03 AM, Greg Lorriman wrote: > ri's help is very handy, but there are no cross-references to related > classes/methods other than by chance mention in the text of the > method's/class's docs. This is especially important when trying to > find > a method/class whose name one doesn't know (particularly as a > beginner, > or with unfamiliar libraries). This would also aid a more organic > discovery of ruby libraries. > > Perhaps such a feature is only really possible in professional tools. > However I have so often felt the pain of this situation that I thought > to pose the possibility of such a feature to the Ruby community. > > All that is needed is a list of classes/methods at the end of the > normal documentation. For example Numeric#truncate could have a > list at > the end mentioning floor, ceil and Float#round. To be fair, there's no way that rdoc can know what methods are relevant to the current one unless they're cited explicitly. If they are, then use the html form of the documentation, rather than ri, and you'll find the inline references become hyperlinks to the other method descriptions. Cheers Dave