rdoc
rdoc copied to clipboard
ruby
ri documentation stalls during installing with ruby
gem install rails stops during the installation of ri documentation for rails-4.2.3
using windows 7 start edition
I am also having this issue - so are many other people on various platforms - but they were filing against rails: https://github.com/rails/rails/issues/11814
In my case, I interrupted via ctrl-C and tried to re-run with --no-ri --no-rdoc, but too late - interrupting the process corrupted the ruby/gems/2.1.0/gems/rails-4.1.8/guides directory such that it is no longer owned by any user and not even takeown.exe can get it back - now I have to boot into safe-mode to delete the directory. I am on Windows-7 Professional.
$ gem install -v=4.1.8 rails Successfully installed rails-4.1.8 Parsing documentation for rails-4.1.8 Installing ri documentation for rails-4.1.8 ERROR: Interrupted $ gem install -v=4.1.8 rails --no-ri --no-rdoc ERROR: While executing gem ... (Errno::EACCES) Permission denied @ rb_sysopen - C:/RailsInstaller/Ruby2.1.0/lib/ruby/gems/2.1.0/gems/rails-4.1.8/guides/CHANGELOG.md
RDoc is not exactly the fastest piece of software, unfortunately.. and I can see how you might run into IO issues with parsing a large project like Rails.
Moving forward we should use Rails as benchmark and try to improve parse time for it, but at the moment I don't currently have a plan to do that.
Open to ideas.
On my CentOS box (Release 6.6, Linux Kernel 2.6.32-504 el6 i686), with 2.0 GiB, Pentium 4 cpu 40Ghz (yes, it's an old 32-bit box), when I did the "gem install rails" from command line, the install process sat for over 30 minutes on the "Parsing documentation for rails-4.2.5.1" line. I thought it had died, but the process was running (about 98% cpu time, reported by "top"), and it did finally
complete. (Built Ruby from source. "ruby -v" reports: ruby 2.3.0p0 (2015-12-25 revision 53290) )
The Rails install reported 2141 seconds for the elapsed time. That's 35.68 minutes to install the system docs. (?)
There is a closed thread about this at: https://github.com/rails/rails/issues/11814
The fellow who closed the thread pointed me here. It was very useful to go thru that "Rails fails to install" thread, as those who waited, indicated the install usually finished, but took a long time.
So, as an immediate workaround, esp. for new folks like me doing a "Rails" install, when it gets to the slow thing where it may wait for half-an-hour or more, it would be helpful if the install process could just display a little note saying: "Note: This step to install the "Rails" documentation takes QUITE A LONG TIME. Like maybe half-an-hour or more... Go get a coffee. It will probably finish. Please just wait." A new user, learning the thing, probably wants the docs. I didn't mind waiting.
I saw lots of examples where the Rails install example shows how to exclude the docs. Better workaround is probably just to tell the new user it will take a while to do it.
And hey, thanx to everyone working on this.
I enter: "rails --version", and I get response: "Rails 4.2.5.1" , so I'm happy!
CentOS-6.7 x86_64 quad core cpu 2666.330MHz RAM 4Gb ruby 2.2.3p173 rdoc-4.2.1
Running rdoc on a Rails-4.2.5.1 project's installed gems taking 100% of one cpu and has been running for 48 minutes as of this report. The only output to this point is an empty file called created.rid.
PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND
5998 byrnejb 20 0 801m 655m 2796 R 100.1 17.1 48:28.33 rdoc
Some time later:
5998 byrnejb 20 0 801m 655m 2796 R 99.7 17.1 84:11.48 rdoc
Much, much later:
5998 byrnejb 20 0 801m 655m 2796 R 100.1 17.1 403:51.30 rdoc
At which point I canned it.
Not sure if this is the right place for this, but I just had the same issue (in Ubunutu 14.04LTS) as everyone here: https://github.com/rails/rails/issues/11814
...
Parsing documentation for sprockets-rails-3.0.1
Installing ri documentation for sprockets-rails-3.0.1
Parsing documentation for rails-4.2.5.1
Installing ri documentation for rails-4.2.5.1
^CERROR: Interrupted
Hung for five minutes. System monitor showed ruby using 1 whole CPU. Solution was to Ctrl-C and repeat previous command exactly, "gem install rails". It immediately finished.
Successfully installed rails-4.2.5.1
Parsing documentation for rails-4.2.5.1
Done installing documentation for rails after 1 seconds
1 gem installed
Same issue as above, Ubuntu 14.04, installing ri documentation for Rails took 10 minutes
