Use a record instead of a list to clarify arguments in Programming in Nu#Operators examples.

book/operators.md

@@ -247,7 +247,9 @@ external command.
 Here is an example custom command that has a rest parameter:
 
 ```nu
-def foo [ --flag req opt? ...args ] { [$flag, $req, $opt, $args] | to nuon }
+def foo [ --flag req opt? ...args ] {
+  { flag: $flag, req: $req, opt: $opt, args: $args } | to nuon
+}
 ```
 
 It has one flag (`--flag`), one required positional parameter (`req`), one optional positional parameter
@@ -259,9 +261,9 @@ recognized before variables, subexpressions, and list literals, and no whitespac
 
 ```nu
 foo "bar" "baz" ...[1 2 3] # With ..., the numbers are treated as separate arguments
-# => [false, bar, baz, [1, 2, 3]]
+# => { flag: false, req: bar, opt: baz, args: [1, 2, 3] }
 foo "bar" "baz" [1 2 3] # Without ..., [1 2 3] is treated as a single argument
-# => [false, bar, baz, [[1, 2, 3]]]
+# => { flag: false, req: bar, opt: baz, args: [[1, 2, 3]] }
 ```
 
 A more useful way to use the spread operator is if you have another command with a rest parameter
@@ -270,27 +272,27 @@ and you want it to forward its arguments to `foo`:
 ```nu
 def bar [ ...args ] { foo --flag "bar" "baz" ...$args }
 bar 1 2 3
-# => [true, bar, baz, [1, 2, 3]]
+# => { flag: true, req: bar, opt: baz, args: [1, 2, 3] }
 ```
 
 You can spread multiple lists in a single call, and also intersperse individual arguments:
 
 ```nu
 foo "bar" "baz" 1 ...[2 3] 4 5 ...(6..9 | take 2) last
-# => [false, bar, baz, [1, 2, 3, 4, 5, 6, 7, last]]
+# => { flag: false, req: bar, opt: baz, args: [1, 2, 3, 4, 5, 6, 7, last] }
 ```
 
 Flags/named arguments can go after a spread argument, just like they can go after regular rest arguments:
 
 ```nu
 foo "bar" "baz" 1 ...[2 3] --flag 4
-# => [true, bar, baz, [1, 2, 3, 4]]
+# => { flag: true, req: bar, opt: baz, args: [1, 2, 3, 4] }
 ```
 
 If a spread argument comes before an optional positional parameter, that optional parameter is treated
 as being omitted:
 
 ```nu
 foo "bar" ...[1 2] "not opt" # The null means no argument was given for opt
-# => [false, bar, null, [1, 2, "not opt"]]
+# => { flag: false, req: bar, opt: null, args: [1, 2, "not opt"] }
 ```