]> granicus.if.org Git - jq/commitdiff
Move docs for map earlier (fix #288)
authorDavid Tolnay <dtolnay@gmail.com>
Sun, 18 Oct 2015 06:54:07 +0000 (23:54 -0700)
committerDavid Tolnay <dtolnay@gmail.com>
Sun, 18 Oct 2015 06:54:07 +0000 (23:54 -0700)
docs/content/3.manual/manual.yml

index f7fd9381308dc08f215bf9056d8af15df7428e55..df309c4a9996352b116a1c36d07f36198863c7ed 100644 (file)
@@ -736,6 +736,28 @@ sections:
             input: '[2, 0]'
             output: ['[false, true]']
 
+      - title: "`map(x)`, `map_values(x)`"
+        body: |
+
+          For any filter `x`, `map(x)` will run that filter for each
+          element of the input array, and produce the outputs a new
+          array. `map(.+1)` will increment each element of an array of numbers.
+
+          Similarly, `map_values(x)` will run that filter for each element,
+          but it will return an object when an object is passed.
+
+          `map(x)` is equivalent to `[.[] | x]`. In fact, this is how
+          it's defined. Similarly, `map_values(x)` is defined as `.[] |= x`.
+
+        examples:
+          - program: 'map(.+1)'
+            input: '[1,2,3]'
+            output: ['[2,3,4]']
+
+          - program: 'map_values(.+1)'
+            input: '{"a": 1, "b": 2, "c": 3}'
+            output: ['{"a": 2, "b": 3, "c": 4}']
+
       - title: "`path(path_expression)`"
         body: |
 
@@ -904,28 +926,6 @@ sections:
             input: 'null'
             output: ['"{\"file\":\"<top-level>\",\"line\":1}"']
 
-      - title: "`map(x)`, `map_values(x)`"
-        body: |
-
-          For any filter `x`, `map(x)` will run that filter for each
-          element of the input array, and produce the outputs a new
-          array. `map(.+1)` will increment each element of an array of numbers.
-
-          Similarly, `map_values(x)` will run that filter for each element,
-          but it will return an object when an object is passed.
-
-          `map(x)` is equivalent to `[.[] | x]`. In fact, this is how
-          it's defined. Similarly, `map_values(x)` is defined as `.[] |= x`.
-
-        examples:
-          - program: 'map(.+1)'
-            input: '[1,2,3]'
-            output: ['[2,3,4]']
-
-          - program: 'map_values(.+1)'
-            input: '{"a": 1, "b": 2, "c": 3}'
-            output: ['{"a": 2, "b": 3, "c": 4}']
-
       - title: "`paths`, `paths(node_filter)`, `leaf_paths`"
         body: |