I''m trying to generate app docs on windows and getting the following error: C:\Projects\typo-2.5.2>rake appdoc (in C:/Projects/typo-2.5.2) rake aborted! Don''t know how to build task ''doc/README_FOR_APP'' Looking at the rake file, it looks like the second last line is the culprit but I''m not sure why: desc "Generate documentation for the application" Rake::RDocTask.new("appdoc") { |rdoc| rdoc.rdoc_dir = ''doc/app'' rdoc.title = "Rails Application Documentation" rdoc.options << ''--line-numbers --inline-source'' rdoc.rdoc_files.include(''doc/README_FOR_APP'') rdoc.rdoc_files.include(''app/**/*.rb'') }
I''m trying to generate app docs on windows and getting the following error: C:\Projects\typo-2.5.2>rake appdoc (in C:/Projects/typo-2.5.2) rake aborted! Don''t know how to build task ''doc/README_FOR_APP'' Looking at the rake file, it looks like the second last line is the culprit but I''m not sure why: desc "Generate documentation for the application" Rake::RDocTask.new("appdoc") { |rdoc| rdoc.rdoc_dir = ''doc/app'' rdoc.title = "Rails Application Documentation" rdoc.options << ''--line-numbers --inline-source'' rdoc.rdoc_files.include(''doc/README_FOR_APP'') rdoc.rdoc_files.include(''app/**/*.rb'') } _______________________________________________ Rails mailing list Rails-1W37MKcQCpIf0INCOvqR/iCwEArCW2h5@public.gmane.org http://lists.rubyonrails.org/mailman/listinfo/rails
Hi ! Hammed Malik said the following on 2005-08-10 15:47:> I''m trying to generate app docs on windows and getting the following error:I have a different error: $ rake appdoc (in D:/wwwroot/wpul.staging.teksol.info) rm -r doc/app rdoc -o doc/app --line-numbers --inline-source --title ''Rails Application Documentation'' -T ''html'' doc/README_FOR_APP [snip] rake aborted! undefined method `exitstatus'' for nil:NilClass Using --trace, I can see where Rake is crashing, rake-0.5.4/lib/rake.rb:485 The line in question: ok or fail "Command failed with status (#{status.exitstatus}): [#{show_command}]" I suspect the problem is with Windows'' command line limit - the command line is too long, and Windows won''t even start the Ruby interpreter. No known workaround at the moment, except to run rdoc manually, and let it find all *.rb files in the current folder and down. This takes a *huge* amount of time and memory (I have Rails 0.13.1 checked out in vendor/). Using more than 1 Gb of RAM is not uncommon. Hope that helps ! François
Thanks Francois! Turns out Typo doesn''t include CHANGELOG and README_FOR_APP files which rake was expecting (duh). I created empty files for the above and then ran into the problem you''ve described. Running Rdoc manually solved that. I''d really like to know why Rdoc is failing. On 8/11/05, François Beausoleil <fbeausoleil-IQIa899fVSs@public.gmane.org> wrote:> > Hi ! > > Hammed Malik said the following on 2005-08-10 15:47: > > I''m trying to generate app docs on windows and getting the following > error: > > I have a different error: > > $ rake appdoc > (in D:/wwwroot/wpul.staging.teksol.info) > rm -r doc/app > rdoc -o doc/app --line-numbers --inline-source --title ''Rails > Application Documentation'' -T ''html'' doc/README_FOR_APP [snip] > rake aborted! > undefined method `exitstatus'' for nil:NilClass > > Using --trace, I can see where Rake is crashing, rake-0.5.4 > /lib/rake.rb:485 > > The line in question: > ok or fail "Command failed with status (#{status.exitstatus}): > [#{show_command}]" > > I suspect the problem is with Windows'' command line limit - the command > line is too long, and Windows won''t even start the Ruby interpreter. > > No known workaround at the moment, except to run rdoc manually, and let > it find all *.rb files in the current folder and down. This takes a > *huge* amount of time and memory (I have Rails 0.13.1 checked out in > vendor/). Using more than 1 Gb of RAM is not uncommon. > > Hope that helps ! > François > > _______________________________________________ > Rails mailing list > Rails-1W37MKcQCpIf0INCOvqR/iCwEArCW2h5@public.gmane.org > http://lists.rubyonrails.org/mailman/listinfo/rails >-- Hammed Malik _______________________________________________ Rails mailing list Rails-1W37MKcQCpIf0INCOvqR/iCwEArCW2h5@public.gmane.org http://lists.rubyonrails.org/mailman/listinfo/rails
Has anyone discovered a work around for the ''exitstatus'' issue when running rake appdoc on windows? TIA, Ken On 8/11/05, Hammed Malik <hammed-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:> Thanks Francois! Turns out Typo doesn''t include CHANGELOG and README_FOR_APP > files which rake was expecting (duh). I created empty files for the above > and then ran into the problem you''ve described. Running Rdoc manually solved > that. I''d really like to know why Rdoc is failing. > > > On 8/11/05, François Beausoleil <fbeausoleil-IQIa899fVSs@public.gmane.org> wrote: > > Hi ! > > > > Hammed Malik said the following on 2005-08-10 15:47: > > > I''m trying to generate app docs on windows and getting the following > error: > > > > I have a different error: > > > > $ rake appdoc > > (in D:/wwwroot/wpul.staging.teksol.info) > > rm -r doc/app > > rdoc -o doc/app --line-numbers --inline-source --title ''Rails > > Application Documentation'' -T ''html'' doc/README_FOR_APP [snip] > > rake aborted! > > undefined method `exitstatus'' for nil:NilClass > > > > Using --trace, I can see where Rake is crashing, > rake-0.5.4/lib/rake.rb:485 > > > > The line in question: > > ok or fail "Command failed with status (#{status.exitstatus}): > > [#{show_command}]" > > > > I suspect the problem is with Windows'' command line limit - the command > > line is too long, and Windows won''t even start the Ruby interpreter. > > > > No known workaround at the moment, except to run rdoc manually, and let > > it find all *.rb files in the current folder and down. This takes a > > *huge* amount of time and memory (I have Rails 0.13.1 checked out in > > vendor/). Using more than 1 Gb of RAM is not uncommon. > > > > Hope that helps ! > > François > > > > _______________________________________________ > > Rails mailing list > > Rails-1W37MKcQCpIf0INCOvqR/iCwEArCW2h5@public.gmane.org > > http://lists.rubyonrails.org/mailman/listinfo/rails > > > > > > -- > Hammed Malik > > _______________________________________________ > Rails mailing list > Rails-1W37MKcQCpIf0INCOvqR/iCwEArCW2h5@public.gmane.org > http://lists.rubyonrails.org/mailman/listinfo/rails > > >