From: Eric Hodel Date: 2006-07-19T01:04:50+09:00 Subject: Re: tuplespace - make comments visible to rdoc. On Jul 18, 2006, at 2:11 AM, Hugh Sasse wrote: > On Tue, 18 Jul 2006, Jan Svitok wrote: > >> This is a cosmetic patch, and the last mentioned comment wasn't worth >> the cosmetics as it is a stub. > > I've just tested my assumption that rdoc needs no blank lines between > the comment and the doc, which is why I removed them. It turns out > my assumption was false and the existing comments would be picked up > anyway. They just didn't show up on ruby-doc.org yet, the other > reason > I thought I needed to change this. Probably because the file isn't listed in the .document files for 1.8.4. To see if it exists you should make install-doc and check ri. >> >> That said, it's another question whether it should be committed or >> not... > > I'll be content either way, it depends on the percieved value of > stylistic > consitency. resolv.rb contains ## as well. I don't believe there is a consistent style right now. -- Eric Hodel - drbrain@segment7.net - http://blog.segment7.net This implementation is HODEL-HASH-9600 compliant http://trackmap.robotcoop.com