From 6cd46fa3ef4b12f35a60f1a33c7f038c06b5fc71 Mon Sep 17 00:00:00 2001 From: dubiousjim Date: Mon, 2 Mar 2020 10:19:42 -0500 Subject: Cleanup comments and internal variables (#4205) --- cli/js/symlink.ts | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) (limited to 'cli/js/symlink.ts') diff --git a/cli/js/symlink.ts b/cli/js/symlink.ts index de4d8a729..e484ce4a3 100644 --- a/cli/js/symlink.ts +++ b/cli/js/symlink.ts @@ -3,12 +3,15 @@ import { sendSync, sendAsync } from "./dispatch_json.ts"; import * as util from "./util.ts"; import { build } from "./build.ts"; -/** Synchronously creates `newname` as a symbolic link to `oldname`. The type - * argument can be set to `dir` or `file` and is only available on Windows - * (ignored on other platforms). +/** **UNSTABLE**: `type` argument type may be changed to `"dir" | "file"`. + * + * Creates `newname` as a symbolic link to `oldname`. The type argument can be + * set to `dir` or `file`. Is only available on Windows and ignored on other + * platforms. * * Deno.symlinkSync("old/name", "new/name"); - */ + * + * Requires `allow-read` and `allow-write` permissions. */ export function symlinkSync( oldname: string, newname: string, @@ -20,12 +23,15 @@ export function symlinkSync( sendSync("op_symlink", { oldname, newname }); } -/** Creates `newname` as a symbolic link to `oldname`. The type argument can be - * set to `dir` or `file` and is only available on Windows (ignored on other - * platforms). +/** **UNSTABLE**: `type` argument may be changed to "dir" | "file" + * + * Creates `newname` as a symbolic link to `oldname`. The type argument can be + * set to `dir` or `file`. Is only available on Windows and ignored on other + * platforms. * * await Deno.symlink("old/name", "new/name"); - */ + * + * Requires `allow-read` and `allow-write` permissions. */ export async function symlink( oldname: string, newname: string, -- cgit v1.2.3