= Description
  A custom File.expand_path method for Ruby on Windows that's much
  faster and works better.

= Installation
  gem install win32-xpath

= Synopsis
  require 'win32/xpath'

  # That's it, you are now using this library when you call File.expand_path

= Features
  * A 5x average performance boost over MRI's current method.
  * Support for ~user expansion.

= Known Issues
  * This library does not support drive-current paths for the 2nd argument.
  * This library does not support alt-stream name autocorrection.

  It is very unlikely you will ever be affected by either of these things.
  Drive-current paths are a relic of DOS 1.0, but even so this library
  will handle them in the first argument.

  I don't support alt-stream mangling because I don't believe it's the
  job of this method to peform autocorrection. Even in MRI it only works
  for the default $DATA stream, and then only for a certain type of
  syntax error. I do not know when or why it was added.

  If you discover any other issues, please report them on the project
  page at https://github.com/djberg96/win32-xpath.

= Acknowledgements
  Park Heesob for encoding advice and help.

== 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.

= Author
  Daniel Berger