From 60f2d57fb7a01a438e99c5d2ea655cfa44641755 Mon Sep 17 00:00:00 2001
From: David Sherret <dsherret@users.noreply.github.com>
Date: Mon, 4 May 2020 15:17:15 -0400
Subject: feat(fmt): Add `deno-fmt-ignore` and `deno-fmt-ignore-file` comment
 support (#5075)

---
 std/manual.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

(limited to 'std')

diff --git a/std/manual.md b/std/manual.md
index 29abe2c66..8df8adfd3 100644
--- a/std/manual.md
+++ b/std/manual.md
@@ -1298,6 +1298,40 @@ All listeners added using `window.addEventListener` were run, but
 `window.onload` and `window.onunload` defined in `main.ts` overridden handlers
 defined in `imported.ts`.
 
+## `deno fmt`
+
+Deno ships with a built in code formatter that auto-formats TypeScript and
+JavaScript code.
+
+```shell
+# format all JS/TS files in the current directory and subdirectories
+deno fmt
+# format specific files
+deno fmt myfile1.ts myfile2.ts
+# check if all the JS/TS files in the current directory and subdirectories are formatted
+deno fmt --check
+# format stdin and write to stdout
+cat file.ts | deno fmt -
+```
+
+Ignore formatting code by preceding it with a `// deno-fmt-ignore` comment:
+
+<!-- prettier-ignore-start -->
+
+```ts
+// deno-fmt-ignore
+export const identity = [
+    1, 0, 0,
+    0, 1, 0,
+    0, 0, 1,
+];
+```
+
+<!-- prettier-ignore-end -->
+
+Or ignore an entire file by adding a `// deno-fmt-ignore-file` comment at the
+top of the file.
+
 ## Internal details
 
 ### Deno and Linux analogy
-- 
cgit v1.2.3