win32-dir 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 24b10fb838eab01de3c979978c409486ac5872a0
-  data.tar.gz: c6470c51e09422329b405da037abe29b4f9b5cd3
+  metadata.gz: 0fa2671864fff6d5baf15a94c38d5d49066c2a2f
+  data.tar.gz: c036f3097b86f3f178da31c4105d71f44a7b22b6
 SHA512:
-  metadata.gz: f3d329bdb7408ba5d3beffea8cb486c80418875286e00115543cf223245331ba42ac56ec6e4f050f652163ffcab4b1d2b1b0b66d51eed762011f0ce357cc58db
-  data.tar.gz: 09bf9aa59a279a681f525a7fac0cf416f9b4fbcca8047f3d95dc89dbacd9033e49423852b37454c4e1dec2db28c962f43d22e21a329f098c40b8517c016908ab
+  metadata.gz: b55fc21bbba08fae66acddec7c5b635c717b3c38f8aec3726f20f68491b9c4e502ad904405f938ccc174caa0a3eff43b664c0aab2ce0aa63299c569ceb63f350
+  data.tar.gz: d029bbc35525ab75ea5d6afaf02e5a02233e3feb0cf56aa4b42bed668c50d856e8d6c2bbe00e5b31aa401bc2eb5a3c1ef225714e612a8090548466a95551290b

data/CHANGES

@@ -1,116 +1,121 @@
-== 0.5.0 - 15-Oct-2014
-* Fixed an encoding error in an error message in the Dir.read_junction method.
-  Thanks go to topac for the spot and patch.
-* Replaced File.exists? with File.exist? in the test suite to avoid warnings
-  in Ruby 2.1 and later.
-* Do not let the version number fool you, this is not a major release. I
-  simply ran out of version numbers.
-
-== 0.4.9 - 2-Jul-2014
-* Fixed the INVALID_FILE_ATTRIBUTES constant. It's only a 32-bit value.
-  Thanks go to Ethan Brown for the patch.
-* Use relative_require instead of manually doing things.
-* Removed rubyforge_project from gemspec.
-* Added a string_check to the Dir.junction? method.
-
-== 0.4.8 - 27-Apr-2014
-* More closely mimic Ruby's stringiness checks for overrided methods.
-
-== 0.4.7 - 26-Apr-2014
-* All arguments to methods are now interpolated so that they'll use whatever 
-  to_str implemenation the argument provides instead of assuming String
-  arguments. This change was made because it turns out that at least some
-  of the overridden methods in MRI accept Pathname objects. Thanks go to
-  Josh Cooper/Puppet Labs for the spot.
-* Refactored the Dir.getwd method to use bonafide FFI buffers instead of
-  naked Ruby char buffers.
-* Internally various functions now fail in the event that the resulting
-  paths would exceed their buffers.
-
-== 0.4.6 - 21-Oct-2013
-* Fixed the INVALID_HANDLE_VALUE and INVALID_FILE_ATTRIBUTES constants for
-  64-bit versions of Ruby.
-* Added Rake as a development dependency.
-
-== 0.4.5 - 23-Sep-2013
-* Yet another encoding fix, this time one that affected JRuby.
-* Fixed the Dir[] and Dir.glob methods so they match the spec. Thanks go
-  to Chris Westbrook for the spot.
-
-== 0.4.4 - 22-Sep-2013
-* Yet another encoding fix. Thanks go to Rob Reynolds for the patch.
-
-== 0.4.3 - 24-Jul-2013
-* Changed the Dir.read_junction and CSIDL constant strings so that they
-  use the default external encoding instead of UTF-16LE. This means that
-  they will now work with methods like File.join. Thanks go to Josh Cooper
-  for the patches.
-* Some changes for internal handling of making FFI functions private.
-* Updated gem:create task for rubygems 2.
-
-== 0.4.2 - 8-Apr-2013
-* Fixed the HANDLE function prototypes in the underlying FFI code and added
-  some custom typedefs for convenience. This affects 64 bit Ruby code.
-
-== 0.4.1 - 2-Oct-2012
-* Added the Dir.read_junction method. Thanks go to Gabriel Wilkins for the patch.
-
-== 0.4.0 - 29-Jun-2012
-* Conversion to FFI. Should work with JRuby now.
-* If current versions of Dir::XXX constant values cannot be found
-  then default values are tried.
-* Now requires Ruby 1.9 or later.
-
-== 0.3.7 - 18-Jul-2010
-* Modified Dir.glob and Dir[] to handle backslashes in path names.
-* Added tests for the modified Dir.glob and Dir[] behavior.
-* Removed the old non-gem install Rake task.
-
-== 0.3.6 - 6-Feb-2010
-* Bug fixes for Ruby 1.9.x. Thanks go to Kendall Gifford for the spot and
-  the patch.
-* Minor refactoring of the Dir.create_junction method. This fixed a bug for
-  Ruby 1.9.x, but was also a little cleaner in general.
-* Some Rakefile task and gemspec updates.
-
-== 0.3.5 - 6-Aug-2009
-* Changed the license to Artistic 2.0.
-* Updated the gemspec, including the addition of a license attribute and
-  test-unit as a development dependency.
-
-== 0.3.4 - 5-May-2009
-* Redefined the Dir.getwd (and the Dir.pwd alias) to always return a
-  normalized path.
-* Some gemspec updates.
-
-== 0.3.3 - 30-Mar-2009
-* Virtual folders like Dir::CONTROL, which were previously almost always nil,
-  are now set to their display name.
-* Fixed a bug in the create_junction method.
-* Added an 'example' rake task to run the example code.
-* Renamed the example program from dir_test.rb to dir_example.rb to prevent
-  any potential confusion that it's a genuine test file.
-
-== 0.3.2 - 25-Jul-2007
-* Added a Rakefile with tasks for testing and installation.
-* Removed the install.rb file (the Rakefile handles installation).
-* Minor updates the README, MANIFEST, and test file.
-
-== 0.3.1 - 16-Oct-2006
-* Added the Dir.empty? method.
-* Changed the Dir.reparse_dir? method to Dir.junction? (but kept an alias
-  for backwards compatibility).
-* Added rdoc for Dir.junction? (oops).
-* Some test tweaks and additions.
-
-== 0.3.0 - 28-May-2006
-* Now pure Ruby.
-* Now has a gem.
-* Added a VERSION constant.
-
-== 0.2.0 - 27-Jun-2005
-* Added the Dir.create_junction and Dir.reparse_dir? methods.
-* Added corresponding tests and documentation.
-
-== 0.1.0 - 25-Feb-2005
-* Initial release
+== 0.5.1 - 20-Oct-2015
+* The gem is now signed.
+* The Rakefile gem tasks now assume Rubygems 2.x.
+* Added a win32-dir.rb file for convenience.
+
+== 0.5.0 - 15-Oct-2014
+* Fixed an encoding error in an error message in the Dir.read_junction method.
+  Thanks go to topac for the spot and patch.
+* Replaced File.exists? with File.exist? in the test suite to avoid warnings
+  in Ruby 2.1 and later.
+* Do not let the version number fool you, this is not a major release. I
+  simply ran out of version numbers.
+
+== 0.4.9 - 2-Jul-2014
+* Fixed the INVALID_FILE_ATTRIBUTES constant. It's only a 32-bit value.
+  Thanks go to Ethan Brown for the patch.
+* Use relative_require instead of manually doing things.
+* Removed rubyforge_project from gemspec.
+* Added a string_check to the Dir.junction? method.
+
+== 0.4.8 - 27-Apr-2014
+* More closely mimic Ruby's stringiness checks for overrided methods.
+
+== 0.4.7 - 26-Apr-2014
+* All arguments to methods are now interpolated so that they'll use whatever 
+  to_str implemenation the argument provides instead of assuming String
+  arguments. This change was made because it turns out that at least some
+  of the overridden methods in MRI accept Pathname objects. Thanks go to
+  Josh Cooper/Puppet Labs for the spot.
+* Refactored the Dir.getwd method to use bonafide FFI buffers instead of
+  naked Ruby char buffers.
+* Internally various functions now fail in the event that the resulting
+  paths would exceed their buffers.
+
+== 0.4.6 - 21-Oct-2013
+* Fixed the INVALID_HANDLE_VALUE and INVALID_FILE_ATTRIBUTES constants for
+  64-bit versions of Ruby.
+* Added Rake as a development dependency.
+
+== 0.4.5 - 23-Sep-2013
+* Yet another encoding fix, this time one that affected JRuby.
+* Fixed the Dir[] and Dir.glob methods so they match the spec. Thanks go
+  to Chris Westbrook for the spot.
+
+== 0.4.4 - 22-Sep-2013
+* Yet another encoding fix. Thanks go to Rob Reynolds for the patch.
+
+== 0.4.3 - 24-Jul-2013
+* Changed the Dir.read_junction and CSIDL constant strings so that they
+  use the default external encoding instead of UTF-16LE. This means that
+  they will now work with methods like File.join. Thanks go to Josh Cooper
+  for the patches.
+* Some changes for internal handling of making FFI functions private.
+* Updated gem:create task for rubygems 2.
+
+== 0.4.2 - 8-Apr-2013
+* Fixed the HANDLE function prototypes in the underlying FFI code and added
+  some custom typedefs for convenience. This affects 64 bit Ruby code.
+
+== 0.4.1 - 2-Oct-2012
+* Added the Dir.read_junction method. Thanks go to Gabriel Wilkins for the patch.
+
+== 0.4.0 - 29-Jun-2012
+* Conversion to FFI. Should work with JRuby now.
+* If current versions of Dir::XXX constant values cannot be found
+  then default values are tried.
+* Now requires Ruby 1.9 or later.
+
+== 0.3.7 - 18-Jul-2010
+* Modified Dir.glob and Dir[] to handle backslashes in path names.
+* Added tests for the modified Dir.glob and Dir[] behavior.
+* Removed the old non-gem install Rake task.
+
+== 0.3.6 - 6-Feb-2010
+* Bug fixes for Ruby 1.9.x. Thanks go to Kendall Gifford for the spot and
+  the patch.
+* Minor refactoring of the Dir.create_junction method. This fixed a bug for
+  Ruby 1.9.x, but was also a little cleaner in general.
+* Some Rakefile task and gemspec updates.
+
+== 0.3.5 - 6-Aug-2009
+* Changed the license to Artistic 2.0.
+* Updated the gemspec, including the addition of a license attribute and
+  test-unit as a development dependency.
+
+== 0.3.4 - 5-May-2009
+* Redefined the Dir.getwd (and the Dir.pwd alias) to always return a
+  normalized path.
+* Some gemspec updates.
+
+== 0.3.3 - 30-Mar-2009
+* Virtual folders like Dir::CONTROL, which were previously almost always nil,
+  are now set to their display name.
+* Fixed a bug in the create_junction method.
+* Added an 'example' rake task to run the example code.
+* Renamed the example program from dir_test.rb to dir_example.rb to prevent
+  any potential confusion that it's a genuine test file.
+
+== 0.3.2 - 25-Jul-2007
+* Added a Rakefile with tasks for testing and installation.
+* Removed the install.rb file (the Rakefile handles installation).
+* Minor updates the README, MANIFEST, and test file.
+
+== 0.3.1 - 16-Oct-2006
+* Added the Dir.empty? method.
+* Changed the Dir.reparse_dir? method to Dir.junction? (but kept an alias
+  for backwards compatibility).
+* Added rdoc for Dir.junction? (oops).
+* Some test tweaks and additions.
+
+== 0.3.0 - 28-May-2006
+* Now pure Ruby.
+* Now has a gem.
+* Added a VERSION constant.
+
+== 0.2.0 - 27-Jun-2005
+* Added the Dir.create_junction and Dir.reparse_dir? methods.
+* Added corresponding tests and documentation.
+
+== 0.1.0 - 25-Feb-2005
+* Initial release

data/MANIFEST

@@ -1,8 +1,10 @@
-* README
-* MANIFEST
-* CHANGES
-* Rakefile
-* win32-dir.gemspec
-* examples/dir_example.rb
-* lib/win32/dir.rb
-* test/test_win32_dir.rb
+* README
+* MANIFEST
+* CHANGES
+* Rakefile
+* win32-dir.gemspec
+* examples/dir_example.rb
+* certs/djberg96_pub.pem
+* lib/win32-dir.rb
+* lib/win32/dir.rb
+* test/test_win32_dir.rb

data/README

@@ -1,273 +1,273 @@
-= Description
-  A series of extra constants for the Dir class that define special folders
-  on MS Windows systems, as well as methods for creating and detecting
-  junctions, i.e. symlinks for directories.
-
-= Installation
-  gem install win32-dir
-
-= Synopsis
-  require 'win32/dir'
-	
-  # C:\WINNT or C:\WINDOWS
-  puts Dir::WINDOWS
-
-  # C:\Documents and Settings\Daniel\Start Menu\Programs\Administrative Tools	 
-  puts Dir::ADMINTOOLS
-	
-  Dir.mkdir('C:\from')
-  Dir.create_junction('C:\to', 'C:\from')
-
-= Constants
-  Not all of these are guaranteed to be defined on your system. Also note
-  that the directories are merely defined. It doesn't necessarily mean they
-  actually exist.
-	
-== The following constants should be defined:	
-Dir::ADMINTOOLS
-  The file system directory that is used to store administrative tools for an
-  individual user. The Microsoft Management Console (MMC) will save
-  customized consoles to this directory, and it will roam with the user.
-
-Dir::COMMON_ADMINTOOLS
-  The file system directory containing administrative tools for all users
-  of the computer.
-	
-Dir::APPDATA
-  The file system directory that serves as a common repository for
-  application-specific data. A typical path is
-  C:\Documents and Settings\<user>\Application Data.
-   
-  This CSIDL is supported by the redistributable shfolder.dll for
-  systems that do not have the Microsoft Internet Explorer 4.0
-  integrated Shell installed.
-	
-Dir::COMMON_APPDATA
-  The file system directory containing application data for all users. A
-  typical path is C:\Documents and Settings\All Users\Application Data.
-	
-Dir::COMMON_DOCUMENTS
-  The file system directory that contains documents that are common to all
-  users. A typical paths is C:\Documents and Settings\All Users\Documents.
-	
-Dir::COOKIES
-  The file system directory that serves as a common repository for Internet
-  cookies. A typical path is C:\Documents and Settings\<user>\Cookies.
-
-Dir::HISTORY
-  The file system directory that serves as a common repository for Internet
-  history items.
-
-Dir::INTERNET_CACHE
-  The file system directory that serves as a common repository for temporary
-  Internet files. A typical path is
-  C:\Documents and Settings\<user>\Local Settings\Temporary Internet Files.
-
-Dir::LOCAL_APPDATA
-  The file system directory that serves as a data repository for local
-  (nonroaming) applications. A typical path is
-  C:\Documents and Settings\<user>\Local Settings\Application Data.
-
-Dir::MYPICTURES
-  The file system directory that serves as a common repository for image
-  files. A typical path is
-  C:\Documents and Settings\<user>\My Documents\My Pictures.
-	
-Dir::PERSONAL
-  The virtual folder representing the My Documents desktop item. This is
-  equivalent to Dir::MYDOCUMENTS.
-
-Dir::PROGRAM_FILES
-  The Program Files folder. A typical path is C:\Program Files.
-	
-Dir::PROGRAM_FILES_COMMON
-  A folder for components that are shared across applications. A typical path
-  is C:\Program Files\Common.
-	
-Dir::SYSTEM
-  The Windows System folder. A typical path is C:\Windows\System32.
-	
-Dir::WINDOWS
-  The Windows directory or SYSROOT. This corresponds to the %windir% or
-  %SYSTEMROOT% environment variables. A typical path is C:\Windows.
-	 
-== The following constants may or may not be defined:
-Dir::ALTSTARTUP
-  The file system directory that corresponds to the user's nonlocalized
-  Startup program group.
-	
-Dir::BITBUCKET
-  The virtual folder containing the objects in the user's Recycle Bin.
-	
-Dir::CDBURN_AREA
-  The file system directory acting as a staging area for files waiting to
-  be written to CD.
-
-Dir::COMMON_ALTSTARTUP
-  The file system directory that corresponds to the nonlocalized Startup
-  program group for all users.
-
-Dir::COMMON_DESKTOPDIRECTORY
-  The file system directory that contains files and folders that appear on
-  the desktop for all users. A typical path is
-  C:\Documents and Settings\All Users\Desktop.
-
-Dir::COMMON_FAVORITES
-  The file system directory that serves as a common repository for favorite
-  items common to all users.
-
-Dir::COMMON_MUSIC
-  The file system directory that serves as a repository for music files
-  common to all users.
-
-Dir::COMMON_PICTURES
-  The file system directory that serves as a repository for image files
-  common to all users.
-
-Dir::COMMON_PROGRAMS
-  The file system directory that contains the directories for the common
-  program groups that appear on the Start menu for all users. 
-
-Dir::COMMON_STARTMENU
-  The file system directory that contains the programs and folders that
-  appear on the Start menu for all users.
-
-Dir::COMMON_STARTUP
-  The file system directory that contains the programs that appear in the
-  Startup folder for all users.
-
-Dir::COMMON_TEMPLATES
-  The file system directory that contains the templates that are available
-  to all users.
-
-Dir::COMMON_VIDEO
-  The file system directory that serves as a repository for video files
-  common to all users.
-
-Dir::CONTROLS
-  The virtual folder containing icons for the Control Panel applications.
-
-Dir::DESKTOP
-  The virtual folder representing the Windows desktop, the root of the
-  namespace.
-
-Dir::DESKTOPDIRECTORY
-  The file system directory used to physically store file objects on the
-  desktop (not to be confused with the desktop folder itself).
-
-Dir::DRIVES
-  The virtual folder representing My Computer, containing everything on
-  the local computer: storage devices, printers, and Control Panel. The
-  folder may also contain mapped network drives.
-
-Dir::FAVORITES
-  The file system directory that serves as a common repository for the
-  user's favorite items.
-
-Dir::FONTS
-  A virtual folder containing fonts.
-	
-Dir::INTERNET
-  A virtual folder representing the Internet.
-
-Dir::MYDOCUMENTS
-  The virtual folder representing the My Documents desktop item.  See also
-  Dir::PERSONAL.
-
-Dir::MYMUSIC
-  The file system directory that serves as a common repository for music files.
-
-Dir::MYVIDEO
-  The file system directory that serves as a common repository for video files.
-
-Dir::NETHOOD
-  A file system directory containing the link objects that may exist in the
-  My Network Places virtual folder. It is not the same as Dir::NETWORK, which
-  represents the network namespace root.
-
-Dir::NETWORK
-  A virtual folder representing Network Neighborhood, the root of the network
-  namespace hierarchy.
-
-Dir::PRINTERS
-  The virtual folder containing installed printers.
-
-Dir::PRINTHOOD
-  The file system directory that contains the link objects that can exist in
-  the "Printers" virtual folder.
-
-Dir::PROFILE
-  The user's profile folder.
-
-Dir::PROFILES
-  The file system directory containing user profile folders.
-
-Dir::PROGRAMS
-  The file system directory that contains the user's program groups (which
-  are themselves file system directories).
-
-Dir::RECENT
-  The file system directory that contains shortcuts to the user's most
-  recently used documents.
-
-Dir::SENDTO
-  The file system directory that contains Send To menu items.
-
-Dir::STARTMENU
-  The file system directory containing Start menu items.
-
-Dir::STARTUP
-  The file system directory that corresponds to the user's Startup program
-  group.
-
-Dir::TEMPLATES
-  The file system directory that serves as a common repository for document
-  templates.
-
-== Developer's Notes
-  The SHGetFolderPath() documentation on MSDN is somewhat vague about which
-  CSIDL constants are guaranteed to be defined.  However, there are 15 which
-  *should* be defined (see docs above). The rest I cannot vouch for.
-   
-  Some of these folders are virtual, and the value will be the display name
-  only instead of an actual path.
-	
-== Known Bugs
-  The Dir.create_junction and Dir.read_junction methods do not work with JRuby.
-
-  Please log any bug reports on the project page at
-  http://www.github.com/djberg96/win32-dir
-
-== Future Plans
-  Suggestions welcome.
-
-== Acknowledgements
-  Shashank Date and Zach Dennis for the suggestion and supporting comments
-  on the mailing list.
-	
-  Timothy Byrd and Autrijus Tang for help (directly or indirectly) with the
-  junction methods. Timothy provided a pure Ruby version of the junction
-  code that I later borrowed from.
-	
-  Most of the documentation was copied from the MSDN web site.
-
-== License
-  Artistic 2.0
-
-== 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/
-    
-== Copyright
-  (C) 2003-2014 Daniel J. Berger, All Rights Reserved
-    
-== 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.
-    
-== Authors
-  Daniel J. Berger
-  Park Heesob
+= Description
+  A series of extra constants for the Dir class that define special folders
+  on MS Windows systems, as well as methods for creating and detecting
+  junctions, i.e. symlinks for directories.
+
+= Installation
+  gem install win32-dir
+
+= Synopsis
+  require 'win32/dir'
+	
+  # C:\WINNT or C:\WINDOWS
+  puts Dir::WINDOWS
+
+  # C:\Documents and Settings\Daniel\Start Menu\Programs\Administrative Tools	 
+  puts Dir::ADMINTOOLS
+	
+  Dir.mkdir('C:\from')
+  Dir.create_junction('C:\to', 'C:\from')
+
+= Constants
+  Not all of these are guaranteed to be defined on your system. Also note
+  that the directories are merely defined. It doesn't necessarily mean they
+  actually exist.
+	
+== The following constants should be defined:	
+Dir::ADMINTOOLS
+  The file system directory that is used to store administrative tools for an
+  individual user. The Microsoft Management Console (MMC) will save
+  customized consoles to this directory, and it will roam with the user.
+
+Dir::COMMON_ADMINTOOLS
+  The file system directory containing administrative tools for all users
+  of the computer.
+	
+Dir::APPDATA
+  The file system directory that serves as a common repository for
+  application-specific data. A typical path is
+  C:\Documents and Settings\<user>\Application Data.
+   
+  This CSIDL is supported by the redistributable shfolder.dll for
+  systems that do not have the Microsoft Internet Explorer 4.0
+  integrated Shell installed.
+	
+Dir::COMMON_APPDATA
+  The file system directory containing application data for all users. A
+  typical path is C:\Documents and Settings\All Users\Application Data.
+	
+Dir::COMMON_DOCUMENTS
+  The file system directory that contains documents that are common to all
+  users. A typical paths is C:\Documents and Settings\All Users\Documents.
+	
+Dir::COOKIES
+  The file system directory that serves as a common repository for Internet
+  cookies. A typical path is C:\Documents and Settings\<user>\Cookies.
+
+Dir::HISTORY
+  The file system directory that serves as a common repository for Internet
+  history items.
+
+Dir::INTERNET_CACHE
+  The file system directory that serves as a common repository for temporary
+  Internet files. A typical path is
+  C:\Documents and Settings\<user>\Local Settings\Temporary Internet Files.
+
+Dir::LOCAL_APPDATA
+  The file system directory that serves as a data repository for local
+  (nonroaming) applications. A typical path is
+  C:\Documents and Settings\<user>\Local Settings\Application Data.
+
+Dir::MYPICTURES
+  The file system directory that serves as a common repository for image
+  files. A typical path is
+  C:\Documents and Settings\<user>\My Documents\My Pictures.
+	
+Dir::PERSONAL
+  The virtual folder representing the My Documents desktop item. This is
+  equivalent to Dir::MYDOCUMENTS.
+
+Dir::PROGRAM_FILES
+  The Program Files folder. A typical path is C:\Program Files.
+	
+Dir::PROGRAM_FILES_COMMON
+  A folder for components that are shared across applications. A typical path
+  is C:\Program Files\Common.
+	
+Dir::SYSTEM
+  The Windows System folder. A typical path is C:\Windows\System32.
+	
+Dir::WINDOWS
+  The Windows directory or SYSROOT. This corresponds to the %windir% or
+  %SYSTEMROOT% environment variables. A typical path is C:\Windows.
+	 
+== The following constants may or may not be defined:
+Dir::ALTSTARTUP
+  The file system directory that corresponds to the user's nonlocalized
+  Startup program group.
+	
+Dir::BITBUCKET
+  The virtual folder containing the objects in the user's Recycle Bin.
+	
+Dir::CDBURN_AREA
+  The file system directory acting as a staging area for files waiting to
+  be written to CD.
+
+Dir::COMMON_ALTSTARTUP
+  The file system directory that corresponds to the nonlocalized Startup
+  program group for all users.
+
+Dir::COMMON_DESKTOPDIRECTORY
+  The file system directory that contains files and folders that appear on
+  the desktop for all users. A typical path is
+  C:\Documents and Settings\All Users\Desktop.
+
+Dir::COMMON_FAVORITES
+  The file system directory that serves as a common repository for favorite
+  items common to all users.
+
+Dir::COMMON_MUSIC
+  The file system directory that serves as a repository for music files
+  common to all users.
+
+Dir::COMMON_PICTURES
+  The file system directory that serves as a repository for image files
+  common to all users.
+
+Dir::COMMON_PROGRAMS
+  The file system directory that contains the directories for the common
+  program groups that appear on the Start menu for all users. 
+
+Dir::COMMON_STARTMENU
+  The file system directory that contains the programs and folders that
+  appear on the Start menu for all users.
+
+Dir::COMMON_STARTUP
+  The file system directory that contains the programs that appear in the
+  Startup folder for all users.
+
+Dir::COMMON_TEMPLATES
+  The file system directory that contains the templates that are available
+  to all users.
+
+Dir::COMMON_VIDEO
+  The file system directory that serves as a repository for video files
+  common to all users.
+
+Dir::CONTROLS
+  The virtual folder containing icons for the Control Panel applications.
+
+Dir::DESKTOP
+  The virtual folder representing the Windows desktop, the root of the
+  namespace.
+
+Dir::DESKTOPDIRECTORY
+  The file system directory used to physically store file objects on the
+  desktop (not to be confused with the desktop folder itself).
+
+Dir::DRIVES
+  The virtual folder representing My Computer, containing everything on
+  the local computer: storage devices, printers, and Control Panel. The
+  folder may also contain mapped network drives.
+
+Dir::FAVORITES
+  The file system directory that serves as a common repository for the
+  user's favorite items.
+
+Dir::FONTS
+  A virtual folder containing fonts.
+	
+Dir::INTERNET
+  A virtual folder representing the Internet.
+
+Dir::MYDOCUMENTS
+  The virtual folder representing the My Documents desktop item.  See also
+  Dir::PERSONAL.
+
+Dir::MYMUSIC
+  The file system directory that serves as a common repository for music files.
+
+Dir::MYVIDEO
+  The file system directory that serves as a common repository for video files.
+
+Dir::NETHOOD
+  A file system directory containing the link objects that may exist in the
+  My Network Places virtual folder. It is not the same as Dir::NETWORK, which
+  represents the network namespace root.
+
+Dir::NETWORK
+  A virtual folder representing Network Neighborhood, the root of the network
+  namespace hierarchy.
+
+Dir::PRINTERS
+  The virtual folder containing installed printers.
+
+Dir::PRINTHOOD
+  The file system directory that contains the link objects that can exist in
+  the "Printers" virtual folder.
+
+Dir::PROFILE
+  The user's profile folder.
+
+Dir::PROFILES
+  The file system directory containing user profile folders.
+
+Dir::PROGRAMS
+  The file system directory that contains the user's program groups (which
+  are themselves file system directories).
+
+Dir::RECENT
+  The file system directory that contains shortcuts to the user's most
+  recently used documents.
+
+Dir::SENDTO
+  The file system directory that contains Send To menu items.
+
+Dir::STARTMENU
+  The file system directory containing Start menu items.
+
+Dir::STARTUP
+  The file system directory that corresponds to the user's Startup program
+  group.
+
+Dir::TEMPLATES
+  The file system directory that serves as a common repository for document
+  templates.
+
+== Developer's Notes
+  The SHGetFolderPath() documentation on MSDN is somewhat vague about which
+  CSIDL constants are guaranteed to be defined.  However, there are 15 which
+  *should* be defined (see docs above). The rest I cannot vouch for.
+   
+  Some of these folders are virtual, and the value will be the display name
+  only instead of an actual path.
+	
+== Known Bugs
+  The Dir.create_junction and Dir.read_junction methods do not work with JRuby.
+
+  Please log any bug reports on the project page at
+  http://www.github.com/djberg96/win32-dir
+
+== Future Plans
+  Suggestions welcome.
+
+== Acknowledgements
+  Shashank Date and Zach Dennis for the suggestion and supporting comments
+  on the mailing list.
+	
+  Timothy Byrd and Autrijus Tang for help (directly or indirectly) with the
+  junction methods. Timothy provided a pure Ruby version of the junction
+  code that I later borrowed from.
+	
+  Most of the documentation was copied from the MSDN web site.
+
+== License
+  Artistic 2.0
+
+== 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/
+    
+== Copyright
+  (C) 2003-2015 Daniel J. Berger, All Rights Reserved
+    
+== 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.
+    
+== Authors
+  Daniel J. Berger
+  Park Heesob