would love to solve 'rake doc:app' problem

rubyonrails-talk
1

I can build doc:plugins but not doc:app

$ rake doc:app --trace (in /home/storage/users/craig/svn/th-db/branches/phase5) ** Invoke doc:app (first_time) ** Invoke doc/app/index.html (first_time) rake aborted! Don't know how to build task 'doc/README_FOR_APP' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1634:in `' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:516:in `invoke_prerequisites' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1183:in `each' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1183:in `send' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1183:in `each' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:515:in `invoke_prerequisites' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:507:in `invoke_with_call_chain' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:501:in `synchronize' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:501:in `invoke_with_call_chain' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:518:in `invoke_prerequisites' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1183:in `each' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1183:in `send' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1183:in `each' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:515:in `invoke_prerequisites' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:507:in `invoke_with_call_chain' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:501:in `synchronize' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:501:in `invoke_with_call_chain' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:494:in `invoke' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1931:in `invoke_task' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1909:in `top_level' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1909:in `each' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1909:in `top_level' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1948:in `standard_exception_handling' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1903:in `top_level' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1881:in `run' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1948:in `standard_exception_handling' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/lib/rake.rb:1878:in `run' /usr/lib/ruby/gems/1.8/gems/rake-0.8.1/bin/rake:31 /usr/bin/rake:16:in `load' /usr/bin/rake:16

sh-3.2$ locate README_FOR_APP /usr/lib/ruby/gems/1.8/gems/rails-1.2.6/doc/README_FOR_APP

This is the file but even moving it to /tmp doesn't help...

How can I build doc:app ?

Craig

2

I can build doc:plugins but not doc:app

$ rake doc:app --trace (in /home/storage/users/craig/svn/th-db/branches/phase5) ** Invoke doc:app (first_time) ** Invoke doc/app/index.html (first_time) rake aborted! Don't know how to build task 'doc/README_FOR_APP'

This indicates that the file doc/README_FOR_APP is missing. This must be in your projects' directory, since rdoc uses it as homepage for the application documentation. I.e., you need a /home/storage/users/craig/svn/th-db/branches/phase5/doc/README_FOR_APP file in RDoc format. Normally the rails command creates a stub for this file.

sh-3.2$ locate README_FOR_APP /usr/lib/ruby/gems/1.8/gems/rails-1.2.6/doc/README_FOR_APP

This has nothing to do with doc:app for your project.

HTH,   Stefan

3

> > I can build doc:plugins but not doc:app > > $ rake doc:app --trace > (in /home/storage/users/craig/svn/th-db/branches/phase5) > ** Invoke doc:app (first_time) > ** Invoke doc/app/index.html (first_time) > rake aborted! > Don't know how to build task 'doc/README_FOR_APP'

This indicates that the file doc/README_FOR_APP is missing. This must be in your projects' directory, since rdoc uses it as homepage for the application documentation. I.e., you need a /home/storage/users/craig/svn/th-db/branches/phase5/doc/README_FOR_APP file in RDoc format. Normally the rails command creates a stub for this file.

> sh-3.2$ locate README_FOR_APP > /usr/lib/ruby/gems/1.8/gems/rails-1.2.6/doc/README_FOR_APP

This has nothing to do with doc:app for your project.