From: Jon <jon.forums@...>
Date: 2011-07-18T23:35:21+09:00
Subject: [ruby-core:38167] Re: Request for 1.9.3 release notes: properly mention 1.9.1 directory

> Since 1.9.2-p0 almost a year ago, as maintainer of RubyInstaller I've
> received several bug reports and personal emails about 1.9.1
> directories found inside Ruby 1.9.2 directory structure.
> 
> While mentioned in FAQ section, it is known that people don't read
> announcements fully, and triggers this chain of questions.
> 
> Can I ask that Ruby 1.9.3 announcement, which is supposed to be 1.9.1
> API compatible (as far ruby_1_9_3 branch states today) clearly
> documents this?
> 
> I'm not a native English speaker, but something like "Directories
> named 1.9.1 inside Ruby 1.9.3 exist because Ruby API compatibility
> level" or something like that.

I'd also like to see a new section added to the README (the main page of the Github mirror) since

  https://github.com/ruby/ruby/blob/trunk/README#L112-113

doesn't convey the important details of MRI's API or address the issue Luis raises. Very few will spend the time searching for, deciphering, and understanding the details in

  https://github.com/ruby/ruby/blob/trunk/include/ruby/version.h#L32-36 


Jon

---
blog: http://jonforums.github.com/
twitter: @jonforums

"Anyone who can only think of one way to spell a word obviously lacks imagination." - Mark Twain