doc: Improve doc of flags --filter and --format

Signed-off-by: Arthur Amstutz <arthur.amstutz@corp.ovh.com>

doc/ovhcloud_account.md

@@ -12,7 +12,14 @@ Manage your account
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_api.md

@@ -12,7 +12,14 @@ Manage your API credentials
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_api_oauth2.md

@@ -12,7 +12,14 @@ Manage your OAuth2 clients
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_api_oauth2_client.md

@@ -12,7 +12,14 @@ Manage your OAuth2 clients
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_api_oauth2_client_create.md

@@ -24,7 +24,14 @@ ovhcloud account api oauth2 client create [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_api_oauth2_client_delete.md

@@ -16,7 +16,14 @@ ovhcloud account api oauth2 client delete <client_id> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_api_oauth2_client_edit.md

@@ -20,7 +20,14 @@ ovhcloud account api oauth2 client edit <client_id> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_api_oauth2_client_get.md

@@ -16,7 +16,14 @@ ovhcloud account api oauth2 client get <client_id> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_api_oauth2_client_list.md

@@ -9,7 +9,13 @@ ovhcloud account api oauth2 client list [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -17,7 +23,14 @@ ovhcloud account api oauth2 client list [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_ssh-key.md

@@ -12,7 +12,14 @@ Manage your SSH keys
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_account_ssh-key_list.md

@@ -9,7 +9,13 @@ ovhcloud account ssh-key list [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -17,7 +23,14 @@ ovhcloud account ssh-key list [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_alldom.md

@@ -12,7 +12,14 @@ Retrieve information and manage your AllDom services
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_alldom_get.md

@@ -16,7 +16,14 @@ ovhcloud alldom get <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_alldom_list.md

@@ -9,7 +9,13 @@ ovhcloud alldom list [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -17,7 +23,14 @@ ovhcloud alldom list [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal.md

@@ -12,7 +12,14 @@ Retrieve information and manage your baremetal services
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_boot.md

@@ -12,7 +12,14 @@ Manage boot options for the given baremetal
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_boot_list.md

@@ -9,7 +9,13 @@ ovhcloud baremetal boot list <service_name> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -17,7 +23,14 @@ ovhcloud baremetal boot list <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_boot_set-script.md

@@ -19,7 +19,14 @@ ovhcloud baremetal boot set-script <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_boot_set.md

@@ -16,7 +16,14 @@ ovhcloud baremetal boot set <service_name> <boot_id> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_edit.md

@@ -26,7 +26,14 @@ ovhcloud baremetal edit <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_get.md

@@ -16,7 +16,14 @@ ovhcloud baremetal get <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_ipmi.md

@@ -12,7 +12,14 @@ Manage IPMI on your baremetal
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_ipmi_get-access.md

@@ -20,7 +20,14 @@ ovhcloud baremetal ipmi get-access <service_name> --type serialOverLanURL --ttl
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_list-compatible-os.md

@@ -9,7 +9,13 @@ ovhcloud baremetal list-compatible-os <service_name> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list-compatible-os
 ```
 
@@ -17,7 +23,14 @@ ovhcloud baremetal list-compatible-os <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_list-interventions.md

@@ -9,7 +9,13 @@ ovhcloud baremetal list-interventions <service_name> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list-interventions
 ```
 
@@ -17,7 +23,14 @@ ovhcloud baremetal list-interventions <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_list-ips.md

@@ -9,7 +9,13 @@ ovhcloud baremetal list-ips <service_name> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list-ips
 ```
 
@@ -17,7 +23,14 @@ ovhcloud baremetal list-ips <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_list-secrets.md

@@ -9,7 +9,13 @@ ovhcloud baremetal list-secrets <service_name> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list-secrets
 ```
 
@@ -17,7 +23,14 @@ ovhcloud baremetal list-secrets <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_list-tasks.md

@@ -9,7 +9,13 @@ ovhcloud baremetal list-tasks <service_name> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list-tasks
 ```
 
@@ -17,7 +23,14 @@ ovhcloud baremetal list-tasks <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_list.md

@@ -9,7 +9,13 @@ ovhcloud baremetal list [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -17,7 +23,14 @@ ovhcloud baremetal list [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_reboot-rescue.md

@@ -17,7 +17,14 @@ ovhcloud baremetal reboot-rescue <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_reboot.md

@@ -16,7 +16,14 @@ ovhcloud baremetal reboot <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_reinstall.md

@@ -79,7 +79,14 @@ ovhcloud baremetal reinstall <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_vni.md

@@ -12,7 +12,14 @@ Manage Virtual Network Interfaces of the given baremetal
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_vni_list.md

@@ -9,7 +9,13 @@ ovhcloud baremetal vni list <service_name> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -17,7 +23,14 @@ ovhcloud baremetal vni list <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_vni_ola-create-aggregation.md

@@ -18,7 +18,14 @@ ovhcloud baremetal vni ola-create-aggregation <service_name> --name <name> --int
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_baremetal_vni_ola-reset.md

@@ -17,7 +17,14 @@ ovhcloud baremetal vni ola-reset <service_name> --interface <uuid> --interface <
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_cdn-dedicated.md

@@ -12,7 +12,14 @@ Retrieve information and manage your dedicated CDN services
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_cdn-dedicated_get.md

@@ -16,7 +16,14 @@ ovhcloud cdn-dedicated get <service_name> [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_cdn-dedicated_list.md

@@ -9,7 +9,13 @@ ovhcloud cdn-dedicated list [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -17,7 +23,14 @@ ovhcloud cdn-dedicated list [flags]
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_cloud.md

@@ -12,7 +12,14 @@ Manage your projects and services in the Public Cloud universe
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_cloud_container-registry.md

@@ -13,7 +13,14 @@ Manage container registries in the given cloud project
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_cloud_container-registry_create.md

@@ -24,7 +24,14 @@ ovhcloud cloud container-registry create [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_container-registry_delete.md

@@ -17,7 +17,14 @@ ovhcloud cloud container-registry delete <registry_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_container-registry_edit.md

@@ -19,7 +19,14 @@ ovhcloud cloud container-registry edit <registry_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_container-registry_get.md

@@ -17,7 +17,14 @@ ovhcloud cloud container-registry get <registry_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_container-registry_list.md

@@ -9,7 +9,13 @@ ovhcloud cloud container-registry list [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -18,7 +24,14 @@ ovhcloud cloud container-registry list [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_database.md

@@ -13,7 +13,14 @@ Manage databases in the given cloud project
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_cloud_database_create.md

@@ -57,7 +57,14 @@ ovhcloud cloud database create [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_database_delete.md

@@ -17,7 +17,14 @@ ovhcloud cloud database delete <database_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_database_get.md

@@ -17,7 +17,14 @@ ovhcloud cloud database get <database_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_database_list.md

@@ -9,7 +9,13 @@ ovhcloud cloud database list [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -18,7 +24,14 @@ ovhcloud cloud database list [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance.md

@@ -13,7 +13,14 @@ Manage instances in the given cloud project
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_cloud_instance_activate-monthly-billing.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance activate-monthly-billing <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_create.md

@@ -100,7 +100,14 @@ ovhcloud cloud instance create <region (e.g. GRA, BHS, SBG)> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_delete.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance delete <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_exit-rescue.md

@@ -18,7 +18,14 @@ ovhcloud cloud instance exit-rescue <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_get.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance get <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_interface.md

@@ -13,7 +13,14 @@ Manage interfaces of the given instance
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_interface_create.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance interface create <instance_id> <network_id> <ip (optiona
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_interface_delete.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance interface delete <instance_id> <interface_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_interface_get.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance interface get <instance_id> <interface_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_interface_list.md

@@ -9,7 +9,13 @@ ovhcloud cloud instance interface list <instance_id> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -18,7 +24,14 @@ ovhcloud cloud instance interface list <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_list.md

@@ -9,7 +9,13 @@ ovhcloud cloud instance list [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -18,7 +24,14 @@ ovhcloud cloud instance list [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_reboot-rescue.md

@@ -19,7 +19,14 @@ ovhcloud cloud instance reboot-rescue <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_reboot.md

@@ -18,7 +18,14 @@ ovhcloud cloud instance reboot <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_reinstall.md

@@ -70,7 +70,14 @@ ovhcloud cloud instance reinstall <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_resume.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance resume <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_set-flavor.md

@@ -19,7 +19,14 @@ ovhcloud cloud instance set-flavor <instance_id> <flavor_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_set-name.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance set-name <instance_id> <new_name> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_shelve.md

@@ -24,7 +24,14 @@ ovhcloud cloud instance shelve <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_snapshot.md

@@ -13,7 +13,14 @@ Manage snapshots of the given instance
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_snapshot_abort.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance snapshot abort <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_snapshot_create.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance snapshot create <instance_id> <snapshot_name> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_start.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance start <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_stop.md

@@ -17,7 +17,14 @@ ovhcloud cloud instance stop <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_instance_unshelve.md

@@ -23,7 +23,14 @@ ovhcloud cloud instance unshelve <instance_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube.md

@@ -13,7 +13,14 @@ Manage Kubernetes clusters in the given cloud project
 
 ```
   -d, --debug           Activate debug mode (will log all HTTP requests details)
-  -f, --format string   Output value according to given format (expression using gval format)
+  -f, --format string   Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                        Examples:
+                          --format 'id' (to extract a single field)
+                          --format 'nested.field.subfield' (to extract a nested field)
+                          --format '[id, 'name']' (to extract multiple fields as an array)
+                          --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                          --format 'name+","+type' (to extract and concatenate fields in a string)
+                          --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors   Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive     Interactive output
   -j, --json            Output in JSON

doc/ovhcloud_cloud_kube_create.md

@@ -82,7 +82,14 @@ ovhcloud cloud kube create [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_customization.md

@@ -13,7 +13,14 @@ Manage Kubernetes cluster customizations
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_customization_edit.md

@@ -28,7 +28,14 @@ ovhcloud cloud kube customization edit <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_customization_get.md

@@ -17,7 +17,14 @@ ovhcloud cloud kube customization get <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_delete.md

@@ -17,7 +17,14 @@ ovhcloud cloud kube delete <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_edit.md

@@ -20,7 +20,14 @@ ovhcloud cloud kube edit <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_get.md

@@ -17,7 +17,14 @@ ovhcloud cloud kube get <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_ip-restrictions.md

@@ -13,7 +13,14 @@ Manage IP restrictions for Kubernetes clusters
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_ip-restrictions_edit.md

@@ -19,7 +19,14 @@ ovhcloud cloud kube ip-restrictions edit <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_ip-restrictions_list.md

@@ -9,7 +9,13 @@ ovhcloud cloud kube ip-restrictions list <cluster_id> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -18,7 +24,14 @@ ovhcloud cloud kube ip-restrictions list <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_kubeconfig.md

@@ -13,7 +13,14 @@ Manage the kubeconfig for the given Kubernetes cluster
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_kubeconfig_generate.md

@@ -17,7 +17,14 @@ ovhcloud cloud kube kubeconfig generate <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_kubeconfig_reset.md

@@ -17,7 +17,14 @@ ovhcloud cloud kube kubeconfig reset <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_list.md

@@ -9,7 +9,13 @@ ovhcloud cloud kube list [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -18,7 +24,14 @@ ovhcloud cloud kube list [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_node.md

@@ -13,7 +13,14 @@ Manage Kubernetes nodes
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_node_delete.md

@@ -17,7 +17,14 @@ ovhcloud cloud kube node delete <cluster_id> <node_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_node_get.md

@@ -17,7 +17,14 @@ ovhcloud cloud kube node get <cluster_id> <node_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_node_list.md

@@ -9,7 +9,13 @@ ovhcloud cloud kube node list <cluster_id> [flags]
 ### Options
 
 ```
-      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax'
+      --filter stringArray   Filter results by any property using https://github.com/PaesslerAG/gval syntax
+                             Examples:
+                               --filter 'state="running"'
+                               --filter 'name=~"^my.*"'
+                               --filter 'nested.property.subproperty>10'
+                               --filter 'startDate>="2023-12-01"'
+                               --filter 'name=~"something" && nbField>10'
   -h, --help                 help for list
 ```
 
@@ -18,7 +24,14 @@ ovhcloud cloud kube node list <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_nodepool.md

@@ -13,7 +13,14 @@ Manage Kubernetes node pools
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_nodepool_create.md

@@ -87,7 +87,14 @@ ovhcloud cloud kube nodepool create <cluster_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_nodepool_delete.md

@@ -17,7 +17,14 @@ ovhcloud cloud kube nodepool delete <cluster_id> <nodepool_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_nodepool_edit.md

@@ -31,7 +31,14 @@ ovhcloud cloud kube nodepool edit <cluster_id> <nodepool_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON

doc/ovhcloud_cloud_kube_nodepool_get.md

@@ -17,7 +17,14 @@ ovhcloud cloud kube nodepool get <cluster_id> <nodepool_id> [flags]
 ```
       --cloud-project string   Cloud project ID
   -d, --debug                  Activate debug mode (will log all HTTP requests details)
-  -f, --format string          Output value according to given format (expression using gval format)
+  -f, --format string          Output value according to given format (expression using https://github.com/PaesslerAG/gval syntax)
+                               Examples:
+                                 --format 'id' (to extract a single field)
+                                 --format 'nested.field.subfield' (to extract a nested field)
+                                 --format '[id, 'name']' (to extract multiple fields as an array)
+                                 --format '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
+                                 --format 'name+","+type' (to extract and concatenate fields in a string)
+                                 --format '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
   -e, --ignore-errors          Ignore errors in API calls when it is not fatal to the execution
   -i, --interactive            Interactive output
   -j, --json                   Output in JSON