Merge pull request #2874 from carapace-sh/bridge-inspector

docs: added v1.4 release notes

Author: rsteube

docs/src/SUMMARY.md

@@ -40,6 +40,7 @@
       - [carapace-generate](./development/tools/carapace-generate.md)
   - [Release Notes](./release_notes.md)
     - [v1.x](./release_notes/v1.x.md)
+    - [v1.4](./release_notes/v1.4.md)
     - [v1.3](./release_notes/v1.3.md)
     - [v1.2](./release_notes/v1.2.md)
     - [v1.1](./release_notes/v1.1.md)

docs/src/bridges.md

@@ -16,6 +16,7 @@ tsh: kingpin
 
 Currently available bridges:
 - [argcomplete](https://github.com/kislyuk/argcomplete)
+- [argcomplete@v1](https://github.com/kislyuk/argcomplete) (legacy)
 - [bash](https://www.gnu.org/software/bash/)
 - [carapace](https://github.com/carapace-sh/carapace)
 - [clap](https://github.com/clap-rs/clap) (needs [clap-rs/clap#3166](https://github.com/clap-rs/clap/issues/3166))
@@ -27,6 +28,7 @@ Currently available bridges:
 - [kingpin](https://github.com/alecthomas/kingpin)
 - [powershell](https://microsoft.com/powershell)
 - [urfavecli](https://github.com/urfave/cli)
+- [urfavecli@v1](https://github.com/urfave/cli) (legacy)
 - [yargs](https://github.com/yargs/yargs)
 - [zsh](https://www.zsh.org/)
 

docs/src/release_notes/v1.4.md

@@ -0,0 +1,59 @@
+# v1.4 - Bridge Inspector
+
+![](./v1.4/banner.png)
+
+Looking into details.
+
+## Detect
+
+Added `carapace --detect COMMAND` to auto-detect bridgeable frameworks.
+
+![](./v1.4/detect.cast)
+
+> **WARNING:** This invokes given command multiple times with various arguments.
+
+## Urfavecli
+
+Added support for [urfave/cli](https://github.com/urfave/cli) v3 and updated [identifiers](../bridges.md).
+
+- `argcomplete`
+- `argcomplete@v1` (legacy)
+- `urfavecli`
+- `urfavecli@v1` (legacy)
+
+Also renamed `ArgcompleteLegacy` to `ArgcompleteV1`.
+
+## Termux
+
+Now in official package repo [termux/termux-packages](https://github.com/termux/termux-packages).
+
+```sh
+pkg install carapace
+```
+
+## Alias
+
+Added [variable substitution](https://github.com/drone/envsubst) to [aliases](../spec/run.html#alias).
+
+```yaml
+name: example
+run: "[gh, issue, --repo, '${REPO}']"
+```
+
+![](./v1.4/alias.cast)
+
+## Lint
+
+Removed `carapace-fmt` and integrated formatting into `carapace-lint`.
+
+![](./v1.4/lint.cast)
+
+## Hidden
+
+Updated [CARAPACE_HIDDEN](../setup/environment.md#carapace_hidden) for more granular control.
+
+- `0` - disabled
+- `1` - enabled
+- `2` - enabled including `_carapace`
+
+![](./v1.4/hidden.cast)

docs/src/release_notes/v1.x/alias.cast docs/src/release_notes/v1.4/alias.castdocs/src/release_notes/v1.x/alias.cast renamed to docs/src/release_notes/v1.4/alias.cast

@@ -3,40 +3,3 @@
 ![](./v1.x/banner.png)
 
 Under development.
-
-## Detect
-
-Added `carapace --detect command` to auto-detect bridgeable frameworks.
-
-![](./v1.x/detect.cast)
-
-> **WARNING:** this invokes given command multiple times.
-
-## Argcomplete
-
-Renamed `ArgcompleteLegacy` to `ArgcompleteV1` (`argcomplete@v1` in `bridges.yaml`).
-
-## Urfavecli
-
-Added support for [urfave/cli](https://github.com/urfave/cli) v3.
-> The bridge `urfavecli` targets the latest version.
-> Use `urfavecli@v1` for commands still relying on an older version of the library.
-
-## Termux
-
-Now in official package repo [termux/termux-packages](https://github.com/termux/termux-packages).
-
-```sh
-pkg install carapace
-```
-
-## Alias
-
-Added environment substitution to [aliases](../spec/run.html#alias).
-
-```yaml
-name: example
-run: "[gh, issue, --repo, '${REPO}']"
-```
-
-![](./v1.x/alias.cast)

docs/src/release_notes/v1.4/banner.png

@@ -36,6 +36,7 @@ Whether to show hidden commands/flags.
 
 - `0` - disabled
 - `1` - enabled
+- `2` - enabled including `_carapace`
 
 ![](./hidden.cast)