Documented shebang execution of Nimscripts

1 files changed, 9 insertions, 0 deletions

diff --git a/doc/nims.rst b/doc/nims.rst
index 967dd4149..d4ef0055f 100644
--- a/doc/nims.rst
+++ b/doc/nims.rst
@@ -108,3 +108,12 @@ installation of Nimble is done with this simple script:
 
   mvFile "nimble" & $id & "/src/nimble".toExe, "bin/nimble".toExe
 
+You can also use the shebang ``#!/usr/bin/env nim``, as long as your filename
+ends with ``.nims``:
+
+.. code-block:: nim
+
+  #!/usr/bin/env nim
+  mode = ScriptMode.Silent
+
+  echo "hello world"