Cleanup comments and internal variables (#4205)

cli/js/read_link.ts

@@ -1,18 +1,20 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
 import { sendSync, sendAsync } from "./dispatch_json.ts";
 
-/** Returns the destination of the named symbolic link synchronously.
+/** Returns the destination of the named symbolic link.
  *
  *       const targetPath = Deno.readlinkSync("symlink/path");
- */
+ *
+ * Requires `allow-read` permission. */
 export function readlinkSync(name: string): string {
   return sendSync("op_read_link", { name });
 }
 
-/** Returns the destination of the named symbolic link.
+/** Resolves to the destination of the named symbolic link.
  *
  *       const targetPath = await Deno.readlink("symlink/path");
- */
+ *
+ * Requires `allow-read` permission. */
 export async function readlink(name: string): Promise<string> {
   return await sendAsync("op_read_link", { name });
 }