Flux 0.148 (#3647)

* Flux 0.148

* updated flux release notes

* removed unnecessary newline

* fixed typo

content/flux/v0.x/release-notes.md

@@ -10,6 +10,39 @@ aliases:
   - /influxdb/cloud/reference/release-notes/flux/
 ---
 
+## v0.148.0 [2022-01-10]
+
+### Features
+- Report multiple errors from a single `unify` call.
+- Update [`to`](/flux/v0.x/stdlib/influxdata/influxdb/to/) transformation to use
+  narrow transformation.
+- Provide specific error information on function calls.
+- Allow errors to be formatted via `codespan`.
+- Add an `internal/debug.opaque` function.
+- Provide which package exported a symbol.
+- Add timeable support to [`experimental.addDuration()`](/flux/v0.x/stdlib/experimental/addduration/)
+  and [`experimental.subDuration()`](/flux/v0.x/stdlib/experimental/subduration/).
+- Add inline documentation to the following packages:
+  - interpolate
+  - json
+  - kafka
+  - math
+  - regexp
+  - runtime
+  - sampledata
+  - slack
+  - system
+  - pagerduty
+  - profiler
+  - pushbullet
+
+### Bug fixes
+- Classify IP validation failures as `Invalid`.
+- Relocate the mutex in the optimized union to avoid a data race.
+- Split the entire pipe chain into multiple lines (if necessary).
+
+---
+
 ## v0.147.0 [2021-12-14]
 
 ### Features

content/flux/v0.x/stdlib/experimental/addduration.md

@@ -29,8 +29,8 @@ See [influxdata/flux#413](https://github.com/influxdata/flux/issues/413).
 import "experimental"
 
 experimental.addDuration(
-  d: 12h,
-  to: now(),
+    d: 12h,
+    to: now(),
 )
 ```
 
@@ -39,8 +39,10 @@ experimental.addDuration(
 ### d {data-type="duration"}
 The duration to add.
 
-### to {data-type="time"}
+### to {data-type="time, duration"}
 The time to add the [duration](#d) to.
+Use an absolute time or a relative duration.
+Durations are relative to [`now()`](/flux/v0.x/stdlib/universe/now/).
 
 ## Examples
 
@@ -48,10 +50,18 @@ The time to add the [duration](#d) to.
 ```js
 import "experimental"
 
-experimental.addDuration(
-  d: 6h,
-  to: 2019-09-16T12:00:00Z,
-)
+experimental.addDuration(d: 6h, to: 2019-09-16T12:00:00Z)
 
 // Returns 2019-09-16T18:00:00.000000000Z
 ```
+
+### Add six hours to a relative duration
+```js
+import "experimental"
+
+option now = () => 2022-01-01T12:00:00Z
+
+experimental.addDuration(d: 6h, to: 3h)
+
+// Returns 2022-01-01T21:00:00.000000000Z
+```

content/flux/v0.x/stdlib/experimental/subduration.md

@@ -29,8 +29,8 @@ See [influxdata/flux#413](https://github.com/influxdata/flux/issues/413).
 import "experimental"
 
 experimental.subDuration(
-  d: 12h,
-  from: now(),
+    d: 12h,
+    from: now(),
 )
 ```
 
@@ -39,8 +39,10 @@ experimental.subDuration(
 ### d {data-type="duration"}
 The duration to subtract.
 
-### from {data-type="time"}
+### from {data-type="time, duration"}
 The time to subtract the [duration](#d) from.
+Use an absolute time or a relative duration.
+Durations are relative to [`now()`](/flux/v0.x/stdlib/universe/now/).
 
 ## Examples
 
@@ -48,10 +50,18 @@ The time to subtract the [duration](#d) from.
 ```js
 import "experimental"
 
-experimental.subDuration(
-  d: 6h,
-  from: 2019-09-16T12:00:00Z,
-)
+experimental.subDuration(d: 6h, from: 2019-09-16T12:00:00Z)
 
 // Returns 2019-09-16T06:00:00.000000000Z
 ```
+
+### Subtract six hours from a relative duration
+```js
+import "experimental"
+
+option now = () => 2022-01-01T12:00:00Z
+
+experimental.subDuration(d: 6h, from: -3h)
+
+// Returns 2022-01-01T03:00:00.000000000Z
+```