Problems installing Prototype docs

[Wanderfels]

CONTENTS
=========

1. the long version
2. the short version
3. last but not least

1. THE LONG VERSION
===================


after installing the newest ruby i did:

--- snip ---
C:\>gem install rake maruku treetop
Successfully installed rake-0.9.2.2
Fetching: syntax-1.0.0.gem (100%)
Fetching: maruku-0.6.0.gem (100%)
Successfully installed syntax-1.0.0
Successfully installed maruku-0.6.0
Successfully installed treetop-1.4.10
4 gems installed
Installing ri documentation for rake-0.9.2.2...
Installing ri documentation for syntax-1.0.0...
Installing ri documentation for maruku-0.6.0...
Couldn't find file to include 'MaRuKu.txt' from lib/maruku.rb
Installing ri documentation for treetop-1.4.10...
Installing RDoc documentation for rake-0.9.2.2...
Installing RDoc documentation for syntax-1.0.0...
Installing RDoc documentation for maruku-0.6.0...
Couldn't find file to include 'MaRuKu.txt' from lib/maruku.rb
Installing RDoc documentation for treetop-1.4.10...

C:\>
--- snip ---

then i did

--- snip ---
C:\download\sstephenson-prototype-bb9d331>rake doc --trace
** Invoke doc (first_time)
** Invoke doc:build (first_time)
** Invoke doc:require (first_time)
** Execute doc:require

It looks like PDoc is missing the 'cannot load such file -- pdoc' gem.
Just run:


$ gem install cannot load such file -- pdoc

and you should be all set.
--- snip ---

to be true, as a non ruby user i tried this, ouch.
then i thought, and i found out: i stupid

--- snip ---
C:\download\sstephenson-prototype-bb9d331>gem install pdoc
Fetching: BlueCloth-1.0.1.gem (100%)
Fetching: oyster-0.9.5.gem (100%)
Fetching: pdoc-0.2.0.gem (100%)
Successfully installed BlueCloth-1.0.1
Successfully installed oyster-0.9.5
Successfully installed pdoc-0.2.0
3 gems installed
Installing ri documentation for BlueCloth-1.0.1...
Installing ri documentation for oyster-0.9.5...
Installing ri documentation for pdoc-0.2.0...
Installing RDoc documentation for BlueCloth-1.0.1...
Installing RDoc documentation for oyster-0.9.5...
Installing RDoc documentation for pdoc-0.2.0...
--- snip ---

ok, everything should be fine but now a new devilish (encoding?)
problem bites me:

--- snip ---
C:\download\sstephenson-prototype-bb9d331>rake doc --trace
** Invoke doc (first_time)
** Invoke doc:build (first_time)
** Invoke doc:require (first_time)
** Execute doc:require
rake aborted!
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/pdoc-0.2.0/lib/pdoc/generators/
html/helpers.rb:115: invalid multibyte char (US-ASCII)
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/pdoc-0.2.0/lib/pdoc/generators/
html/helpers.rb:115: invalid multibyte char (US-ASCII)
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/pdoc-0.2.0/lib/pdoc/generators/
html/helpers.rb:115: syntax error, unexpected $end, expecting
keyword_end
"[#{auto_link(match[1], options)}���]"
^
C:/RUBY/run/lib/ruby/site_ruby/1.9.1/rubygems/custom_require.rb:36:in
`require'
C:/RUBY/run/lib/ruby/site_ruby/1.9.1/rubygems/custom_require.rb:36:in
`require'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/pdoc-0.2.0/lib/pdoc/generators/
html.rb:3:in `<top (required)>'
C:/RUBY/run/lib/ruby/site_ruby/1.9.1/rubygems/custom_require.rb:36:in
`require'
C:/RUBY/run/lib/ruby/site_ruby/1.9.1/rubygems/custom_require.rb:36:in
`require'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/pdoc-0.2.0/lib/pdoc/generators.rb:
2:in `<top (required)>'
C:/RUBY/run/lib/ruby/site_ruby/1.9.1/rubygems/custom_require.rb:36:in
`require'
C:/RUBY/run/lib/ruby/site_ruby/1.9.1/rubygems/custom_require.rb:36:in
`require'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/pdoc-0.2.0/lib/pdoc.rb:17:in
`<top (required)>'
C:/RUBY/run/lib/ruby/site_ruby/1.9.1/rubygems/custom_require.rb:59:in
`require'
C:/RUBY/run/lib/ruby/site_ruby/1.9.1/rubygems/custom_require.rb:59:in
`rescue in require'
C:/RUBY/run/lib/ruby/site_ruby/1.9.1/rubygems/custom_require.rb:35:in
`require'
C:/download/sstephenson-prototype-bb9d331/Rakefile:186:in
`require_submodule'
C:/download/sstephenson-prototype-bb9d331/Rakefile:148:in
`require_pdoc'
C:/download/sstephenson-prototype-bb9d331/Rakefile:228:in `block (2
levels) in <top (required)>'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
205:in `call'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
205:in `block in execute'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
200:in `each'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
200:in `execute'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
158:in `block in invoke_with_call_chain'
C:/RUBY/run/lib/ruby/1.9.1/monitor.rb:211:in `mon_synchronize'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
151:in `invoke_with_call_chain'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
176:in `block in invoke_prerequisites'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
174:in `each'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
174:in `invoke_prerequisites'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
157:in `block in invoke_with_call_chain'
C:/RUBY/run/lib/ruby/1.9.1/monitor.rb:211:in `mon_synchronize'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
151:in `invoke_with_call_chain'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
176:in `block in invoke_prerequisites'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
174:in `each'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
174:in `invoke_prerequisites'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
157:in `block in invoke_with_call_chain'
C:/RUBY/run/lib/ruby/1.9.1/monitor.rb:211:in `mon_synchronize'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
151:in `invoke_with_call_chain'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:
144:in `invoke'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/
application.rb:116:in `invoke_task'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/
application.rb:94:in `block (2 levels) in top_level'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/
application.rb:94:in `each'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/
application.rb:94:in `block in top_level'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/
application.rb:133:in `standard_exception_handling'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/
application.rb:88:in `top_level'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/
application.rb:66:in `block in run'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/
application.rb:133:in `standard_exception_handling'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/lib/rake/
application.rb:63:in `run'
C:/RUBY/run/lib/ruby/gems/1.9.1/gems/rake-0.9.2.2/bin/rake:33:in `<top
(required)>'
C:/RUBY/run/bin/rake:19:in `load'
C:/RUBY/run/bin/rake:19:in `<main>'
Tasks: TOP => doc => doc:build => doc:require

C:\download\sstephenson-prototype-bb9d331>
--- snip ---

man i am so sick of horror like this. dont take it personally, it
sucks with most software installed via cmd on windose (linux is so
so). I LIKE STANDALONES.


2. THE SHORT VERSION
====================

Please compile it to downloadable html or pdf or chm (like those for
1.5). Installing another programming language + 3 addons + dev kit (ok
you removed that) just to get an html api doc? No, instead i started
my Download Manger and spidered api.prototypejs.org. Works. Sorry,
please dont get into my way. If anyone wants the zip, give me email or
tell me where to upload this.

3. LAST BUT NOT LEAST
====================

But despite that PROTOTYPE REALLY REALLY ROCKS! i use no other lib.
Thank you!