Forum: Ruby on Rails gem rdoc rails does not generate documentation

Announcement (2017-05-07): www.ruby-forum.com is now read-only since I unfortunately do not have the time to support and maintain the forum any more. Please see rubyonrails.org/community and ruby-lang.org/en/community for other Rails- und Ruby-related community platforms.
1924957eee03ddf35a65a3e8337f7f20?d=identicon&s=25 Stephan Dale (stephan)
on 2007-07-03 22:48
gem rdoc rails

That should generate documentation for rails but it doesn't. It works
for all other gems. It creates a directory
/usr/lib/ruby/gems/1.8/doc/rails-1.2.3/ which contains nothing. Rails
exists and works fine, I just can't create the docs (note that I can
create the docs for various components of rails - action* and active* -
but not the "root" docs).

Does anyone know anything about this problem?

Thanks.
6d3c187a8b3ef53b08e3e7e8572c4fea?d=identicon&s=25 Jeremy McAnally (Guest)
on 2007-07-04 00:56
(Received via mailing list)
You can always generate an application and then from the application
root run:

rake rails:doc

That drops a copy of the API docs in the doc/ folder.

--Jeremy

On 7/3/07, Stephan Dale <rails-mailing-list@andreas-s.net> wrote:
> Does anyone know anything about this problem?
>
> Thanks.
>
> --
> Posted via http://www.ruby-forum.com/.
>
> >
>


--
http://www.jeremymcanally.com/

My free Ruby e-book:
http://www.humblelittlerubybook.com/book/

My blogs:
http://www.mrneighborly.com/
http://www.rubyinpractice.com/
1924957eee03ddf35a65a3e8337f7f20?d=identicon&s=25 Stephan Dale (stephan)
on 2007-07-04 10:53
Thanks. I have done that in the past but I'd like to manage my
documentation using a single mechanism (i.e. gem) and have all docs
indexed from the same place (i.e. using gem_server at
http://localhost:8808/).

It shows the docs for every gem but rails.
Aa51486286524e73ecb228aeb9687da8?d=identicon&s=25 Jim Gagne (Guest)
on 2007-07-09 02:40
(Received via mailing list)
> You can always generate an application and then from the application root run:
> rake rails:doc

This doesn't work on my system (Mac, Ruby 1.8.6, Rails 1.2.3). I get
the following response:
(~/Rails/project)
rake aborted!
Don't know how to build task 'rails:doc'

I'm totally frustrated with RDoc. Can't find ANY of the documentation
it throws on the hard drive during gem and MacPorts installs.
---Jim Gagne---
1924957eee03ddf35a65a3e8337f7f20?d=identicon&s=25 Stephan Dale (stephan)
on 2007-07-09 10:26
On my system it's rake doc:rails.

You can see a list of available tasks with rake -T.
1924957eee03ddf35a65a3e8337f7f20?d=identicon&s=25 Stephan Dale (stephan)
on 2007-07-09 10:31
As for finding the documentation, you should be able to run gem_server
then visit http://localhost:8808/ for an index of the gem documentation
available.

My ruby installation lives in /usr/lib/ruby and the documentation is in
various subdirectories.

steph@localhost ~ $ cd /usr/lib/ruby
steph@localhost /usr/lib/ruby $ find . -name "doc"
./1.8/doc
./gems/1.8/doc
./gems/1.8/doc/rake-0.7.3/rdoc/files/doc
./gems/1.8/doc/rubygems-0.9.4/rdoc/files/doc
./gems/1.8/gems/rails-1.2.3/doc
./gems/1.8/gems/rake-0.7.3/doc
./gems/1.8/gems/vim-ruby-2006.07.11/doc
67b18e0e6de269790dee456a33ea1d31?d=identicon&s=25 Kevin Skoglund (Guest)
on 2007-07-09 13:51
(Received via mailing list)
Freeze your rails gem, then generate the document.  Like this:

rails sample_project
cd sample_project
rake rails:freeze:gems
rake doc:rails
rake rails:unfreeze

I wrote it up here:
http://www.nullislove.com/2007/05/29/rails-documentation/

And that post includes how to generate rdocs for Ruby too.

HTH,
Kevin Skoglund
32aa18dfc9703dc5dc7142c18c552e48?d=identicon&s=25 Not So Confused (confused)
on 2007-07-09 14:02
These are exactly the steps I am having problems with on a Windows
install. As per my post a couple below this one.

Anyone have any ideas that might help, please?

> rails sample_project
> cd sample_project
> rake rails:freeze:gems
> rake doc:rails
> rake rails:unfreeze
1924957eee03ddf35a65a3e8337f7f20?d=identicon&s=25 Stephan Dale (stephan)
on 2007-07-09 14:20
:-D Ok. Looks like my thread's in danger of turning in to a general
rails documentation topic. I'll reply to this question on your other
thread at http://www.ruby-forum.com/topic/114553

To return to my original question, does anyone know how to generate the
rails documentation with gem?
Aa51486286524e73ecb228aeb9687da8?d=identicon&s=25 Jim Gagne (Guest)
on 2007-07-26 00:46
(Received via mailing list)
I was having a lot of trouble getting gem to work properly. See
details at
http://groups.google.com/group/rubyonrails-talk/br...

I solved it by uninstalling and reinstalling gem. Now gem_server and
rake:freeze:gems work fine.
This topic is locked and can not be replied to.