On Dec 15, 2003, at 2:46 PM, Eric Hodel wrote:

> Dave Thomas (dave / pragprog.com) wrote:
>
>>
>> On Dec 15, 2003, at 16:18, Eric Hodel wrote:
>>
>>> Dave Thomas (dave / pragprog.com) wrote:
>>>
>>>> Folks:
>>>>
>>>> The new RDoc/ri code needs to have a system-level directory on the
>>>> user's machine where it can store the documentation. Where should 
>>>> this
>>>> be? My current thinking is
>>>>
>>>>   $prefix/site_ruby/<ver>/doc/rdoc
>>>>
>>>> Does this fit in with current conventions?
>>>
>>> Not on FreeBSD, documentation goes in /usr/local/share/doc/
>>> for third-party software.
>>
>> Except this isn't really documentation you can read - it's a bunch of
>> yaml-serialized objects... Would it still go in a directory outside 
>> the
>> Ruby tree?
>
> I'm not sure, maybe /usr/local/share/rdoc... IMHO it wouldn't go in the
> ruby tree, but I'm no expert.
>
> There are non-plain-text documents in /usr/local/share/doc, including
> HTML, PS, HPJL, Tex and troff.

Of course, perl pod documentation is in 
$prefix/lib/perl5/site_perl/$ver on
FreeBSD as well as every other platform I'm familiar with.