1 files changed, 11 insertions, 1 deletions
diff --git a/file.c b/file.c
index 28b8834bc2..d97948db3c 100644
--- a/file.c
+++ b/file.c
@@ -1398,6 +1398,16 @@ test_sticky(obj, fname)
  *   File.identical?(file_1, file_2)   =>  true or false
  *
  * Returns <code>true</code> if the named files are identical.
+ *
+ *     open("a", "w") {}
+ *     p File.identical?("a", "a")      #=> true
+ *     p File.identical?("a", "./a")    #=> true
+ *     File.link("a", "b")
+ *     p File.identical?("a", "b")      #=> true
+ *     File.symlink("a", "c")
+ *     p File.identical?("a", "c")      #=> true
+ *     open("d", "w") {}
+ *     p File.identical?("a", "d")      #=> false
  */
 
 static VALUE
@@ -3265,7 +3275,7 @@ test_check(n, argc, argv)
  *
  * Tests that take two files:
  *
- *     ?-  | boolean | True if file1 is a hard link to file2
+ *     ?-  | boolean | True if file1 and file2 are identical
  *     ?=  | boolean | True if the modification times of file1
  *         |         | and file2 are equal
  *     ?<  | boolean | True if the modification time of file1