docs: describe example commands

README.md

@@ -9,21 +9,26 @@ Simple run function to execute shell commands in Deno.
 
 import { run } from "https://deno.land/x/run_simple/mod.ts";
 
+// Simple command
 const dir: string = await run("ls -l");
 console.log(dir);
 
+// Command with variable argument
 const uid = 1000;
 const idLine: string = await run(["id", uid]);
 console.log(idLine);
 
+// An argument contains spaces
 const remoteHost = "10.20.30.40";
 const remoteCommand = "ps -ef --forest";
 const remoteProcessTree: string = await run(["ssh", remoteHost, remoteCommand]);
 
+// Supply STDIN to the command
 const contents = `# Remote file
 
 This will be the contents of the remote file.
 `;
+// In this case, ignore response string
 await run(
   ["ssh", remoteHost, "bash", "-c", "cat > remote_file.md"],
   { stdin: contents },

example.ts

@@ -1,20 +1,25 @@
 import { run } from "./mod.ts";
 
+// Simple command
 const dir: string = await run("ls -l");
 console.log(dir);
 
+// Command with variable argument
 const uid = 1000;
 const idLine: string = await run(["id", uid]);
 console.log(idLine);
 
+// An argument contains spaces
 const remoteHost = "10.20.30.40";
 const remoteCommand = "ps -ef --forest";
 const remoteProcessTree: string = await run(["ssh", remoteHost, remoteCommand]);
 
+// Supply STDIN to the command
 const contents = `# Remote file
 
 This will be the contents of the remote file.
 `;
+// In this case, ignore response string
 await run(
   ["ssh", remoteHost, "bash", "-c", "cat > remote_file.md"],
   { stdin: contents },