fix strip trailing whitespace for make_docs script (#4597)

docs/commands/each.md

@@ -8,11 +8,12 @@ Run a block on each element of input
 
 ## Signature
 
-```> each (block) --numbered```
+```> each (block) --keep-empty --numbered```
 
 ## Parameters
 
  -  `block`: the block to run
+ -  `--keep-empty`: keep empty result cells
  -  `--numbered`: iterate with an index
 
 ## Examples
@@ -21,3 +22,13 @@ Multiplies elements in list
 ```shell
 > [1 2 3] | each { |it| 2 * $it }
 ```
+
+Iterate over each element, keeping only values that succeed
+```shell
+> [1 2 3] | each { |it| if $it == 2 { echo "found 2!"} }
+```
+
+Iterate over each element, keeping all results
+```shell
+> [1 2 3] | each --keep-empty { |it| if $it == 2 { echo "found 2!"} }
+```

docs/commands/run-external.md

@@ -8,9 +8,10 @@ Runs external command
 
 ## Signature
 
-```> run-external ...rest --last-expression```
+```> run-external ...rest --redirect-stdout --redirect-stderr```
 
 ## Parameters
 
  -  `...rest`: external command to run
- -  `--last-expression`: last-expression
+ -  `--redirect-stdout`: redirect-stdout
+ -  `--redirect-stderr`: redirect-stderr

docs/make_docs.nu

@@ -57,9 +57,12 @@ $"($example.description)
         $example_top + $examples
     } else { "" }
 
-    let doc = (($top + $signature + $parameters + $examples) |
+    let doc = (
-        each {|it| ($it | str trim -r)} |
+            ($top + $signature + $parameters + $examples) |
-        str collect (char nl)) + (char nl)
+            lines |
+            each {|it| ($it | str trim -r) } |
+            str collect (char nl)
+        )
 
     let safe_name = ($command.command | str find-replace '\?' '' | str find-replace ' ' '_')
     $doc | save --raw $"./docs/commands/($safe_name).md"