From 76834469e1932ca02f180844f6837d08aee390dd Mon Sep 17 00:00:00 2001
From: ivuorinen <ivuorinen@users.noreply.github.com>
Date: Thu, 6 Jun 2024 00:14:06 +0000
Subject: [PATCH] Update cheatsheets

---
 tldr/ansible-playbook |  4 ++++
 tldr/audtool          | 41 +++++++++++++++++++++++++++++++++++++++++
 tldr/gzip             | 20 ++++++++++++--------
 3 files changed, 57 insertions(+), 8 deletions(-)
 create mode 100755 tldr/audtool

diff --git a/tldr/ansible-playbook b/tldr/ansible-playbook
index 378f1683..730bd61a 100644
--- a/tldr/ansible-playbook
+++ b/tldr/ansible-playbook
@@ -31,3 +31,7 @@ source: https://github.com/tldr-pages/tldr.git
 - Run tasks in a playbook starting at a specific task:
 
 `ansible-playbook {{playbook}} --start-at {{task_name}}`
+
+- Run tasks in a playbook without making any changes (dry-run):
+
+`ansible-playbook {{playbook}} --check --diff`
diff --git a/tldr/audtool b/tldr/audtool
new file mode 100755
index 00000000..57ddb6f5
--- /dev/null
+++ b/tldr/audtool
@@ -0,0 +1,41 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# audtool
+
+> Control Audacious using commands.
+> More information: <https://manned.org/audtool>.
+
+- Play/pause audio playback:
+
+`audtool playback-playpause`
+
+- Print artist, album, and song name of currently playing song:
+
+`audtool current-song`
+
+- Set volume of audio playback:
+
+`audtool set-volume {{100}}`
+
+- Skip to the next song:
+
+`audtool playlist-advance`
+
+- Print the bitrate of the current song in kilobits:
+
+`audtool current-song-bitrate-kbps`
+
+- Open Audacious in full-screen if hidden:
+
+`audtool mainwin-show`
+
+- Display help:
+
+`audtool help`
+
+- Display settings:
+
+`audtool preferences-show`
diff --git a/tldr/gzip b/tldr/gzip
index f05e630e..8f2c091b 100644
--- a/tldr/gzip
+++ b/tldr/gzip
@@ -10,24 +10,28 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Compress a file, replacing it with a `gzip` archive:
 
-`gzip {{file.ext}}`
+`gzip {{path/to/file}}`
 
 - Decompress a file, replacing it with the original uncompressed version:
 
-`gzip -d {{file.ext}}.gz`
+`gzip {{-d|--decompress path/to/file.gz}}`
 
 - Compress a file, keeping the original file:
 
-`gzip --keep {{file.ext}}`
+`gzip {{-k|--keep path/to/file}}`
 
-- Compress a file specifying the output filename:
+- Compress a file, specifying the output filename:
 
-`gzip -c {{file.ext}} > {{compressed_file.ext.gz}}`
+`gzip {{-c|--stdout path/to/file}} > {{path/to/compressed_file.gz}}`
 
 - Decompress a `gzip` archive specifying the output filename:
 
-`gzip -c -d {{file.ext}}.gz > {{uncompressed_file.ext}}`
+`gzip {{-c|--stdout}} {{-d|--decompress}} {{path/to/file.gz}} > {{path/to/uncompressed_file}}`
 
-- Specify the compression level. 1=Fastest (Worst), 9=Slowest (Best), Default level is 6:
+- Specify the compression level. 1 is the fastest (low compression), 9 is the slowest (high compression), 6 is the default:
 
-`gzip -9 -c {{file.ext}} > {{compressed_file.ext.gz}}`
+`gzip -{{1..9}} {{-c|--stdout}} {{path/to/file}} > {{path/to/compressed_file.gz}}`
+
+- Display the name and reduction percentage for each file compressed or decompressed:
+
+`gzip {{-v|--verbose}} {{-d|--decompress}} {{path/to/file.gz}}`