30 Jul 2010, 01:37
Generic-user-small

John Shields (1 post)

I’m not having any luck with 3.0.0.RC following the steps to create a local version of the API. When I run “rake doc:rails” I get “Don’t know how to build task ‘README.rdoc’”. Any ideas?

30 Jul 2010, 20:13
Samr_small_pragsmall

Sam Ruby (584 posts)

Thanks! Reported to the rails team and a fix has already been applied. Will be fixed in the next release candidate.

01 May 2013, 18:18
Generic-user-small

Michael Bianchi (9 posts)

re: Agile Web Development with Rails 3.2 (4th edition)

I cannot generate the documentation as explained on page 13.
I get

pwd
/foveal/home/mbianchi/rails.d/dummy_app

rake doc:rails
rake aborted!
Don’t know how to build task ‘/usr/share/gems/gems/actionmailer-3.2.8/README.rdoc’
/foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task_manager.rb:49:in []' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:60:in lookup_prerequisite’
/foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:56:in block in prerequisite_tasks' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:56:in collect’
/foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:56:in prerequisite_tasks' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:203:in invoke_prerequisites’
/foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:183:in block in invoke_with_call_chain' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:177:in invoke_with_call_chain’
/foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:205:in block in invoke_prerequisites' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:203:in each’
/foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:203:in invoke_prerequisites' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:183:in block in invoke_with_call_chain’
/foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:177:in invoke_with_call_chain' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:170:in invoke’ /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:143:in invoke_task' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:101:in block (2 levels) in top_level’ /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:101:in each' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:101:in block in top_level’ /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:110:in run_with_threads' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:95:in top_level’ /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:73:in block in run' /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:160:in standard_exception_handling’ /foveal/home/mbianchi/.gem/ruby/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:70:in `run’ Tasks: TOP => doc:rails => doc/api/index.html (See full trace by running task with –trace)

gem list actionmailer

    *** LOCAL GEMS ***

    actionmailer (3.2.13, 3.2.8)

ls /usr/share/gems/gems/actionmailer-3.2.8/ MIT-LICENSE lib/

01 May 2013, 18:46
Samr_small_pragsmall

Sam Ruby (584 posts)

Perhaps try:

gem uninstall actionmailer -v 3.2.8

.

I just tried it on a fresh virtual machine, and I don’t see the problem:

$ rake doc:rails
rm -r doc/api
Parsing sources...
100% [503/503]  ...ant/.rvm/gems/ruby-2.0.0-p0/gems/railties-3.2.13/lib/rails.rb

Generating Darkfish format into /home/vagrant/work/dummy_app/doc/api...

Files:       503

Classes:     248 ( 123 undocumented)
Modules:     276 ( 176 undocumented)
Constants:   163 ( 143 undocumented)
Attributes:  227 ( 215 undocumented)
Methods:    2701 (1142 undocumented)

Total:      3615 (1799 undocumented)
 50.24% documented

Elapsed: 58.4s
01 May 2013, 19:31
Generic-user-small

Michael Bianchi (9 posts)

That fixed it. Thanks.

While I am here: pragprog.com/book/rails32/agile-web-development-with-rails-3-2 has no errata link. Nor does one show up in pragprog.com/my_bookshelf , although there are errata links for my other books.

The current version number for rails 3-2 is 0.0 .

  You must be logged in to comment