diff --git a/pkg/eval/mods/file/file.go b/pkg/eval/mods/file/file.go
index 6fb11027..8698ef85 100644
--- a/pkg/eval/mods/file/file.go
+++ b/pkg/eval/mods/file/file.go
@@ -20,18 +20,19 @@ var fns = map[string]interface{}{
 // file:open $filename
 // ```
 //
-// Opens a file. Currently, `fopen` only supports opening a file for reading.
-// File must be closed with `fclose` explicitly. Example:
+// Opens a file. Currently, `open` only supports opening a file for reading.
+// File must be closed with `close` explicitly. Example:
 //
 // ```elvish-transcript
 // ~> cat a.txt
 // This is
 // a file.
-// ~> f = (fopen a.txt)
+// ~> use file
+// ~> f = (file:open a.txt)
 // ~> cat < $f
 // This is
 // a file.
-// ~> fclose $f
+// ~> close $f
 // ```
 //
 // @cf close