Tldr

Breaking

* Drop support for EOL versions Python 3.6 and Python 3.7.

Bugfixes

* Return `str` instead of `list` when executing `tldr -l` (thanks [uunnxx](https://github.com/uunnxx))
* Use pathlib instead of os.path (thanks [vitorhcl](https://github.com/vitorhcl))
* Respect language settings when geting a list of commands (thanks [frenzymadness](https://github.com/frenzymadness))
* Fix `--search` option (thanks [CleanMachine1](https://github.com/CleanMachine1))

Features

* Add support for BSD platform directories (thanks [vitorhcl](https://github.com/vitorhcl))
* Add `--update` long option (thanks [owenvoke](https://github.com/owenvoke))
* Add support for fetching individual translation archives for cache (thanks [SaurabhDRao](https://github.com/SaurabhDRao))
* Add support to show message for other versions of the same page in other platforms (thanks [Jaimepas77](https://github.com/Jaimepas77))
* Update `DOWNLOAD_CACHE_LOCATION` to use GitHub Releases (thanks [vitorhcl](https://github.com/vitorhcl))
* Add `macos` alias for `osx` directory and update `--platform` option (thanks [patricedenis](https://github.com/patricedenis))
* Add support for escaping placeholders for special pages (thanks [kbdharun](https://github.com/kbdharun))
* Add support for Python 3.11 and Python 3.12 (thanks [kbdharun](https://github.com/kbdharun))
* Add support for [Client Specification v2.2](https://github.com/tldr-pages/tldr/releases/tag/v2.2)

Bugfixes

* Fix forcing color through termcolor
* Change non-word regex to be POSIX compliant (thanks [stevejbrown](https://github.com/stevejbrown))
* Update pages source to use the main branch
* Add a timeout to the URL requests (thanks [Jaimepas77](https://github.com/Jaimepas77))

Features

* Add `--search` option to find tldr pages based on keywords (thanks [gotlougit](https://github.com/gotlougit))
* Specify support for v1.5 of the [tldr client specification](https://github.com/tldr-pages/tldr/blob/main/CLIENT-SPECIFICATION.md)

Bugfixes

* Command names are lowercased before searching for page
* Fix color printing for tokens that end with curly braces

Breaking

We have moved from [argcomplete](https://github.com/kislyuk/argcomplete) to [shtab](https://github.com/iterative/shtab) for
providing shell completions. This library is more efficient on doing tab completion, avoiding costly time it takes for the python
intrepreter to parse tldr to get options.

See [Readmeautocomplete](https://github.com/tldr-pages/tldr-python-client#autocomplete) for details on setting up shtab. Please
see the [argcomplete README](https://github.com/kislyuk/argcomplete) for details on where to look to remove its provided completions.

Features

* __breaking__ Move to shtab for tab completion support (thanks [casperdcl](https://github.com/casperdcl))
* Change default max cache age from 1 day to 7 days, can get prior behavior by setting the `TLDR_CACHE_MAX_AGE` environment variable
* Install manpage in pypi package
* Add option to print raw markdown (thanks [dadav](https://github.com/dadav))
* Support Python 3.10

Features

* __breaking__ Drop support for Python 3.5 (thanks [nebnola](https://github.com/nebnola))
* Allow overriding system language using `TLDR_LANGUAGE` environment variable (thanks [nebnola](https://github.com/nebnola))

Fixes

* Improve wording of missing page error message (thanks [CleanMachine1](https://github.com/CleanMachine1))

Fixes

* Fallback to using linux as platform if no pages folder found for current platform