docs(tools): add documentation for deno compile cmd (#8615)

docs/toc.json

@@ -69,6 +69,7 @@
       "formatter": "Formatter",
       "repl": "Read-eval-print-loop",
       "bundler": "Bundler",
+      "compiler": "Compiling executables",
       "documentation_generator": "Documentation generator",
       "dependency_inspector": "Dependency inspector",
       "linter": "Linter"

docs/tools.md

@@ -4,6 +4,7 @@ Deno provides some built in tooling that is useful when working with JavaScript
 and TypeScript:
 
 - [bundler (`deno bundle`)](./tools/bundler.md)
+- [compiling executables (`deno compile`)](./tools/compiler.md)
 - [dependency inspector (`deno info`)](./tools/dependency_inspector.md)
 - [documentation generator (`deno doc`)](./tools/documentation_generator.md)
 - [formatter (`deno fmt`)](./tools/formatter.md)

docs/tools/compiler.md

@@ -0,0 +1,18 @@
+## Compiling Executables
+
+> Since the compile functionality is relatively new, the `--unstable` flag has
+> to be set in order for the command to work.
+
+`deno compile [SRC] [OUT]` will compile the script into a self contained
+executable.
+
+```
+> deno compile --unstable https://deno.land/std/http/file_server.ts
+```
+
+If you omit the `OUT` parameter, the name of the executable file will be
+inferred.
+
+### Cross Compilation
+
+Cross compiling binaries for different platforms is not currently possible.