From: Ryan Davis <ryand@...>
Date: 2010-02-03T15:20:16+09:00
Subject: Re: rdoc_osx_dictionary 1.0.1 Released


On Jan 30, 2010, at 14:35 , Ed Ruder wrote:

> I had a similar problem, but with a merb gem (merb-slices). Output is 
> the first chunk, below.
> 
> I uninstalled all merb gems (some had 9 versions on my box!) and 'sudo 
> rdoc_osx_dictionary' seemed to succeed. Output is the second chunk, 
> below. Unfortunately, though the dictionary shows up in Dictionary.app, 
> and some Ruby entries show up as I type their names, no definitions are 
> rendered when I select an entry. Also, the canonical String#split method 
> doesn't even have an entry, though there are other String# methods ("/", 
> "blank?", and "camel_case" are the first few).

rvm? If so, that's the problem.

> Awesome idea! I just hope I can get it to work on my box!

Not my idea... I just cleaned it up, made it a gem, and a gem plugin.

> -------
> 
> [~]$ sudo rdoc_osx_dictionary

...

> - Extracting index data.
> No entry tag ** [<d:entry id="module_&lt;" d:title="<">
>  <d:index d:value="&lt;"/>
>  <d:index d:value="&lt;"/>
>  <h1>module &lt;</h1>
> 
>  <p>All Slice code is expected to be namespaced inside a module</p>
> 
> <h3>Class Methods:</h3><p>activate, deactivate, init, loaded, 
> setup_default_structure!, setup_router</p>
> <h3>From:</h3><p>merb-slices-1.0.12</p>
> </d:entry>

I tracked this down... merb-slices has some asinine code in it that befuddles rdoc. Technically it is a problem with rdoc, but really it is a problem with stupid merb code. Eg:

% more lib/generators/templates/full/lib/%base_name%.rb
...
  # All Slice code is expected to be namespaced inside a module
  module <%= module_name %>

>> Run Dictionary.app to use the new dictionary. (activate in prefs!)
>> ~> gem list | grep mime
>> mime-types (1.16)
>> mimetype-fu (0.1.2)

I still can't repro with this combo. I'll try again with those specific versions to make sure I didn't pick up something newer accidentally.