1 files changed, 5 insertions, 3 deletions
diff --git a/cli/js/link.ts b/cli/js/link.ts
index 4d66d1cf9..cd738b1bc 100644
--- a/cli/js/link.ts
+++ b/cli/js/link.ts
@@ -1,10 +1,11 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
 import { sendSync, sendAsync } from "./dispatch_json.ts";
 
-/** Synchronously creates `newname` as a hard link to `oldname`.
+/** Creates `newname` as a hard link to `oldname`.
  *
  *       Deno.linkSync("old/name", "new/name");
- */
+ *
+ * Requires `allow-read` and `allow-write` permissions. */
 export function linkSync(oldname: string, newname: string): void {
   sendSync("op_link", { oldname, newname });
 }
@@ -12,7 +13,8 @@ export function linkSync(oldname: string, newname: string): void {
 /** Creates `newname` as a hard link to `oldname`.
  *
  *       await Deno.link("old/name", "new/name");
- */
+ *
+ * Requires `allow-read` and `allow-write` permissions. */
 export async function link(oldname: string, newname: string): Promise<void> {
   await sendAsync("op_link", { oldname, newname });
 }