# Gem server doc page has broken rdoc link for rails

**URL:** <https://www.ruby-forum.com/t/gem-server-doc-page-has-broken-rdoc-link-for-rails/178372>\
**Category:** Rails\
**Created:** [November 3, 2009, 6:17pm UTC](https://www.ruby-forum.com/t/gem-server-doc-page-has-broken-rdoc-link-for-rails/178372 "2009-11-03T18:17:56Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![peter](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/278dde/32.png) [@peter](https://www.ruby-forum.com/u/peter)\
**Post date:** [November 3, 2009, 6:17pm UTC](https://www.ruby-forum.com/t/gem-server-doc-page-has-broken-rdoc-link-for-rails/178372/1 "2009-11-03T18:17:56Z")

</div>

Yup, newbie. Working my way through the Agile … Rails book and  
updated gem, rails, rake, and sqlite3 as per the book instructions.  
Then tried out the nifty “gem server” command to access the  
documentation. Everything is there except the rails rdoc link is  
broken:

`/doc\_root/rails-2.3.4/rdoc/index.html’ not found.

I found the documentation at /usr/lib/ruby/gems/1.8/doc (I am on a  
Mac). There are rails-1.2.6 and rails-2.2.2 directories that have  
rdoc and ri directories which are empty. I manually created a  
rails-2.3.4/rdoc directory and copied in the api docs I manually  
created by:

rails\_apps\> rails dummy\_app  
rails\_apps\> cd dummy\_app  
dummy\_app\> rake rails:freeze:gems  
dummy\_app\> rake doc:rails

The link is still broken. Of all the searching I did on this problem  
in Google and this group,I found two useful suggestions:

1. Uninstall and reinstall gem, but I can’t find any instructions to  
do this.

2. Generate the docs manually:

sudo gem rdoc rails

Installing ri documentation for rails-1.2.6…  
Installing ri documentation for rails-2.2.2…  
Installing ri documentation for rails-2.3.4…  
Installing RDoc documentation for rails-1.2.6…  
Installing RDoc documentation for rails-2.2.2…  
Installing RDoc documentation for rails-2.3.4…

This appeared to do absolutely nothing to the contents of /usr/lib/  
ruby/gems/1.8/doc/rails\*

Any suggestions?

---

<div class="post-metadata">

**Author:** ![peter](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/278dde/32.png) [@peter](https://www.ruby-forum.com/u/peter)\
**Post date:** [November 4, 2009, 11:47pm UTC](https://www.ruby-forum.com/t/gem-server-doc-page-has-broken-rdoc-link-for-rails/178372/2 "2009-11-04T23:47:06Z")

</div>

Just for kicks I installed ruby and rails via InstantRails on a  
Windows XP machine  
and it has the exact same problem - no local rails docs for either the  
version of  
rails that came with InstantRails 2.0 (2.0.2) or the upgraded version  
I installed  
with gem update rails (2.3.4).