# Would love to solve 'rake doc:app' problem

**URL:** <https://www.ruby-forum.com/t/would-love-to-solve-rake-doc-app-problem/135011>\
**Category:** Rails\
**Created:** [April 17, 2008, 4:25am UTC](https://www.ruby-forum.com/t/would-love-to-solve-rake-doc-app-problem/135011 "2008-04-17T04:25:03Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![craigrails](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/c/c2a13f/32.png) [@craigrails](https://www.ruby-forum.com/u/craigrails)\
**Post date:** [April 17, 2008, 4:25am UTC](https://www.ruby-forum.com/t/would-love-to-solve-rake-doc-app-problem/135011/1 "2008-04-17T04:25:03Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![craigrails](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/c/c2a13f/32.png) [@craigrails](https://www.ruby-forum.com/u/craigrails)\
**Post date:** [April 17, 2008, 12:54pm UTC](https://www.ruby-forum.com/t/would-love-to-solve-rake-doc-app-problem/135011/2 "2008-04-17T12:54:32Z")

</div>

2008/4/16, Craig W. [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid):

> 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

---

<div class="post-metadata">

**Author:** ![craigrails](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/c/c2a13f/32.png) [@craigrails](https://www.ruby-forum.com/u/craigrails)\
**Post date:** [April 17, 2008, 6:32pm UTC](https://www.ruby-forum.com/t/would-love-to-solve-rake-doc-app-problem/135011/3 "2008-04-17T18:32:01Z")

</div>

On Thu, 2008-04-17 at 12:53 +0200, Stefan L. wrote:

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

* * *

gosh - that was easy…all I had to do was copy that file to my doc  
folder

Thanks…it did help

Craig