README.rdoc in ppcurses-0.0.25 vs README.rdoc in ppcurses-0.1.0

@@ -1,23 +1,62 @@
-= PPCurses 
+= PPCurses
 
 Some convenience code to initialize curses and some rudimentary GUI classes.  See the **test** directory for example programs.
 
 == Install
-  [sudo] gem install 'ppcurses'
+  gem install 'ppcurses'
 
+  To use ppcurses with a ruby > 2.1.5 you must install the curses gem.
+
+  gem install 'curses'
+
 == Usage
   require 'rubygems'
   require 'ppcurses'
 
-  def displayMenu()
-    mainMenu = PPCurses::Menu.new( [ "Press", "<ESCAPE>", "to Quit" ], nil )
-    mainMenu.show()
-    mainMenu.getMenuSelection() 
-    mainMenu.close()
+  def displayMenu
+    mainMenu = PPCurses::Menu.new( [ "Press", "<ESCAPE>", "to Quit" ])
+    mainMenu.show
+    mainMenu.menu_selection
+    mainMenu.close
   end
   
-  screen = PPCurses::Screen.new()
-  screen.run { displayMenu() }
+  screen = PPCurses::Screen.new
+  screen.run { displayMenu }
 
-== References
-http://www.ruby-doc.org/stdlib-1.9.3/libdoc/curses/rdoc/Curses.html
+== Curses and Ruby
+
+There are several curses implementations for Ruby.
+
+[1. curses]
+
+ This is the implementation that PPCurses uses.  It was originally part of the Ruby
+ standard library and later got pushed out of the standard libary into a gem.
+
+ * http://www.ruby-doc.org/stdlib-1.9.3/libdoc/curses/rdoc/Curses.html
+ * http://www.ruby-doc.org/stdlib-2.0.0/libdoc/curses/rdoc/Curses.html
+ * http://www.ruby-doc.org/stdlib-2.1.0/libdoc/curses/rdoc/Curses.html
+ * https://rubygems.org/gems/curses
+ * https://github.com/ruby/curses
+
+[2. ncurses-ruby]
+
+ The heir to ncurses gem.  It is under active development.
+
+ * https://rubygems.org/gems/ncurses-ruby
+ * https://github.com/eclubb/ncurses-ruby
+
+[3. ncurses]
+
+ Created by Earle Clubb this gem has been frozen at version 0.9.1 since 2004. You
+ probably don't want this gem, you probably want ncurses-ruby.
+
+ * https://rubygems.org/gems/ncurses
+
+[4. ffi-curses]
+
+ A gem that makes curses available through FFI (foreign function interface), by
+ Sean O'Halpin. The latest version is from 2011 (0.4.0).
+
+* https://github.com/seanohalpin/ffi-ncurses
+* https://github.com/ffi/ffi
+