yq/pkg/yqlib/doc/headers/Multiply.md

Like the multiple operator in `jq`, depending on the operands, this multiply operator will do different things. Currently only objects are supported, which have the effect of merging the RHS into the LHS.

Upcoming versions of `yq` will add support for other types of multiplication (numbers, strings).

To concatenate when merging objects, use the `*+` form (see examples below). This will recursively merge objects, appending arrays when it encounters them.

Note that when merging objects, this operator returns the merged object (not the parent). This will be clearer in the examples below.

## Merging files
Note the use of eval-all to ensure all documents are loaded into memory.

```bash
yq eval-all 'select(fileIndex == 0) * select(fileIndex == 1)' file1.yaml file2.yaml
```
include docs for tracking 2020-11-17 22:44:16 +00:00			Like the multiple operator in `jq`, depending on the operands, this multiply operator will do different things. Currently only objects are supported, which have the effect of merging the RHS into the LHS.

			Upcoming versions of `yq` will add support for other types of multiplication (numbers, strings).

Added append equals, merge append. Fixed creating numeric arrays 2020-11-28 00:24:16 +00:00			To concatenate when merging objects, use the `*+` form (see examples below). This will recursively merge objects, appending arrays when it encounters them.

Fixing docs 2020-11-22 02:16:54 +00:00			`Note that when merging objects, this operator returns the merged object (not the parent). This will be clearer in the examples below.`

			`## Merging files`
			`Note the use of eval-all to ensure all documents are loaded into memory.`

			```bash
			`yq eval-all 'select(fileIndex == 0) * select(fileIndex == 1)' file1.yaml file2.yaml`
			```