feat: update files for new release

Signed-off-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

Author: kbdharun

.github/workflows/test.yml

@@ -147,7 +147,7 @@ jobs:
         os: ['ubuntu-latest', 'ubuntu-24.04-arm']
 
     steps:
-     - uses: actions/checkout@v4
+     - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
 
      - uses: canonical/action-build@3bdaa03e1ba6bf59a65f84a751d943d549a54e79 # v1.3.0
        id: snapcraft-build

CHANGELOG.md

@@ -1,14 +1,29 @@
 # Changelog
 
-## 3.4.0 (TBA)
+## 3.4.0 (03/28/2025)
+
+### Breaking
+
+* Drop support for EOL Python 3.8 version.
+
+### Bugfixes
+
+* Fix duplicate pages information shown in pages like `du`, `cd`, `w` (thanks [@sellisd](https://github.com/sellisd))
+* Only install `colorama` in Windows devices (thanks [@hukkin](https://github.com/hukkin))
+* Fix broken `--render` option (thanks [@acuteenvy](https://github.com/acuteenvy))
 
 ### Features
 
-* Add support for option placeholders
+* Add support for displaying long/short option placeholders using `--short-options`/`--long-options` flag or [TLDR_OPTIONS variable](https://github.com/tldr-pages/tldr-python-client#command-options) (thanks [@Managor](https://github.com/Managor))
+* Add `--clear-cache`/`-k` option to clear tldr's local cache (thanks [@patricedenis](https://github.com/patricedenis) and [@vitorhcl](https://github.com/vitorhcl))
+* Add support to stylize text inside backticks when appearing in example description (thanks [@kyluca](https://github.com/kyluca))
+* Add support for specifying a certificate bundle with TLDR_CERT (thanks [@jtcbrule](https://github.com/jtcbrule), [@CleanMachine1](https://github.com/CleanMachine1), and [@vitorhcl](https://github.com/vitorhcl))
+* Package build has been migrated from using `setup.py` to `pyproject.toml` with Hatch backend and updated package metadata (thanks [@kbdharun](https://github.com/kbdharun))
+* Add trusted publisher support to securely publish `tldr` package to PyPI directly from the repository's confined environment (thanks [@kbdharun](https://github.com/kbdharun))
 
 ## 3.3.0 (06/29/2024)
 
-## Breaking
+### Breaking
 
 * Drop support for EOL versions Python 3.6 and Python 3.7.
 

docs/man/tldr.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "TLDR" "1" "Jun 29, 2024" "" "tldr"
+.TH "TLDR" "1" "Mar 28, 2025" "" "tldr"
 .SH NAME
 tldr \- tldr 3.4.0
 .sp
@@ -61,6 +61,11 @@ Update the local cache of pages and exit
 .sp
 Default: False
 .TP
+.B \-k, \-\-clear\-cache
+Delete the local cache of pages and exit
+.sp
+Default: False
+.TP
 .B \-p, \-\-platform
 Possible choices: android, freebsd, linux, netbsd, openbsd, osx, sunos, windows, common
 .sp
@@ -92,6 +97,16 @@ Just print the plain page file.
 .sp
 Default: False
 .TP
+.B \-\-short\-options
+Display shortform options over longform
+.sp
+Default: False
+.TP
+.B \-\-long\-options
+Display longform options over shortform
+.sp
+Default: False
+.TP
 .B \-\-print\-completion
 Possible choices: bash, zsh, tcsh
 .sp

snap/snapcraft.yaml

@@ -31,14 +31,6 @@ parts:
     build-environment:
       - PATH: ${CRAFT_PART_INSTALL}/bin:${PATH}
       - PYTHONPATH: ${CRAFT_PART_INSTALL}/lib/python3.12/site-packages
-    override-pull: |
-      craftctl default
-    override-build: |
-      craftctl default
-      cd $CRAFT_PART_SRC/docs
-      make man
-      mkdir -p $CRAFT_PART_INSTALL/share/man/man1
-      cp -r $CRAFT_PART_SRC/docs/man/tldr.1 $CRAFT_PART_INSTALL/share/man/man1/tldr.1
     python-packages:
       - Sphinx
       - sphinx-argparse