Adjust documentation and code style.

Try to improve readability, remove unhelpful and out of place details (they can be found via git blame if needed).
gopherjs · dmitshur · Sep 6, 2017 · Aug 26, 2017 · Aug 27, 2017 · Sep 6, 2017
commit d7551a07c05c499c06c282dd04bb5b4eb99efe84
diff --git a/tool.go b/tool.go
@@ -750,27 +750,27 @@ func runNode(script string, args []string, dir string, quiet bool) error {
 	}

 	if runtime.GOOS != "windows" {
-		// For non-Windows environments, we've seen issues with stack space
-		// limits causing Go standard library tests that are recursion-heavy to
-		// fail (see https://github.com/gopherjs/gopherjs/issues/661 for more details).
+		// We've seen issues with stack space limits causing
+		// recursion-heavy standard library tests to fail (e.g., see
+		// https://github.com/gopherjs/gopherjs/pull/669#issuecomment-319319483).
 		//
-		// There are two limits that come into play here:
+		// There are two separate limits in non-Windows environments:
 		//
-		// 1. V8 limit (NodeJS effectively wraps V8)
-		// 2. OS process limit
+		// -	OS process limit
+		// -	Node.js (V8) limit
+		//
+		// GopherJS fetches the current OS process limit, and sets the
+		// Node.js limit to the same value. So both limits are kept in sync
+		// and can be controlled by setting OS process limit. E.g.:
+		//
+		// 	ulimit -s 10000 && gopherjs test
 		//
-		// In order to limit the surface area of the gopherjs command and not
-		// expose V8 flags/options etc. to the caller, we control limit 1 via
-		// limit 2. Whatever value is returned by ulimit -s is the value that we
-		// pass on to NodeJS via the appropriate V8 flag.
 		var r syscall.Rlimit
 		err := syscall.Getrlimit(syscall.RLIMIT_STACK, &r)
 		if err != nil {
 			return fmt.Errorf("failed to get stack size limit: %v", err)
 		}
-		// rlimit value is in bytes, we need rounded kilobytes value per node --v8-options.
-		stackSize := fmt.Sprintf("--stack_size=%v", r.Cur/1000)
-		allArgs = append(allArgs, stackSize)
+		allArgs = append(allArgs, fmt.Sprintf("--stack_size=%v", r.Cur/1000)) // Convert from bytes to KB.
 	}

 	allArgs = append(allArgs, script)