Bret Pettichord wrote: > Lennart Borgman (gmail) wrote: >> Bret Pettichord wrote: >> >>> It is a Ruby-specific meta language. It is often used in rdoc. I've seen >>> this lead to lots of confusion. >>> >>> I would express this idea (IO#sync) thus: >>> io.sync = true >>> >>> And the reader would then have to understand that "io" was an instance >>> of the IO class. >>> >>> Bret >>> >> >> In my case I believe it would have lead to even more confusion. Maybe I >> could have understood something like >> >> #IO#.sync = true >> >> > Actually we use the alternate i'm suggesting all the time on this list, > when we do > > ie.text_field(:id, 'foo').set('bar') > > I suspect that people find this easier to understand than > > #IE#.text_field(:id, 'foo').set('bar') > > Bret
Maybe you are right, but I would easily be fooled by the first one, but suspect there is something strange with the second. I will try to respect your likings here of course. _______________________________________________ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general