2014-04-16 9 views
6

Io uso il comandoRake doc: app non riesce dopo l'aggiornamento a Ruby e Rails 2.1.1 4.1

rake doc:app 

di generare una documentazione rudimentale per la mia applicazione Rails. Ha sempre funzionato bene in passato. Ieri ho aggiornato l'app da Ruby 1.9.3 a 2.1.1 e Rails 3.2 a 4.1. Tutto funziona perfettamente con l'app, quindi sono andato a rigenerare la documentazione per la prima volta in poche settimane, e non è andata a buon fine. Ho eseguito il comando sopra ed ho ottenuto il seguente messaggio di errore:

rake aborted!                
Don't know how to build task 'README.rdoc'         
/home/vagrant/.rvm/gems/ruby-2.1.1/bin/ruby_executable_hooks:15:in `eval' 
/home/vagrant/.rvm/gems/ruby-2.1.1/bin/ruby_executable_hooks:15:in `<main>' 
Tasks: TOP => doc:app => doc/app/index.html         
(See full trace by running task with --trace) 

Credo che questo sia il messaggio di errore rastrello di serie offre per un'attività che non conosce. Come se mi sono imbattuto

rake foo 

Dà la cosa esatta, ma con 'pippo' invece di 'README.rdoc'. Ottengo gli stessi risultati quando corro

bundle exec rake doc:app 

Sto usando rake 10.2.2. Qualche idea su cosa sta succedendo?

+0

Indica che manca il file doc/README_FOR_APP. Durante la migrazione il file potrebbe essere scomparso. rdoc lo usa come home page, genererà un errore se questo manca – user944938

+0

Il file doc/README_FOR_APP è sicuramente lì. Ho anche creato un file README.rdoc vuoto e ho provato a modificare README_FOR_APP in README_FOR_APP.rdoc. Nessuna modifica al messaggio di errore dopo ognuna di queste azioni. –

+0

hai completato 'bundle install' dopo aver cambiato la versione ruby? allora hai provato a rimuovere 'README.rdoc'? –

risposta

12

Creare un file README.rdoc nella cartella root di progetto. Potresti averlo rimosso o sostituito con un README con un'altra estensione di tipo file.

+0

Grazie! Questo ha funzionato perfettamente. È fantastico che anche a domande vecchie come questa venga sempre data una risposta. –