Dne 9.11.2011 17:02, Paul Wouters napsal(a):
> On Wed, 9 Nov 2011, Alex Dalitz wrote:
>
> (CC:ed Fedora-devel, we're trying to figure out the ruby bug with %3d ri-doc 
> names)
>
>>> I tried using yours and i had to make some xoes for it to build.
>>> It used "ruby-gems" instead of "rubygems". The was a "=" ->  "=3D"
>>> caused by one of our mail agents. then it tried something odd
>>> with a spec file template I commented out. The resulting build
>>> worked and had the identical issues, eg:
>>>
>>> /Library/Ruby/Gems/1.8/doc/dnsruby-1.53/ri/Dnsruby/Resolver/packet_timeout%3d-i.yaml
>>> /Library/Ruby/Gems/1.8/doc/dnsruby-1.53/ri/Dnsruby/Resolver/persistent_tcp%3d-i.yaml
>>> /Library/Ruby/Gems/1.8/doc/dnsruby-1.53/ri/Dnsruby/Resolver/persistent_udp%3d-i.yaml
>>> /Library/Ruby/Gems/1.8/doc/dnsruby-1.53/ri/Dnsruby/Resolver/port%3d-i.yaml
>> This is odd.
>>
>> The %3d characters in the filenames are because the Ruby setter methods are 
>> named "<variable_name>=" - this is a common pattern across all Ruby code. 
>> The filenames are generated by the rdoc tool - nothing to do with dnsruby or 
>> its packaging. This leads me to believe that all Ruby gems packaged as rpms 
>> would have this same problem - and yet this is surely not the case?
> right, though checking on mine, there is actually one other one:
>
> $ find /usr/lib/ruby/gems/1.8/doc/ |grep 3d |grep -v Dnsruby
> /usr/lib/ruby/gems/1.8/doc/pg-0.11.0/ri/PGconn/internal_encoding%3d-i.yaml
>
>> As a workaround, I suppose it's worth mentioning that the doc folder could 
>> simply be removed from the gem installation. That would then give an rpm 
>> with the Ruby code, but without access to the ri documentation system. Does 
>> this also contravene rpm guidelines?
> I talked about that, and was told they preferred the broken filenames
> over not having anything. Which is why it ended up packaged with these
> mistakes in fedora.
>
> Paul

Broken names? Please see percent encoding aka URL encoding [1]. You'll 
see that the '%3d' is actually '=', i.e. the file 
packet_timeout%3d-i.yaml obviously contains documentation for 
packet_timeout= method. You'll find a lot of such encoded characters in 
Ruby documentation and that is correct. That's how it works. It is not 
error, just warning.

Vit


[1] http://en.wikipedia.org/wiki/Percent_encoding
-- 
devel mailing list
devel@lists.fedoraproject.org
https://admin.fedoraproject.org/mailman/listinfo/devel

Reply via email to