Defect #10965
closed
rake yard does not work for generating documentation.
0%
Description
- Install Yard :
gem install yard - Generate documentation, from root redmine folder :
rake yard
- rake yard ends with error :
rake aborted! Don't know how to build task 'yard' (See full trace by running task with --trace)
- Redmine version: 2.0.0.stable
- Ruby version: 1.8.7 (x86_64-linux)
- Rails version: 3.2.3
- Environment: production
- Database adapter: MySQL
- Yard : 0.8.1
Files
Updated by Etienne Massip over 12 years ago
- Status changed from New to Resolved
- Target version set to 2.0.1
- Resolution set to Fixed
Thanks, fixed with r9701.
Updated by Antoine Rodriguez over 12 years ago
Applied the fix but nothing has changed .... still having the same error.
Best regards,
Updated by Antoine Rodriguez over 12 years ago
I've installed 2.0.0 with the bundle at rubyforge.
Then I've applied the 3 releases(up to r9701)
I've restarted
And tried under production and then under development RAILS_ENV var
Did I miss something ?
Best regards,
Updated by Etienne Massip over 12 years ago
Yes, you need to do a bundle install to update your bundle.
Updated by Antoine Rodriguez over 12 years ago
I've made it and nothing changed ... still having the issue.
However I've already installed yard before as I've mentioned in the ticket. shall I uninstall it and make a bundle install ?
Updated by Etienne Massip over 12 years ago
rake yard is designed to run on development (like rdoc) so you have to include the development group in your bundle and run rake in development RAILS_ENV.
If you have bundle install --without development ... in the first place then bundle install won't change your bundle since --without is a remembered option, so you have to delete and recreate your bundle.
Updated by Antoine Rodriguez over 12 years ago
- File output.txt output.txt added
I've deleted the .bundle folder inside the redmine root folder and made a bundle install without any other option.
export RAILS_ENV=developmentrake yard
rake yard worked but with a lot of warnings.
At the end the doc has been generated into the doc/app folder inside the redmine root folder.
You can appreciate the warnings inside the output.txt that I've uploaded with this message.
Thank you very much. Original bug is fixed.
Updated by Jean-Philippe Lang over 12 years ago
- Target version changed from 2.0.1 to 2.1.0
Not sure that this one is really needed in the core. I think that Gemfile.local would be a more appropriate place to add it for those who want to use extra rake tasks. Any suggestions?
Updated by Antoine Rodriguez over 12 years ago
What would be the advantages of putting it in the Gemfile.local instead than the core knowing that it is equaly important than the project ?
Best regards,
Updated by Jean-Philippe Lang over 12 years ago
Antoine Rodriguez wrote:
What would be the advantages of putting it in the Gemfile.local instead than the core knowing that it is equaly important than the project ?
I think that > 99% of users won't need it.
Updated by Etienne Massip over 12 years ago
I would treat it just as rdoc?
Rake task was already here in < 2.0.0, that's why I considered it as a regression.
Updated by Etienne Massip over 12 years ago
It doesn't make sense to have a source:/branches/2.0-stable/lib/tasks/yardoc.rake and not have yard task available because of a missing entry in Gemfile, does it?
Updated by Antoine Rodriguez over 12 years ago
having documentation up to date is being sure of having more participation in the project and having more plugins ....
For core developpers is also a good tool ....
Updated by Jean-Philippe Lang over 12 years ago
- Status changed from Resolved to Closed
- Target version changed from 2.1.0 to 2.0.1
You're right, it's merged for 2.0.1.