1 files changed, 13 insertions, 7 deletions
diff --git a/cli/js/dir.ts b/cli/js/dir.ts
index eea2ef691..bc62be83f 100644
--- a/cli/js/dir.ts
+++ b/cli/js/dir.ts
@@ -2,19 +2,25 @@
 import { sendSync } from "./dispatch_json.ts";
 
 /**
- * `cwd()` Return a string representing the current working directory.
- * If the current directory can be reached via multiple paths
- * (due to symbolic links), `cwd()` may return
- * any one of them.
- * throws `NotFound` exception if directory not available
+ * **UNSTABLE**: maybe needs permissions.
+ *
+ * Return a string representing the current working directory.
+ *
+ * If the current directory can be reached via multiple paths (due to symbolic
+ * links), `cwd()` may return any one of them.
+ *
+ * Throws `Deno.errors.NotFound` if directory not available.
  */
 export function cwd(): string {
   return sendSync("op_cwd");
 }
 
 /**
- * `chdir()` Change the current working directory to path.
- * throws `NotFound` exception if directory not available
+ * **UNSTABLE**: maybe needs permissions.
+ *
+ * Change the current working directory to the specified path.
+ *
+ * Throws `Deno.errors.NotFound` if directory not available.
  */
 export function chdir(directory: string): void {
   sendSync("op_chdir", { directory });