Added a note to remove File#realpath workaround

In Ruby 1.9+ File#realpath exists which gives the proper name of a file
or directory.  For 1.8.7 support we need to use Dir.chdir and
File.expand_path '.' to get this information so a note has been added to
remove this once 1.8.7 support is dropped.