CHANGES - pathname2-1.6.2 Documentation

1.6.2 - 4-Aug-2009

Now compatible with Ruby 1.9.x.
License changed to Artistic 2.0.
Added the Pathname.pwd method as a synonym for Pathname.new.
Modified Pathname#dirname so that you can specify a level that indicates how many levels up you want to retrieve. For example, if your path was '/usr/local/bin', then path.dirname(2) would return '/usr'.
Now compatible with Ruby 1.9.x.
Bumped required version of the facade library to 1.0.4.

Added the Pathname#[] method, which accepts an index, an index plus a length, or a range, and returns appropriate the path element(s).
Refactoring the platform checking in the test suite to use rbconfig instead of RUBY_PLATFORM.
More inline documentation examples.

The facade for ftools (and ftools itself) has been removed. The ftools library is deprecated in favor of FileUtils.
PathnameError is now Pathname::Error.
Bug fix for Pathname#relative_path_from for MS Windows. Thanks go to an anonymous user for the spot.
Fixed a bug where frozen strings would raise an error on MS Windows.
The code is now -w clean.
Removed the C version as part of the release because it was just too difficult to maintain both versions. The C code remains in CVS, however.
Changed platform checking to use rbconfig instead of RUBY_PLATFORM to avoid potential issues with other Ruby implementation.

Bug fix for the Pathname#realpath method where it was not handling recursive symlinks. The C version was also fixed, but it only affected platforms that don't have the realpath() function.
Added a test for recursive symlinks (for Solaris, anyway).
Updated the docs for Pathname#realpath.
Minor speed enhancements for the C version and the elimination of one (potential) segfault.
Added a 'Future Plans' section to the README.
Added a Rakefile. You can now build, clean, and test and install (both the pure Ruby and C versions).

Added the Kernel#pn method as a shortcut for Pathname.new.
The Pathname#readlink now properly handles symbolic links. The 'fix' from 1.4.4 did not work.
The C extension uses your system's realpath() function for the Pathname#readlink method if it has one.
Added the '/' alias for '+'. So, p1 / p2 is the same as p1 + p2.
The windows-pr package is now required on MS Windows.

Better subclass handling, in that some methods that previously returned hardcoded Pathname.new now return self.class.new.
File URL's are now handled on Unix as well (using the 'uri' package).
Some comment changes/clarifications.
Added the PathnameError class to the pure Ruby version.

If the path is a symbolic link the Pathname#realpath method now returns the absolute path of that link, i.e. the result of File.readlink (as a Pathname object).

Fixed the Pathname#relative_path_from method for Windows. This really only affected edge cases that you probably never saw anyway.
Added corresponding tests for Windows.

Added destructive and non-destructive methods for some methods - pstrip, pstrip!, undecorate, undecorate!, clean and clean!.
Added a C extension version of this package. You can use the C version instead of the pure Ruby version instead. See the README for more details.
Fixed bug in the root method where the result wasn't guaranteed to be a Pathname class.
Fixed bugs in Windows version where the receiver was inadvertantly modified in some cases, and added tests to check for this in the future.
Modified the Dir.glob facade so that it (temporarily) changes to the path directory, globs on that path, then returns to the original directory.
Added the bench_pathname.rb script to let you benchmark all Pathname methods.