做寶石rdoc railties的警告--ri

Question

我安裝了rails 3.2.8，以及gem update --system說的是最新的ruby gems，在Mac上運行ruby 1.9.3-p194。

當我做

gem rdoc railties --ri --overwrite 

我得到警告的太多了。 （ - 覆蓋沒有區別）。我發現不同的人抱怨，但沒有解決方案。

通過排序-u傳遞錯誤，獨特的線路有：

Gem::SourceIndex#add_spec called from /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/site_ruby/1.9.1/rubygems/source_index.rb:127. 
Gem::SourceIndex#initialize called from /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/site_ruby/1.9.1/rubygems/source_index.rb:67. 
Gem::SourceIndex#load_gems_in called from /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/site_ruby/1.9.1/rubygems/source_index.rb:322. 
Gem::SourceIndex#refresh! called from /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/site_ruby/1.9.1/rubygems/source_index.rb:95. 
Gem::SourceIndex#search called from /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/site_ruby/1.9.1/rubygems/commands/rdoc_command.rb:64. 
Gem::SourceIndex#spec_dirs= called from /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/site_ruby/1.9.1/rubygems/source_index.rb:94. 
Gem::SourceIndex.from_gems_in called from /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/site_ruby/1.9.1/rubygems/source_index.rb:47. 
Gem::SourceIndex.from_installed_gems called from /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/site_ruby/1.9.1/rubygems/commands/rdoc_command.rb:64. 
Gem::SourceIndex.installed_spec_directories called from /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/site_ruby/1.9.1/rubygems/source_index.rb:47. 
NOTE: Gem::SourceIndex#add_spec is deprecated, use Specification.add_spec. It will be removed on or after 2011-11-01. 
NOTE: Gem::SourceIndex#initialize is deprecated with no replacement. It will be removed on or after 2011-11-01. 
NOTE: Gem::SourceIndex#load_gems_in is deprecated with no replacement. It will be removed on or after 2011-11-01. 
NOTE: Gem::SourceIndex#refresh! is deprecated with no replacement. It will be removed on or after 2011-11-01. 
NOTE: Gem::SourceIndex#search is deprecated with no replacement. It will be removed on or after 2011-11-01. 
NOTE: Gem::SourceIndex#spec_dirs= is deprecated, use Specification.dirs=. It will be removed on or after 2011-11-01. 
NOTE: Gem::SourceIndex.from_gems_in is deprecated with no replacement. It will be removed on or after 2011-10-01. 
NOTE: Gem::SourceIndex.from_installed_gems is deprecated with no replacement. It will be removed on or after 2011-10-01. 
NOTE: Gem::SourceIndex.installed_spec_directories is deprecated, use Specification.dirs. It will be removed on or after 2011-11-01. 

這裏是我的寶石列表：

*** LOCAL GEMS *** 

actionmailer (3.2.8) 
actionpack (3.2.8) 
activemodel (3.2.8) 
activerecord (3.2.8) 
activerecord_constraints (0.1.1) 
activeresource (3.2.8) 
activesupport (3.2.8) 
arel (3.0.2) 
bigdecimal (1.1.0) 
builder (3.0.3) 
bundler (1.1.3) 
capistrano (2.13.3) 
coffee-rails (3.2.2) 
coffee-script (2.2.0) 
coffee-script-source (1.3.3) 
daemons (1.1.8) 
dalli (2.2.1) 
erubis (2.7.0) 
eventmachine (0.12.10) 
execjs (1.4.0) 
highline (1.6.14) 
hike (1.2.1) 
i18n (0.6.1) 
io-console (0.3) 
journey (1.0.4) 
jquery-rails (2.1.2) 
jquery-ui-rails (2.0.0) 
jruby-pageant (1.0.2) 
json (1.7.5) 
mail (2.4.4) 
mime-types (1.19) 
minitest (2.5.1) 
multi_json (1.3.6) 
net-scp (1.0.4) 
net-sftp (2.0.5) 
net-ssh (2.5.2) 
net-ssh-gateway (1.1.0) 
pg (0.14.1) 
polyglot (0.3.3) 
rack (1.4.1) 
rack-cache (1.2) 
rack-ssl (1.3.2) 
rack-test (0.6.1) 
rails (3.2.8) 
rails-footnotes (3.7.8) 
railties (3.2.8) 
rake (0.9.2.2) 
rdoc (3.12) 
rubygems-update (1.8.24) 
sass (3.1.19) 
sass-rails (3.2.5) 
sprockets (2.1.3) 
sqlite3 (1.3.6) 
thin (1.4.1) 
thor (0.16.0) 
tilt (1.3.3) 
treetop (1.4.10) 
tzinfo (0.3.33) 
uglifier (1.2.5) 

的 「ICK」 是 「裏的Rails ::引擎」實際上它有很多非常漂亮的文檔，並沒有產生任何輸出。我經常在我的Mac上遇到這種情況，並想要在我的Mac上獲得一整套文檔。

什麼可能是一個獨立的問題命令

gem rdoc bigdecimal --ri 

產生同樣的警告，但結尾：

ERROR: While executing gem ... (Errno::ENOENT) 
    No such file or directory - /usr/local/prvm/ruby-1.9.3-p194/lib/ruby/gems/1.9.1/gems/bigdecimal-1.1.0 

這是railties或RubyGems的或我的本地設置的問題嗎？

任何方法來解決它？

Answer 1

如果出現錯誤，RubyGems會明確地說出來，並用非零的錯誤代碼退出。就第一種情況而言，如您所見，您只會看到警告。

這些警告已在RubyGems中修復，但將修復程序移回到RubyGems 1.8並不容易。

對於第二種情況，我們的目標是通過Ruby 2.0中的「默認寶石」功能來解決這個問題。大規模的文檔是ruby的一部分，所以不需要重新生成它。

Answer 2

這個問題非常糟糕。我錯誤地將警告與「gem rdoc railties」沒有產生內部文檔的事實聯繫起來。我終於找到了這個特定的問題。出於某種原因，寶石規格排除所有文件。只要刪除該行，你會得到很好的文檔。

diff -c /tmp/railties-3.2.8.gemspec ./railties-3.2.8.gemspec 
*** /tmp/railties-3.2.8.gemspec 2012-09-19 08:40:57.000000000 -0500 
--- ./railties-3.2.8.gemspec 2012-09-19 08:39:32.000000000 -0500 
*************** 
*** 12,18 **** 
s.executables = ["rails"] 
s.files = ["bin/rails"] 
s.homepage = "http://www.rubyonrails.org" 
! s.rdoc_options = ["--exclude", "."] 
s.require_paths = ["lib"] 
s.required_ruby_version = Gem::Requirement.new(">= 1.8.7") 
s.rubygems_version = "1.8.24" 
--- 12,18 ---- 
s.executables = ["rails"] 
s.files = ["bin/rails"] 
s.homepage = "http://www.rubyonrails.org" 
! # s.rdoc_options = ["--exclude", "."] 
s.require_paths = ["lib"] 
s.required_ruby_version = Gem::Requirement.new(">= 1.8.7") 
s.rubygems_version = "1.8.24"