[`tfenv use`] `latest-allowed`

[n3ph]

According to the Usage Section, this should work:

$ tfenv --version
tfenv 3.0.0
$ tfenv use latest-allowed
No installed versions of terraform matched 'latest-allowed:^latest-allowed$'. Trying to install a matching version since TFENV_AUTO_INSTALL=true
No versions matching 'latest-allowed' found in remote
Installing a matching version failed

[hamdrew]

I also receive this error when running tfenv install latest-allowed:

$ tfenv --version
tfenv 3.0.0
$ tfenv install latest-allowed
No versions matching 'latest-allowed' found in remote

[paul-prdca]

I just spent a lot of time tripping over this problem.

latest-allowed isn't included in 3.0.0, because it was released over a year ago. The functionality is on main, but not in a release yet.

See: https://github.com/tfutils/tfenv/compare/v3.0.0...master#diff-77279bd92af9729502947ae2a770914afec4e1c199dd53beeafaa4a73e3f3106

Until there's a new release, it won't work for a tagged install like brew. The documentation is current, but confusing because the releases are behind.