win32-api 1.5.3-universal-mingw32 → 1.6.0-universal-mingw32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7e89ec0088d309d7ed30ab87ad2d0b657315af69
-  data.tar.gz: 9ac07477f90e4933338077c3e2fd63fff00d81a1
+  metadata.gz: 5dddc8231e05536fb92c98ec84398fc5f75e5ac1
+  data.tar.gz: b433d4cea0f55587dd0fe890d9ee0af1dc9b55b3
 SHA512:
-  metadata.gz: 9429c396c7ea80685f43117988e8d81a33b0f0559213ff8c014d96739da7fcdb7f42aa1977923020af3a06154d9c4aac82fb41128db66794656462209bc9dc94
-  data.tar.gz: b2330025011dbb3963e43529da40dcea113adab9f2839a10f5ff1ea53fd7d448faf8ebf7a16538a64a38c05cf71290dad5083c0d4eec4e04eee2a66cad6bbc0a
+  metadata.gz: 0c3b236d42c72c3eedbbed169bdcf0125d555bd4cfb6a7d61d66d3160b4f72164c8a9fdac3598527f55ddc8ed89c1fe4b4d57e3646ba0c66b7e9eb77300efd92
+  data.tar.gz: 7e85813a20a4c64b609d67571b098d50a7bd6802e7ce2e0bff68bad0019699a3e788bc4ebf8d97ac2bce96e40c7c3d503e19d93309164bf2697bde2ee0cbb5de

data/CHANGES

@@ -1,169 +1,174 @@
-== 1.5.3 - 18-Mar-2015
-* Now includes binaries for Ruby 2.2 for both 32 and 64 bit versions.
-* Fixed potential stack corruption caused by callbacks. Thanks go to
-  rickerliang for the spot and patch.
-* Some minor updates and additions to the Rakefile.
-
-== 1.5.2 - 11-Oct-2014
-* Now includes binaries for Ruby 2.1 for both 32 and 64 bit versions.
-* Some refactoring of the gem:binary task, mostly for me.
-
-== 1.5.1 - 14-Feb-2014
-* Fixed a potential zero-initialization issue. Thanks go to Peter Huene
-  for the spot and the patch.
-* Added rake as a development dependency.
-
-== 1.5.0 - 22-Aug-2013
-* Fixes for Ruby x64.
-* There are now separate 32 and 64 bit binaries packaged for Ruby 2.x.
-* Updates to the Rakefile for the gem:binary task.
-* Some README updates, including Future Plans.
-
-== 1.4.9 - 14-Jul-2013
-* Added a binary for Ruby 2.0.
-* Add devkit to Rakefile for the gem:binary task.
-
-== 1.4.8 - 16-Jan-2011
-* A binary for both 1.8.x and 1.9.x is now shipped as part of the binary
-  build. A stub file is used to dynamically require the correct binary based
-  on your current version of Ruby.
-* Some updates to the Rakefile to help build multiple binaries.
-
-== 1.4.7 - 4-Dec-2010
-* An internal error formatting function now resorts to the default
-  LANGID on error 1815 (ERROR_RESOURCE_LANG_NOT_FOUND). Thanks go to
-  Little Snake for the spot.
-* Added a default Rake task and refactored the clean task.
-
-== 1.4.6 - 9-Feb-2010
-* Fixed a warning that showed up with MinGW/gcc caused by an unnecessary
-  pointer dereference.
-* Some updates to the Rakefile and gemspec. Gem building is now handled via
-  Rake tasks.
-* Minor updates to the test suite.
-
-== 1.4.5 - 24-Aug-2009
-* Reverted the change in 1.4.4. We need unsigned longs in a few cases.
-  Consequently, you should upgrade windows-pr to 1.0.8 or later because
-  some return values were set to -1 instead of 0xFFFFFFFF as they are now.
-* Updated one test to validate return value from failed function.
-
-== 1.4.4 - 18-Aug-2009
-* Fixed a bug where functions that returned a long return type were unsigned
-  instead of signed.
-* The Rakefile has been refactored somewhat, including the removal of FFI
-  related tasks. Those are now in a separate branch in the repository.
-* The test-unit library is now a development dependency instead of a runtime
-  dependency.
-
-== 1.4.3 - 23-Jun-2009
-* Bug fix for mingw.
-* License now set to Artistic 2.0.
-
-== 1.4.2 - 31-May-2009
-* Updated the internal StringError() function to better handle the possibility
-  of the English .mui file not being found. Thanks go to Michel Demazure for
-  the spot.
-
-== 1.4.1 - 29-May-2009
-* Callback handling improvements.
-* Updated the gemspec description.
-
-== 1.4.0 - 19-Feb-2009
-* Now compatible with Ruby 1.9.x.
-* In what will go down as, "It seemed like a good idea at the time", I have
-  removed the feature where W (wide) character functions were used first if
-  your $KCODE environment variable was set to "UTF8". It caused too many
-  headaches in practice, especially amongst Rails users. You must now always
-  explicitly specify 'W' in the constructor if that's what you want.
-* Fixed RF bug #23944 - bad error message for MSVCRT functions that failed
-  to load properly.
-
-== 1.3.0 - 1-Jan-2009
-* Fixed RubyForge bug #23395, which was caused by inadvertently modifying
-  a variable within a loop. This caused callbacks to fail in certain
-  situations.
-* Added the Win32::API::LoadLibraryError and Win32::API::PrototypeError classes
-  to provide more fine grained handling of possible error conditions in the
-  constructor. These are both subclasses of Win32::API::Error.
-* Removed the Win32::API::CallbackError class.
-* Changed the upper limit on prototypes from 16 to 20. It turns out that
-  there are actually Windows functions with more than 16 prototypes.
-* Refactored a high iteration test so that it counts as only one test
-  instead of 1000.
-
-== 1.2.2 - 27-Nov-2008
-* Fixed bug in the error message for illegal prototypes and illegal return
-  types where the character in question would come out as empty or garbage.
-* Passing a bad return type to Win32::API::Callback now raises an error.
-* Updated the error message for illegal return types to say, "Illegal return
-  type" instead of "Illegal prototype" as it did previously.
-* The error message for a bad function name passed to Win32::API.new now
-  matches JRuby's FFI error message.
-* Improved the handling of msvcrt functions with regards to skipping 'A'
-  and 'W' checks. Previously it was checking against the literal string
-  'msvcrt'. Now it checks against any string that starts with 'msvcr'.
-* Added test-unit 2.x as a prerequisite.
-* Added tests for the Win32::API::Callback#address method.
-* Added tests to all Win32::API classes that explicitly check error messages.
-
-== 1.2.1 - 14-Nov-2008
-* Fixed and updated callback handling.
-* Fixed wide string return handling for pointers and strings.
-* Added the Win32::API::Callback#address instance method.
-* All errors are now in English instead of your native language, because
-  that's what Ruby itself does.
-
-== 1.2.0 - 22-Jul-2008
-* Added support for the 'S' (string) prototype and return type. It can be
-  used instead of 'P' (pointer) for const char*.
-* Some internal refactoring. The attempts to load ANSI and/or Wide character
-  versions of functions are skipped for MSVCRT functions, since they do not
-  exist. This eliminates some unnecessary LoadLibrary() calls.
-* Added a couple of gem building Rake tasks.
-* Added a few more tests.
-
-== 1.1.0 - 12-Jun-2008
-* Added the Windows::API::Function class. This is a subclass of Win32::API
-  meant only for use with raw function pointers.
-* Some documentation updates in the source and README files.
-
-== 1.0.6 - 18-Apr-2008
-* Added the effective_function_name method. This allows you to see what the
-  actual function name is that was defined, e.g. GetUserNameA vs GetUserNameW.
-* Replaced an instance of _tcscmp with strcmp. The case in question was always
-  going to be ASCII.
-* Cleaned up some -W3 warnings.
-* Added the build_manifest task to the Rakefile, which is automatically run if
-  you're using a version of Ruby built with VC++ 8 or later. This builds a
-  ruby.exe.manifest file (if it doesn't already exist).
-
-== 1.0.5 - 20-Nov-2007
-* The API.new method now defaults to "W" (wide character functions) before "A"
-  (ANSI functions) if the $KCODE global variable is set to 'u' (UTF8).
-* Minor improvements to the Rakefile.
-
-== 1.0.4 - 26-Oct-2007
-* Fixed a bug where methods that returned pointers ('P') could choke if the
-  resulting pointer was 0 or NULL. In this case, nil is now returned instead.
-* Tweak to the extconf.rb file that helps the gem build it from source
-  properly.
-
-== 1.0.3 - 28-Sep-2007
-* Fixed a subtle but dangerous copy-on-write bug in the API#call method.
-
-== 1.0.2 - 28-Sep-2007
-* Fixed a bug in an internal struct member that was causing segfaults. Thanks
-  go to Lars Olsson for the spot.
-* Fixed the 'install' task in the Rakefile. This only affected native builds,
-  not the prebuilt binary.
-* Added a few more tests.
-
-== 1.0.1 - 27-Sep-2007
-* Functions declared with a void prototype no longer require an explicit nil
-  argument to fulfill the arity requirement. You can still call them with an
-  explicit nil if you wish, however.
-* Fixed the gemspec for the native build.
-
-== 1.0.0 - 14-Sep-2007
-* Initial release
+== 1.6.0 - 09-Jun-2016
+* Now includes binaries for Ruby 2.3 for both 32 and 64 bit versions.
+* Now drop support Ruby 1.9 or earlier.
+* Some README and gemspec updates, including new maintainer information.
+
+== 1.5.3 - 18-Mar-2015
+* Now includes binaries for Ruby 2.2 for both 32 and 64 bit versions.
+* Fixed potential stack corruption caused by callbacks. Thanks go to
+  rickerliang for the spot and patch.
+* Some minor updates and additions to the Rakefile.
+
+== 1.5.2 - 11-Oct-2014
+* Now includes binaries for Ruby 2.1 for both 32 and 64 bit versions.
+* Some refactoring of the gem:binary task, mostly for me.
+
+== 1.5.1 - 14-Feb-2014
+* Fixed a potential zero-initialization issue. Thanks go to Peter Huene
+  for the spot and the patch.
+* Added rake as a development dependency.
+
+== 1.5.0 - 22-Aug-2013
+* Fixes for Ruby x64.
+* There are now separate 32 and 64 bit binaries packaged for Ruby 2.x.
+* Updates to the Rakefile for the gem:binary task.
+* Some README updates, including Future Plans.
+
+== 1.4.9 - 14-Jul-2013
+* Added a binary for Ruby 2.0.
+* Add devkit to Rakefile for the gem:binary task.
+
+== 1.4.8 - 16-Jan-2011
+* A binary for both 1.8.x and 1.9.x is now shipped as part of the binary
+  build. A stub file is used to dynamically require the correct binary based
+  on your current version of Ruby.
+* Some updates to the Rakefile to help build multiple binaries.
+
+== 1.4.7 - 4-Dec-2010
+* An internal error formatting function now resorts to the default
+  LANGID on error 1815 (ERROR_RESOURCE_LANG_NOT_FOUND). Thanks go to
+  Little Snake for the spot.
+* Added a default Rake task and refactored the clean task.
+
+== 1.4.6 - 9-Feb-2010
+* Fixed a warning that showed up with MinGW/gcc caused by an unnecessary
+  pointer dereference.
+* Some updates to the Rakefile and gemspec. Gem building is now handled via
+  Rake tasks.
+* Minor updates to the test suite.
+
+== 1.4.5 - 24-Aug-2009
+* Reverted the change in 1.4.4. We need unsigned longs in a few cases.
+  Consequently, you should upgrade windows-pr to 1.0.8 or later because
+  some return values were set to -1 instead of 0xFFFFFFFF as they are now.
+* Updated one test to validate return value from failed function.
+
+== 1.4.4 - 18-Aug-2009
+* Fixed a bug where functions that returned a long return type were unsigned
+  instead of signed.
+* The Rakefile has been refactored somewhat, including the removal of FFI
+  related tasks. Those are now in a separate branch in the repository.
+* The test-unit library is now a development dependency instead of a runtime
+  dependency.
+
+== 1.4.3 - 23-Jun-2009
+* Bug fix for mingw.
+* License now set to Artistic 2.0.
+
+== 1.4.2 - 31-May-2009
+* Updated the internal StringError() function to better handle the possibility
+  of the English .mui file not being found. Thanks go to Michel Demazure for
+  the spot.
+
+== 1.4.1 - 29-May-2009
+* Callback handling improvements.
+* Updated the gemspec description.
+
+== 1.4.0 - 19-Feb-2009
+* Now compatible with Ruby 1.9.x.
+* In what will go down as, "It seemed like a good idea at the time", I have
+  removed the feature where W (wide) character functions were used first if
+  your $KCODE environment variable was set to "UTF8". It caused too many
+  headaches in practice, especially amongst Rails users. You must now always
+  explicitly specify 'W' in the constructor if that's what you want.
+* Fixed RF bug #23944 - bad error message for MSVCRT functions that failed
+  to load properly.
+
+== 1.3.0 - 1-Jan-2009
+* Fixed RubyForge bug #23395, which was caused by inadvertently modifying
+  a variable within a loop. This caused callbacks to fail in certain
+  situations.
+* Added the Win32::API::LoadLibraryError and Win32::API::PrototypeError classes
+  to provide more fine grained handling of possible error conditions in the
+  constructor. These are both subclasses of Win32::API::Error.
+* Removed the Win32::API::CallbackError class.
+* Changed the upper limit on prototypes from 16 to 20. It turns out that
+  there are actually Windows functions with more than 16 prototypes.
+* Refactored a high iteration test so that it counts as only one test
+  instead of 1000.
+
+== 1.2.2 - 27-Nov-2008
+* Fixed bug in the error message for illegal prototypes and illegal return
+  types where the character in question would come out as empty or garbage.
+* Passing a bad return type to Win32::API::Callback now raises an error.
+* Updated the error message for illegal return types to say, "Illegal return
+  type" instead of "Illegal prototype" as it did previously.
+* The error message for a bad function name passed to Win32::API.new now
+  matches JRuby's FFI error message.
+* Improved the handling of msvcrt functions with regards to skipping 'A'
+  and 'W' checks. Previously it was checking against the literal string
+  'msvcrt'. Now it checks against any string that starts with 'msvcr'.
+* Added test-unit 2.x as a prerequisite.
+* Added tests for the Win32::API::Callback#address method.
+* Added tests to all Win32::API classes that explicitly check error messages.
+
+== 1.2.1 - 14-Nov-2008
+* Fixed and updated callback handling.
+* Fixed wide string return handling for pointers and strings.
+* Added the Win32::API::Callback#address instance method.
+* All errors are now in English instead of your native language, because
+  that's what Ruby itself does.
+
+== 1.2.0 - 22-Jul-2008
+* Added support for the 'S' (string) prototype and return type. It can be
+  used instead of 'P' (pointer) for const char*.
+* Some internal refactoring. The attempts to load ANSI and/or Wide character
+  versions of functions are skipped for MSVCRT functions, since they do not
+  exist. This eliminates some unnecessary LoadLibrary() calls.
+* Added a couple of gem building Rake tasks.
+* Added a few more tests.
+
+== 1.1.0 - 12-Jun-2008
+* Added the Windows::API::Function class. This is a subclass of Win32::API
+  meant only for use with raw function pointers.
+* Some documentation updates in the source and README files.
+
+== 1.0.6 - 18-Apr-2008
+* Added the effective_function_name method. This allows you to see what the
+  actual function name is that was defined, e.g. GetUserNameA vs GetUserNameW.
+* Replaced an instance of _tcscmp with strcmp. The case in question was always
+  going to be ASCII.
+* Cleaned up some -W3 warnings.
+* Added the build_manifest task to the Rakefile, which is automatically run if
+  you're using a version of Ruby built with VC++ 8 or later. This builds a
+  ruby.exe.manifest file (if it doesn't already exist).
+
+== 1.0.5 - 20-Nov-2007
+* The API.new method now defaults to "W" (wide character functions) before "A"
+  (ANSI functions) if the $KCODE global variable is set to 'u' (UTF8).
+* Minor improvements to the Rakefile.
+
+== 1.0.4 - 26-Oct-2007
+* Fixed a bug where methods that returned pointers ('P') could choke if the
+  resulting pointer was 0 or NULL. In this case, nil is now returned instead.
+* Tweak to the extconf.rb file that helps the gem build it from source
+  properly.
+
+== 1.0.3 - 28-Sep-2007
+* Fixed a subtle but dangerous copy-on-write bug in the API#call method.
+
+== 1.0.2 - 28-Sep-2007
+* Fixed a bug in an internal struct member that was causing segfaults. Thanks
+  go to Lars Olsson for the spot.
+* Fixed the 'install' task in the Rakefile. This only affected native builds,
+  not the prebuilt binary.
+* Added a few more tests.
+
+== 1.0.1 - 27-Sep-2007
+* Functions declared with a void prototype no longer require an explicit nil
+  argument to fulfill the arity requirement. You can still call them with an
+  explicit nil if you wish, however.
+* Fixed the gemspec for the native build.
+
+== 1.0.0 - 14-Sep-2007
+* Initial release

data/Gemfile

@@ -0,0 +1,4 @@
+# A sample Gemfile
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    win32-api (1.6.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    power_assert (0.3.0)
+    rake (11.1.2)
+    test-unit (3.1.9)
+      power_assert
+
+PLATFORMS
+  x64-mingw32
+  x86-mingw32
+
+DEPENDENCIES
+  rake
+  test-unit (>= 2.5.0)
+  win32-api!
+
+BUNDLED WITH
+   1.10.5

data/README

@@ -1,131 +1,129 @@
-= Description
-  This is a drop-in replacement for the Win32API library currently part of
-  Ruby's standard library.
-
-= Synopsis
-  require 'win32/api'
-  include Win32
-
-  # Typical example - Get user name
-  buf = 0.chr * 260
-  len = [buf.length].pack('L')
-
-  GetUserName = API.new('GetUserName', 'PP', 'I', 'advapi32')
-  GetUserName.call(buf, len)
-
-  puts buf.strip
-
-  # Callback example - Enumerate windows
-  EnumWindows     = API.new('EnumWindows', 'KP', 'L', 'user32')
-  GetWindowText   = API.new('GetWindowText', 'LPI', 'I', 'user32')
-  EnumWindowsProc = API::Callback.new('LP', 'I'){ |handle, param|
-    buf = "\0" * 200
-    GetWindowText.call(handle, buf, 200);
-    puts buf.strip unless buf.strip.empty?
-    buf.index(param).nil? ? true : false
-  }
-
-  EnumWindows.call(EnumWindowsProc, 'UEDIT32')
-
-  # Raw function pointer example - System beep
-  LoadLibrary    = API.new('LoadLibrary', 'P', 'L')
-  GetProcAddress = API.new('GetProcAddress', 'LP', 'L')
-
-  hlib = LoadLibrary.call('user32')
-  addr = GetProcAddress.call(hlib, 'MessageBeep')
-  func = Win32::API::Function.new(addr, 'L', 'L')
-  func.call(0)
-
-= Differences between win32-api and Win32API
-  * This library has callback support
-  * This library supports raw function pointers.
-  * This library supports a separate string type for const char* (S).
-  * Argument order change. The DLL name is now last, not first.
-  * Removed the 'N' and 'n' prototypes. Always use 'L' for longs now.
-  * Sensible default arguments for the prototype, return type and DLL name.
-  * Reader methods for the function name, effective function name, prototype,
-    return type and DLL.
-  * Removed the support for lower case prototype and return types. Always
-    use capital letters.
-
-= Developer's Notes
-  [NOTE: Some of the information below is now out of date, but explains my
-  motivation at the time the project was originally created.]
-
-  The current Win32API library that ships with the standard library has been
-  slated for removal from Ruby 2.0 and it will not receive any updates in the
-  Ruby 1.8.x branch. I have far too many libraries invested in it to let it
-  die at this point.
-
-  In addition, the current Win32API library was written in the bad old Ruby
-  1.6.x days, which means it doesn't use the newer allocation framework.
-  There were several other refactorings that I felt it needed to more closely
-  match how it was actually being used in practice.
-
-  The first order of business was changing the order of the arguments. By
-  moving the DLL name from first to last, I was able to provide reasonable
-  default arguments for the prototype, return type and the DLL. Only the
-  function name is required now.
-
-  There was a laundry list of other refactorings that were needed: sensical
-  instance variable names with proper accessors, removing support for lower
-  case prototype and return value characters that no one used in practice,
-  better naming conventions, the addition of RDoc ready comments and,
-  especially, callback and raw function pointer support.
-
-  Most importantly, we can now add, modify and fix any features that we feel
-  best benefit our end users.
-
-= Multiple Binaries
-  As of win32-api 1.4.8 a binary gem is shipped that contains binaries for
-  both Ruby 1.8, Ruby 1.9, and 2.x. For Ruby 2.x, both 32 and 64 bit binaries
-  are included as of release 1.5.0.
-
-  The file under lib/win32 dynamically requires the correct binary based on
-  your version of Ruby.
-
-= Documentation
-  The source file contains inline RDoc documentation. If you installed
-  this file as a gem, then you have the docs. Run "gem server" and point
-  your browser at http://localhost:8808 to see them.
-
-= Warranty
-  This package is provided "as is" and without any express or
-  implied warranties, including, without limitation, the implied
-  warranties of merchantability and fitness for a particular purpose.
-
-= Known Issues
-  Possible callback issues when dealing with multi-threaded applications.
-
-  Please submit any bug reports to the project page at
-  https://github.com/djberg96/win32-api
-
-== Contributions
-  Although this library is free, please consider having your company
-  setup a gittip if used by your company professionally.
-
-  http://www.gittip.com/djberg96/
-
-= Future Plans
-  I really don't have future plans for this library since you should use FFI
-  as your preferred C interface going forward. All of my own projects have
-  since been converted to either use FFI or an analogous OLE interface.
-
-  I will continue to maintain this library as long as there are folks out
-  there who are still using it, but I strongly encourage you to convert
-  your projects to FFI when possible.
-
-= Maintainer Wanted!
-  Since I no longer use this project, I would like to turn it over to
-  someone who has the skill, time and desire to keep it going.
-
-= Copyright
-  (C) 2003-2015 Daniel J. Berger
-  All Rights Reserved
-
-= License
-  Artistic 2.0
-
-= Authors
-  Daniel J. Berger
-  Park Heesob
+= Description
+  This is a drop-in replacement for the Win32API library currently part of
+  Ruby's standard library.
+
+= Synopsis
+  require 'win32/api'
+  include Win32
+
+  # Typical example - Get user name
+  buf = 0.chr * 260
+  len = [buf.length].pack('L')
+
+  GetUserName = API.new('GetUserName', 'PP', 'I', 'advapi32')
+  GetUserName.call(buf, len)
+
+  puts buf.strip
+
+  # Callback example - Enumerate windows
+  EnumWindows     = API.new('EnumWindows', 'KP', 'L', 'user32')
+  GetWindowText   = API.new('GetWindowText', 'LPI', 'I', 'user32')
+  EnumWindowsProc = API::Callback.new('LP', 'I'){ |handle, param|
+    buf = "\0" * 200
+    GetWindowText.call(handle, buf, 200);
+    puts buf.strip unless buf.strip.empty?
+    buf.index(param).nil? ? true : false
+  }
+
+  EnumWindows.call(EnumWindowsProc, 'UEDIT32')
+
+  # Raw function pointer example - System beep
+  LoadLibrary    = API.new('LoadLibrary', 'P', 'L')
+  GetProcAddress = API.new('GetProcAddress', 'LP', 'L')
+
+  hlib = LoadLibrary.call('user32')
+  addr = GetProcAddress.call(hlib, 'MessageBeep')
+  func = Win32::API::Function.new(addr, 'L', 'L')
+  func.call(0)
+
+= Differences between win32-api and Win32API
+  * This library has callback support
+  * This library supports raw function pointers.
+  * This library supports a separate string type for const char* (S).
+  * Argument order change. The DLL name is now last, not first.
+  * Removed the 'N' and 'n' prototypes. Always use 'L' for longs now.
+  * Sensible default arguments for the prototype, return type and DLL name.
+  * Reader methods for the function name, effective function name, prototype,
+    return type and DLL.
+  * Removed the support for lower case prototype and return types. Always
+    use capital letters.
+
+= Developer's Notes
+  [NOTE: Some of the information below is now out of date, but explains my
+  motivation at the time the project was originally created.]
+
+  The current Win32API library that ships with the standard library has been
+  slated for removal from Ruby 2.0 and it will not receive any updates in the
+  Ruby 1.8.x branch. I have far too many libraries invested in it to let it
+  die at this point.
+
+  In addition, the current Win32API library was written in the bad old Ruby
+  1.6.x days, which means it doesn't use the newer allocation framework.
+  There were several other refactorings that I felt it needed to more closely
+  match how it was actually being used in practice.
+
+  The first order of business was changing the order of the arguments. By
+  moving the DLL name from first to last, I was able to provide reasonable
+  default arguments for the prototype, return type and the DLL. Only the
+  function name is required now.
+
+  There was a laundry list of other refactorings that were needed: sensical
+  instance variable names with proper accessors, removing support for lower
+  case prototype and return value characters that no one used in practice,
+  better naming conventions, the addition of RDoc ready comments and,
+  especially, callback and raw function pointer support.
+
+  Most importantly, we can now add, modify and fix any features that we feel
+  best benefit our end users.
+
+= Multiple Binaries
+  As of win32-api 1.4.8 a binary gem is shipped that contains binaries for
+  both Ruby 1.8, Ruby 1.9, and 2.x. For Ruby 2.x, both 32 and 64 bit binaries
+  are included as of release 1.5.0.
+
+  The file under lib/win32 dynamically requires the correct binary based on
+  your version of Ruby.
+
+= Documentation
+  The source file contains inline RDoc documentation. If you installed
+  this file as a gem, then you have the docs. Run "gem server" and point
+  your browser at http://localhost:8808 to see them.
+
+= Warranty
+  This package is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
+
+= Known Issues
+  Possible callback issues when dealing with multi-threaded applications.
+
+  Please submit any bug reports to the project page at
+  https://github.com/djberg96/win32-api
+
+== Contributions
+  Although this library is free, please consider having your company
+  setup a gittip if used by your company professionally.
+
+  http://www.gittip.com/djberg96/
+
+= Future Plans
+  I really don't have future plans for this library since you should use FFI
+  as your preferred C interface going forward. All of my own projects have
+  since been converted to either use FFI or an analogous OLE interface.
+
+  I will continue to maintain this library as long as there are folks out
+  there who are still using it, but I strongly encourage you to convert
+  your projects to FFI when possible.
+
+= Copyright
+  (C) 2003-2015 Daniel J. Berger
+  (C) 2016 Hiroshi Hatake
+  All Rights Reserved
+
+= License
+  Artistic 2.0
+
+= Authors
+  Daniel J. Berger
+  Park Heesob
+  Hiroshi Hatake