From 18432412897ba651d061f232bc6297cfb40bc280 Mon Sep 17 00:00:00 2001 From: Ben Gribaudo Date: Fri, 16 Jan 2026 14:45:06 -0500 Subject: [PATCH 1/3] Changing exception -> error --- query-languages/m/custom-date-and-time-format-strings.md | 2 +- query-languages/m/datetimezone-switchzone.md | 2 +- query-languages/m/list-functions.md | 2 +- query-languages/m/list-lastn.md | 2 +- query-languages/m/list-mode.md | 2 +- query-languages/m/list-modes.md | 2 +- query-languages/m/list-single.md | 2 +- query-languages/m/list-standarddeviation.md | 2 +- query-languages/m/logical-fromtext.md | 2 +- query-languages/m/logical-totext.md | 2 +- query-languages/m/record-field.md | 2 +- query-languages/m/record-fromtable.md | 2 +- query-languages/m/record-removefields.md | 2 +- query-languages/m/table-renamecolumns.md | 2 +- query-languages/m/table-reordercolumns.md | 2 +- query-languages/m/table-transformcolumns.md | 2 +- 16 files changed, 16 insertions(+), 16 deletions(-) diff --git a/query-languages/m/custom-date-and-time-format-strings.md b/query-languages/m/custom-date-and-time-format-strings.md index d306154ac..4fba4651a 100644 --- a/query-languages/m/custom-date-and-time-format-strings.md +++ b/query-languages/m/custom-date-and-time-format-strings.md @@ -1229,7 +1229,7 @@ There are two ways to indicate that characters are to be interpreted as literal ### Using single custom format specifiers -A custom date and time format string consists of two or more characters. Date and time formatting methods interpret any single-character string as a standard date and time format string. If they don't recognize the character as a valid format specifier, they throw an expression error. For example, a format string that consists only of the specifier "h" is interpreted as a standard date and time format string. However, in this particular case, an exception is thrown because there is no "h" standard date and time format specifier. +A custom date and time format string consists of two or more characters. Date and time formatting methods interpret any single-character string as a standard date and time format string. If they don't recognize the character as a valid format specifier, they throw an expression error. For example, a format string that consists only of the specifier "h" is interpreted as a standard date and time format string. However, in this particular case, an error is raised because there is no "h" standard date and time format specifier. To use any of the custom date and time format specifiers as the only specifier in a format string (that is, to use the "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", or "/" custom format specifier by itself), include a space before or after the specifier, or include a percent ("%") format specifier before the single custom date and time specifier. diff --git a/query-languages/m/datetimezone-switchzone.md b/query-languages/m/datetimezone-switchzone.md index a0d56a7d8..4788ed1f9 100644 --- a/query-languages/m/datetimezone-switchzone.md +++ b/query-languages/m/datetimezone-switchzone.md @@ -13,7 +13,7 @@ DateTimeZone.SwitchZone(dateTimeZone as nullable datetimezone, timezon ## About -Changes timezone information to on the datetimezone value `dateTimeZone` to the new timezone information provided by `timezoneHours` and optionally `timezoneMinutes`. If `dateTimeZone` does not have a timezone component, an exception is thrown. +Changes timezone information to on the datetimezone value `dateTimeZone` to the new timezone information provided by `timezoneHours` and optionally `timezoneMinutes`. If `dateTimeZone` does not have a timezone component, an error is raised. ## Example 1 diff --git a/query-languages/m/list-functions.md b/query-languages/m/list-functions.md index 03b249b7f..ec0beee40 100644 --- a/query-languages/m/list-functions.md +++ b/query-languages/m/list-functions.md @@ -35,7 +35,7 @@ These functions create and manipulate list values. |[List.Positions](list-positions.md)|Returns a list of offsets for the input.| |[List.Range](list-range.md)|Returns a subset of the list beginning at an offset.| |[List.Select](list-select.md)|Returns a list of values that match the condition.| -|[List.Single](list-single.md)|Returns the one list item for a list of length one, otherwise throws an exception.| +|[List.Single](list-single.md)|Returns the one list item for a list of length one, otherwise raises an error.| |[List.SingleOrDefault](list-singleordefault.md)|Returns the one list item for a list of length one and the default value for an empty list.| |[List.Skip](list-skip.md)|Returns a list that skips the specified number of elements at the beginning of the list.| diff --git a/query-languages/m/list-lastn.md b/query-languages/m/list-lastn.md index 46cd1e33c..c1771d6d9 100644 --- a/query-languages/m/list-lastn.md +++ b/query-languages/m/list-lastn.md @@ -13,7 +13,7 @@ List.LastN(list as list, optional countOrCondition as any) as any ## About -Returns the last item of the list `list`. If the list is empty, an exception is thrown. This function takes an optional parameter, `countOrCondition`, to support gathering multiple items or filtering items. `countOrCondition` can be specified in three ways: +Returns the last item of the list `list`. If the list is empty, an error is raised. This function takes an optional parameter, `countOrCondition`, to support gathering multiple items or filtering items. `countOrCondition` can be specified in three ways: * If a number is specified, up to that many items are returned. * If a condition is specified, all items are returned that initially meet the condition, starting at the end of the list. Once an item fails the condition, no further items are considered. diff --git a/query-languages/m/list-mode.md b/query-languages/m/list-mode.md index fff490b8a..5d9d43cea 100644 --- a/query-languages/m/list-mode.md +++ b/query-languages/m/list-mode.md @@ -13,7 +13,7 @@ List.Mode(list as list, optional equationCriteria as any) as any ## About -Returns the item that appears most frequently in `list`. If the list is empty an exception is thrown. If multiple items appear with the same maximum frequency, the last one is chosen. An optional comparison criteria value, `equationCriteria`, can be specified to control equality testing. +Returns the item that appears most frequently in `list`. If the list is empty an error is raised. If multiple items appear with the same maximum frequency, the last one is chosen. An optional comparison criteria value, `equationCriteria`, can be specified to control equality testing. ## Example 1 diff --git a/query-languages/m/list-modes.md b/query-languages/m/list-modes.md index f44b6aa44..e6aace2f7 100644 --- a/query-languages/m/list-modes.md +++ b/query-languages/m/list-modes.md @@ -13,7 +13,7 @@ List.Modes(list as list, optional equationCriteria as any) as list ## About -Returns the items that appear most frequently in `list`. If the list is empty an exception is thrown. If multiple items appear with the same maximum frequency, all of them are returned. An optional comparison criteria value, `equationCriteria`, can be specified to control equality testing. +Returns the items that appear most frequently in `list`. If the list is empty an error is raised. If multiple items appear with the same maximum frequency, all of them are returned. An optional comparison criteria value, `equationCriteria`, can be specified to control equality testing. ## Example 1 diff --git a/query-languages/m/list-single.md b/query-languages/m/list-single.md index 1ca4f4ea1..ff922ad9a 100644 --- a/query-languages/m/list-single.md +++ b/query-languages/m/list-single.md @@ -13,7 +13,7 @@ List.Single(list as list) as any ## About -If there is only one item in the list `list`, returns that item. If there is more than one item or the list is empty, the function throws an exception. +If there is only one item in the list `list`, returns that item. If there is more than one item or the list is empty, the function raises an error. ## Example 1 diff --git a/query-languages/m/list-standarddeviation.md b/query-languages/m/list-standarddeviation.md index 26be73cf9..36d7ed4eb 100644 --- a/query-languages/m/list-standarddeviation.md +++ b/query-languages/m/list-standarddeviation.md @@ -13,7 +13,7 @@ List.StandardDeviation(numbersList as list) as nullable number ## About -Returns a sample based estimate of the standard deviation of the values in the list, `numbersList`. If `numbersList` is a list of numbers, a number is returned. An exception is thrown on an empty list or a list of items that is not type `number`. +Returns a sample based estimate of the standard deviation of the values in the list, `numbersList`. If `numbersList` is a list of numbers, a number is returned. An error is raised on an empty list or a list of items that is not type `number`. ## Example 1 diff --git a/query-languages/m/logical-fromtext.md b/query-languages/m/logical-fromtext.md index c484bc4e2..d402a4c27 100644 --- a/query-languages/m/logical-fromtext.md +++ b/query-languages/m/logical-fromtext.md @@ -13,7 +13,7 @@ Logical.FromText(text as nullable text) as nullable logical ## About -Creates a logical value from the text value `text`, either "true" or "false". If `text` contains a different string, an exception is thrown. The text value `text` is case insensitive. +Creates a logical value from the text value `text`, either "true" or "false". If `text` contains a different string, an error is raised. The text value `text` is case insensitive. ## Example 1 diff --git a/query-languages/m/logical-totext.md b/query-languages/m/logical-totext.md index a01a90ba4..e137ff6a2 100644 --- a/query-languages/m/logical-totext.md +++ b/query-languages/m/logical-totext.md @@ -13,7 +13,7 @@ Logical.ToText(logicalValue as nullable logical) as nullable text ## About -Creates a text value from the logical value `logicalValue`, either `true` or `false`. If `logicalValue` is not a logical value, an exception is thrown. +Creates a text value from the logical value `logicalValue`, either `true` or `false`. If `logicalValue` is not a logical value, an error is raised. ## Example 1 diff --git a/query-languages/m/record-field.md b/query-languages/m/record-field.md index 6a7996cf3..33c64208e 100644 --- a/query-languages/m/record-field.md +++ b/query-languages/m/record-field.md @@ -13,7 +13,7 @@ Record.Field(record as record, field as text) as any ## About -Returns the value of the specified `field` in the `record`. If the field is not found, an exception is thrown. +Returns the value of the specified `field` in the `record`. If the field is not found, an error is raised. ## Example 1 diff --git a/query-languages/m/record-fromtable.md b/query-languages/m/record-fromtable.md index f16422cd8..846da1aa1 100644 --- a/query-languages/m/record-fromtable.md +++ b/query-languages/m/record-fromtable.md @@ -13,7 +13,7 @@ Record.FromTable(table as table) as record ## About -Returns a record from a table of records `table` containing field names and value names `{[Name = name, Value = value]}`. An exception is thrown if the field names are not unique. +Returns a record from a table of records `table` containing field names and value names `{[Name = name, Value = value]}`. An error is raised if the field names are not unique. ## Example 1 diff --git a/query-languages/m/record-removefields.md b/query-languages/m/record-removefields.md index 11c552303..3cc57c9fa 100644 --- a/query-languages/m/record-removefields.md +++ b/query-languages/m/record-removefields.md @@ -13,7 +13,7 @@ Record.RemoveFields(record as record, fields as any, optional m ## About -Returns a record that removes all the fields specified in list `fields` from the input `record`. If the field specified does not exist, an exception is thrown. +Returns a record that removes all the fields specified in list `fields` from the input `record`. If the field specified does not exist, an error is raised. ## Example 1 diff --git a/query-languages/m/table-renamecolumns.md b/query-languages/m/table-renamecolumns.md index 11718ee06..8415b685e 100644 --- a/query-languages/m/table-renamecolumns.md +++ b/query-languages/m/table-renamecolumns.md @@ -13,7 +13,7 @@ Table.RenameColumns(table as table, renames as list, optional m ## About -Performs the given renames to the columns in table `table`. A replacement operation `renames` consists of a list of two values, the old column name and new column name, provided in a list. If the column doesn't exist, an exception is thrown unless the optional parameter `missingField` specifies an alternative (eg. [MissingField.UseNull](missingfield-type.md) or [MissingField.Ignore](missingfield-type.md)). +Performs the given renames to the columns in table `table`. A replacement operation `renames` consists of a list of two values, the old column name and new column name, provided in a list. If the column doesn't exist, an error is raised unless the optional parameter `missingField` specifies an alternative (eg. [MissingField.UseNull](missingfield-type.md) or [MissingField.Ignore](missingfield-type.md)). ## Example 1 diff --git a/query-languages/m/table-reordercolumns.md b/query-languages/m/table-reordercolumns.md index 05cdc70d6..66d8ba949 100644 --- a/query-languages/m/table-reordercolumns.md +++ b/query-languages/m/table-reordercolumns.md @@ -13,7 +13,7 @@ Table.ReorderColumns(table as table, columnOrder as list, optional ## About -Returns a table from the input `table`, with the columns in the order specified by `columnOrder`. Columns that are not specified in the list will not be reordered. If the column doesn't exist, an exception is thrown unless the optional parameter `missingField` specifies an alternative (eg. [MissingField.UseNull](missingfield-type.md) or [MissingField.Ignore](missingfield-type.md)). +Returns a table from the input `table`, with the columns in the order specified by `columnOrder`. Columns that are not specified in the list will not be reordered. If the column doesn't exist, an error is raised unless the optional parameter `missingField` specifies an alternative (eg. [MissingField.UseNull](missingfield-type.md) or [MissingField.Ignore](missingfield-type.md)). ## Example 1 diff --git a/query-languages/m/table-transformcolumns.md b/query-languages/m/table-transformcolumns.md index fe677f976..d5bf87523 100644 --- a/query-languages/m/table-transformcolumns.md +++ b/query-languages/m/table-transformcolumns.md @@ -13,7 +13,7 @@ Table.TransformColumns(table as table, transformOperations as list ## About -Transforms `table` by applying each column operation listed in `transformOperations` (where the format is { column name, transformation } or { column name, transformation, new column type }). If a `defaultTransformation` is specified, it will be applied to all columns not listed in `transformOperations`. If a column listed in `transformOperations` doesn't exist, an exception is thrown unless the optional parameter `missingField` specifies an alternative (for example, [MissingField.UseNull](missingfield-type.md) or [MissingField.Ignore](missingfield-type.md)). +Transforms `table` by applying each column operation listed in `transformOperations` (where the format is { column name, transformation } or { column name, transformation, new column type }). If a `defaultTransformation` is specified, it will be applied to all columns not listed in `transformOperations`. If a column listed in `transformOperations` doesn't exist, an error is raised unless the optional parameter `missingField` specifies an alternative (for example, [MissingField.UseNull](missingfield-type.md) or [MissingField.Ignore](missingfield-type.md)). ## Example 1 From 75c21580414a3ab30c69fa266cbce7a708c9665e Mon Sep 17 00:00:00 2001 From: Ben Gribaudo Date: Tue, 20 Jan 2026 15:21:38 -0500 Subject: [PATCH 2/3] Tweak --- query-languages/m/custom-date-and-time-format-strings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/query-languages/m/custom-date-and-time-format-strings.md b/query-languages/m/custom-date-and-time-format-strings.md index 4fba4651a..25d32b2e3 100644 --- a/query-languages/m/custom-date-and-time-format-strings.md +++ b/query-languages/m/custom-date-and-time-format-strings.md @@ -1229,7 +1229,7 @@ There are two ways to indicate that characters are to be interpreted as literal ### Using single custom format specifiers -A custom date and time format string consists of two or more characters. Date and time formatting methods interpret any single-character string as a standard date and time format string. If they don't recognize the character as a valid format specifier, they throw an expression error. For example, a format string that consists only of the specifier "h" is interpreted as a standard date and time format string. However, in this particular case, an error is raised because there is no "h" standard date and time format specifier. +A custom date and time format string consists of two or more characters. Date and time formatting methods interpret any single-character string as a standard date and time format string. If they don't recognize the character as a valid format specifier, they raise an error. For example, a format string that consists only of the specifier "h" is interpreted as a standard date and time format string. However, in this particular case, an error is raised because there is no "h" standard date and time format specifier. To use any of the custom date and time format specifiers as the only specifier in a format string (that is, to use the "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", or "/" custom format specifier by itself), include a space before or after the specifier, or include a percent ("%") format specifier before the single custom date and time specifier. From e2d040bf04e00277517749616eefd00a9533b5b7 Mon Sep 17 00:00:00 2001 From: Ben Gribaudo Date: Tue, 20 Jan 2026 15:25:48 -0500 Subject: [PATCH 3/3] Reapplying change --- query-languages/m/table-transformcolumns.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/query-languages/m/table-transformcolumns.md b/query-languages/m/table-transformcolumns.md index 35765a1a3..31a07cfab 100644 --- a/query-languages/m/table-transformcolumns.md +++ b/query-languages/m/table-transformcolumns.md @@ -24,7 +24,7 @@ Transforms the specified table by applying each column operation in a list. * `table`: The table to transform. * `transformOperations`: The transformations to make to the table. The format of this parameter is either { column name, transformation } or { column name, transformation, new column type }. * `defaultTransformation`: (Optional) The default transformation applied to all columns not listed in `transformOperations`. -* `missingField`: (Optional) Specifies the expected action for missing values. If a column listed in `transformOperations` doesn't exist, an exception is thrown (`MissingField.Error`) unless this parameter specifies an alternative. Use one of the following values: +* `missingField`: (Optional) Specifies the expected action for missing values. If a column listed in `transformOperations` doesn't exist, an error is raised (`MissingField.Error`) unless this parameter specifies an alternative. Use one of the following values: * `MissingField.UseNull`: Any missing fields are included as `null` values. * `MissingField.Ignore`: Any missing fields are ignored.