feat(fmt): Add `deno-fmt-ignore` and `deno-fmt-ignore-file` comment support (#5075)

1 files changed, 34 insertions, 0 deletions

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