Bug #3249: File#directory? does not document directory symlink special case http://redmine.ruby-lang.org/issues/show/3249 Author: Ilkka Laukkanen Status: Open, Priority: Normal ruby -v: ruby 1.9.2dev (2010-04-23 trunk 27456) [x86_64-linux] If there exists in the filesystem a directory "bar", and a symlink "foo" that points at "bar", then File.directory? 'foo' and File.symlink? 'foo' == true This special case is not documented in File#directory?, where to docs merely say that it "Returns true if the named file is a directory, false otherwise". This is not correct since it will also return true if the file is a symlink, but points at a directory. The attached patch amends the documentation of File#directory? so that the special case is explicitly explained. ---------------------------------------- http://redmine.ruby-lang.org