Update cheatsheets

tldr/$

@@ -12,6 +12,10 @@ source: https://github.com/tldr-pages/tldr.git
 
 `echo ${{VARIABLE}}`
 
+- Run variable contents as a command:
+
+`${{VARIABLE}}`
+
 - Print the exit status of the previous command:
 
 `echo $?`

tldr/bitcoind

@@ -21,6 +21,6 @@ source: https://github.com/tldr-pages/tldr.git
 
 `bitcoind -chain={{main|test|signet|regtest}}`
 
-- Start the Bitcoin Core daemon using specific config file and data directory:
+- Start the Bitcoin Core daemon using specific configuration file and data directory:
 
 `bitcoind -conf={{path/to/bitcoin.conf}} -datadir={{path/to/directory}}`

tldr/bpython

@@ -21,6 +21,6 @@ source: https://github.com/tldr-pages/tldr.git
 
 `bpython {{[-i|--interactive]}} {{path/to/file.py}}`
 
-- Use the specified config file instead of the default config:
+- Use the specified configuration file instead of the default configuration:
 
 `bpython --config {{path/to/file.conf}}`

tldr/bzip2recover

@@ -0,0 +1,14 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# bzip2recover
+
+> Attempt to recover data from a damaged `.bz2` file.
+> See also: `bzip2`.
+> More information: <https://manned.org/bzip2recover>.
+
+- Recover all intact blocks from a damaged `.bz2` file:
+
+`bzip2recover {{damaged_file.bz2}}`

tldr/crane-index-append

@@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 > Append manifest to a remote index.
 > This sub-command pushes an index based on an (optional) base index, with appended manifests.
-> The platform for appended manifests is inferred from the config file or omitted if that is infeasible.
+> The platform for appended manifests is inferred from the configuration file or omitted if that is infeasible.
 > More information: <https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane_index_append.md>.
 
 - Append manifest to a remote index:

tldr/doppler

@@ -13,7 +13,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 `doppler setup`
 
-- Setup Doppler project and config in current directory:
+- Setup Doppler project and configuration in current directory:
 
 `doppler setup`
 

tldr/flexget

@@ -20,6 +20,6 @@ source: https://github.com/tldr-pages/tldr.git
 
 `flexget series list`
 
-- Run a task from a config file:
+- Run a task from a configuration file:
 
 `flexget -c {{path/to/config.yml}} execute --task {{task_name}}`

tldr/frps

@@ -17,7 +17,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 `frps {{[-c|--config]}} ./frps.toml`
 
-- Start the service, using a specified config file:
+- Start the service, using a specified configuration file:
 
 `frps {{[-c|--config]}} {{path/to/file}}`
 

tldr/immich-go

@@ -17,7 +17,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 `immich-go -server={{server_url}} -key={{server_key}} upload -create-albums -google-photos -date={{2019-06}} {{path/to/takeout_file.zip}}`
 
-- Upload a takeout file using server and key from a config file:
+- Upload a takeout file using server and key from a configuration file:
 
 `immich-go -use-configuration={{~/.immich-go/immich-go.json}} upload {{path/to/takeout_file.zip}}`
 

tldr/ipcalc

@@ -28,6 +28,6 @@ source: https://github.com/tldr-pages/tldr.git
 
 `ipcalc {{[-s|--split]}} {{size1 size2 size3 ...}} {{192.168.0.1}}`
 
-- Show version information:
+- Display version:
 
 `ipcalc {{[-v|--version]}}`

tldr/jira

@@ -0,0 +1,21 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# jira
+
+> Interface (third party) for interacting with Jira.
+> More information: <https://github.com/ankitpokhrel/jira-cli>.
+
+- List recent issues:
+
+`jira issue list`
+
+- List issues from the current sprint, assigned to me:
+
+`jira sprint list --current -a$(jira me)`
+
+- Create a new issue, optionally set a parent issue:
+
+`jira issue create --parent {{parent}}`

tldr/kubie

@@ -28,6 +28,6 @@ source: https://github.com/tldr-pages/tldr.git
 
 `kubie exec {{context}} {{namespace}} {{command}}`
 
-- Check the Kubernetes config files for issues:
+- Check the Kubernetes configuration files for issues:
 
 `kubie lint`

tldr/linux/dockerd

@@ -14,16 +14,16 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Run Docker daemon and configure it to listen to specific sockets (UNIX and TCP):
 
-`dockerd --host unix://{{path/to/tmp.sock}} --host tcp://{{ip}}`
+`dockerd {{[-H|--host]}} unix://{{path/to/tmp.sock}} {{[-H|--host]}} tcp://{{ip}}`
 
 - Run with specific daemon PID file:
 
-`dockerd --pidfile {{path/to/pid_file}}`
+`dockerd {{[-p|--pidfile]}} {{path/to/pid_file}}`
 
 - Run in debug mode:
 
-`dockerd --debug`
+`dockerd {{[-D|--debug]}}`
 
 - Run and set a specific log level:
 
-`dockerd --log-level {{debug|info|warn|error|fatal}}`
+`dockerd {{[-l|--log-level]}} {{debug|info|warn|error|fatal}}`

tldr/linux/gamescope

@@ -28,6 +28,10 @@ source: https://github.com/tldr-pages/tldr.git
 
 `gamescope {{[-e|--steam]}} -- /usr/bin/steam -tenfoot`
 
+- Specify which display to prefer:
+
+`gamescope {{[-O|--prefer-output]}} {{HDMI-A-1,DP-3,...}} -- {{program}}`
+
 - Toggle fullscreen:
 
 `<Super f>`

tldr/linux/ip

@@ -31,12 +31,12 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Make an interface up/down:
 
-`sudo ip {{[l|link]}} {{[s|set]}} {{interface_name}} {{up|down}}`
+`sudo ip {{[l|link]}} {{[s|set]}} {{ethX}} {{up|down}}`
 
 - Add/Delete an IP address to an interface:
 
-`sudo ip {{[a|address]}} {{add|delete}} {{ip}}/{{mask}} dev {{interface_name}}`
+`sudo ip {{[a|address]}} {{add|delete}} {{ip}}/{{mask}} dev {{ethX}}`
 
 - Add a default route:
 
-`sudo ip {{[r|route]}} {{[a|add]}} default via {{ip}} dev {{interface_name}}`
+`sudo ip {{[r|route]}} {{[a|add]}} default via {{ip}} dev {{ethX}}`

tldr/linux/ip-address

@@ -18,16 +18,16 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Display information about a specific network interface:
 
-`ip {{[a|address]}} {{[s|show]}} {{eth0}}`
+`ip {{[a|address]}} {{[s|show]}} {{ethX}}`
 
 - Add an IP address to a network interface:
 
-`sudo ip {{[a|address]}} {{[a|add]}} {{ip_address}} dev {{eth0}}`
+`sudo ip {{[a|address]}} {{[a|add]}} {{ip_address}} dev {{ethX}}`
 
 - Remove an IP address from a network interface:
 
-`sudo ip {{[a|address]}} {{[d|delete]}} {{ip_address}} dev {{eth0}}`
+`sudo ip {{[a|address]}} {{[d|delete]}} {{ip_address}} dev {{ethX}}`
 
 - Delete all IP addresses in a given scope from a network interface:
 
-`sudo ip {{[a|address]}} {{[f|flush]}} {{eth0}} scope {{global|host|link}}`
+`sudo ip {{[a|address]}} {{[f|flush]}} {{ethX}} scope {{global|host|link}}`

tldr/linux/ip-link

@@ -14,24 +14,24 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Show information about a specific network interface:
 
-`ip {{[l|link]}} {{[sh|show]}} {{ethN}}`
+`ip {{[l|link]}} {{[sh|show]}} {{ethX}}`
 
 - Bring a network interface up or down:
 
-`sudo ip {{[l|link]}} {{[s|set]}} {{ethN}} {{up|down}}`
+`sudo ip {{[l|link]}} {{[s|set]}} {{ethX}} {{up|down}}`
 
 - Give a meaningful name to a network interface:
 
-`sudo ip {{[l|link]}} {{[s|set]}} {{ethN}} {{[al|alias]}} "{{LAN Interface}}"`
+`sudo ip {{[l|link]}} {{[s|set]}} {{ethX}} {{[al|alias]}} "{{LAN Interface}}"`
 
 - Change the MAC address of a network interface:
 
-`sudo ip {{[l|link]}} {{[s|set]}} {{ethN}} {{[a|address]}} {{ff:ff:ff:ff:ff:ff}}`
+`sudo ip {{[l|link]}} {{[s|set]}} {{ethX}} {{[a|address]}} {{ff:ff:ff:ff:ff:ff}}`
 
 - Change the MTU size for a network interface to use jumbo frames:
 
-`sudo ip {{[l|link]}} {{[s|set]}} {{ethN}} mtu {{9000}}`
+`sudo ip {{[l|link]}} {{[s|set]}} {{ethX}} mtu {{9000}}`
 
 - Set the promisc mode status of a device:
 
-`sudo ip {{[l|link]}} {{[s|set]}} {{ethN}} promisc {{on|off}}`
+`sudo ip {{[l|link]}} {{[s|set]}} {{ethX}} promisc {{on|off}}`

tldr/linux/ip-maddress

@@ -14,15 +14,15 @@ source: https://github.com/tldr-pages/tldr.git
 
 - List device specific addresses:
 
-`ip {{[m|maddress]}} {{[s|show]}} dev {{eth0}}`
+`ip {{[m|maddress]}} {{[s|show]}} dev {{ethX}}`
 
 - Join a multicast group statically:
 
-`sudo ip {{[m|maddress]}} {{[a|add]}} {{33:33:00:00:00:02}} dev {{eth0}}`
+`sudo ip {{[m|maddress]}} {{[a|add]}} {{33:33:00:00:00:02}} dev {{ethX}}`
 
 - Leave a static multicast group:
 
-`sudo ip {{[m|maddress]}} {{[d|delete]}} {{33:33:00:00:00:02}} dev {{eth0}}`
+`sudo ip {{[m|maddress]}} {{[d|delete]}} {{33:33:00:00:00:02}} dev {{ethX}}`
 
 - Display help:
 

tldr/linux/ip-neighbour

@@ -12,18 +12,18 @@ source: https://github.com/tldr-pages/tldr.git
 
 `ip {{[n|neighbour]}}`
 
-- Remove entries in the neighbour table on device `eth0`:
+- Remove entries in the neighbour table on device `ethX`:
 
-`sudo ip {{[n|neighbour]}} {{[f|flush]}} dev {{eth0}}`
+`sudo ip {{[n|neighbour]}} {{[f|flush]}} dev {{ethX}}`
 
 - Perform a neighbour lookup and return a neighbour entry:
 
-`ip {{[n|neighbour]}} {{[g|get]}} {{lookup_ip}} dev {{eth0}}`
+`ip {{[n|neighbour]}} {{[g|get]}} {{lookup_ip}} dev {{ethX}}`
 
-- Add or delete an ARP entry for the neighbour IP address to `eth0`:
+- Add or delete an ARP entry for the neighbour IP address to `ethX`:
 
-`sudo ip {{[n|neighbour]}} {{add|delete}} {{ip_address}} lladdr {{mac_address}} dev {{eth0}} nud reachable`
+`sudo ip {{[n|neighbour]}} {{add|delete}} {{ip_address}} lladdr {{mac_address}} dev {{ethX}} nud reachable`
 
-- Change or replace an ARP entry for the neighbour IP address to `eth0`:
+- Change or replace an ARP entry for the neighbour IP address to `ethX`:
 
-`sudo ip {{[n|neighbour]}} {{change|replace}} {{ip_address}} lladdr {{new_mac_address}} dev {{eth0}}`
+`sudo ip {{[n|neighbour]}} {{change|replace}} {{ip_address}} lladdr {{new_mac_address}} dev {{ethX}}`

tldr/linux/ip-route

@@ -16,21 +16,21 @@ source: https://github.com/tldr-pages/tldr.git
 
 `sudo ip {{[r|route]}} {{[a|add]}} default via {{gateway_ip}}`
 
-- Add a default route using `eth0`:
+- Add a default route using `ethX`:
 
-`sudo ip {{[r|route]}} {{[a|add]}} default dev {{eth0}}`
+`sudo ip {{[r|route]}} {{[a|add]}} default dev {{ethX}}`
 
 - Add a static route:
 
-`sudo ip {{[r|route]}} {{[a|add]}} {{destination_ip}} via {{gateway_ip}} dev {{eth0}}`
+`sudo ip {{[r|route]}} {{[a|add]}} {{destination_ip}} via {{gateway_ip}} dev {{ethX}}`
 
 - Delete a static route:
 
-`sudo ip {{[r|route]}} {{[d|delete]}} {{destination_ip}} dev {{eth0}}`
+`sudo ip {{[r|route]}} {{[d|delete]}} {{destination_ip}} dev {{ethX}}`
 
 - Change or replace a static route:
 
-`sudo ip {{[r|route]}} {{change|replace}} {{destination_ip}} via {{gateway_ip}} dev {{eth0}}`
+`sudo ip {{[r|route]}} {{change|replace}} {{destination_ip}} via {{gateway_ip}} dev {{ethX}}`
 
 - Show which route will be used by the kernel to reach an IP address:
 

tldr/linux/ip-route-add

@@ -12,14 +12,14 @@ source: https://github.com/tldr-pages/tldr.git
 
 `sudo ip {{[r|route]}} {{[a|add]}} default via {{gateway_ip}}`
 
-- Add a default route using `eth0`:
+- Add a default route using `ethX`:
 
-`sudo ip {{[r|route]}} {{[a|add]}} default dev {{eth0}}`
+`sudo ip {{[r|route]}} {{[a|add]}} default dev {{ethX}}`
 
 - Add a static route:
 
-`sudo ip {{[r|route]}} {{[a|add]}} {{destination_ip}} via {{gateway_ip}} dev {{eth0}}`
+`sudo ip {{[r|route]}} {{[a|add]}} {{destination_ip}} via {{gateway_ip}} dev {{ethX}}`
 
 - Add a route to a specific routing table:
 
-`sudo ip {{[r|route]}} {{[a|add]}} {{destination_ip}} dev {{eth0}} {{[t|table]}} {{ip}}`
+`sudo ip {{[r|route]}} {{[a|add]}} {{destination_ip}} dev {{ethX}} {{[t|table]}} {{ip}}`

tldr/linux/ip-route-get

@@ -18,11 +18,11 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Print route to a destination for packets arriving on a specific interface:
 
-`ip {{[r|route]}} {{[g|get]}} {{destination}} iif {{eth0}}`
+`ip {{[r|route]}} {{[g|get]}} {{destination}} iif {{ethX}}`
 
 - Print route to a destination, forcing output through a specific interface:
 
-`ip {{[r|route]}} {{[g|get]}} {{destination}} oif {{eth1}}`
+`ip {{[r|route]}} {{[g|get]}} {{destination}} oif {{ethX}}`
 
 - Print route to a destination with a specified Type of Service (ToS):
 

tldr/linux/ip-route-list

@@ -26,7 +26,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 - List routes from a given device only:
 
-`ip {{[r|route]}} {{[l|list]}} dev {{eth0}}`
+`ip {{[r|route]}} {{[l|list]}} dev {{ethX}}`
 
 - List routes within a given scope:
 

tldr/linux/ldd

@@ -15,16 +15,16 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Display all information about dependencies:
 
-`ldd --verbose {{path/to/binary}}`
+`ldd {{[-v|--verbose]}} {{path/to/binary}}`
 
 - Display unused direct dependencies:
 
-`ldd --unused {{path/to/binary}}`
+`ldd {{[-u|--unused]}} {{path/to/binary}}`
 
 - Report missing data objects and perform data relocations:
 
-`ldd --data-relocs {{path/to/binary}}`
+`ldd {{[-d|--data-relocs]}} {{path/to/binary}}`
 
 - Report missing data objects and functions, and perform relocations for both:
 
-`ldd --function-relocs {{path/to/binary}}`
+`ldd {{[-r|--function-relocs]}} {{path/to/binary}}`

tldr/linux/nl

@@ -14,7 +14,7 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Read from `stdin`:
 
-`{{command}} | nl -`
+`{{command}} | nl`
 
 - Number [a]ll body lines including blank lines or do [n]ot number body lines:
 

tldr/linux/sfill

@@ -12,18 +12,18 @@ source: https://github.com/tldr-pages/tldr.git
 
 `sfill {{/path/to/mounted_disk_directory}}`
 
-- Overwrite free space and inodes of a disk with 6 writes (fast but less secure) and show status:
+- Overwrite free space and inodes of a disk with 6 writes (fast but [l]ess secure) and show status ([v]erbose):
 
 `sfill -l -v {{/path/to/mounted_disk_directory}}`
 
-- Overwrite free space and inodes of a disk with 1 write (very fast but insecure) and show status:
+- Overwrite free space and inodes of a disk with 1 write (very fast but [l]ess secure [v]erbose) and show status:
 
 `sfill -ll -v {{/path/to/mounted_disk_directory}}`
 
-- Overwrite only free space of a disk:
+- Overwrite only free space of a d[I]sk:
 
 `sfill -I {{/path/to/mounted_disk_directory}}`
 
-- Overwrite only free inodes of a disk:
+- Overwrite only free [i]nodes of a disk:
 
 `sfill -i {{/path/to/mounted_disk_directory}}`

tldr/mp3info

@@ -12,22 +12,22 @@ source: https://github.com/tldr-pages/tldr.git
 
 `mp3info {{path/to/file.mp3}}`
 
-- Edit ID3v1 tags interactively:
+- Edit ID3v1 tags [i]nteractively:
 
 `mp3info -i {{path/to/file.mp3}}`
 
-- Set values for ID3v1 tags in a specific MP3 file:
+- Set values for ID3v1 tags in a specific MP3 file ([a]rtist, [t]itle, a[l]bum, [y]ear, and [c]omment):
 
 `mp3info -a "{{artist_name}}" -t "{{song_title}}" -l "{{album_title}}" -y {{year}} -c "{{comment_text}}" {{path/to/file.mp3}}`
 
-- Set the number of the track in the album for a specific MP3 file:
+- Set the [n]umber of the track in the album for a specific MP3 file:
 
 `mp3info -n {{track_number}} {{path/to/file.mp3}}`
 
-- Print a list of valid genres and their numeric codes:
+- [G]et a list of valid genres and their numeric codes:
 
 `mp3info -G`
 
-- Set the music genre for a specific MP3 file:
+- Set the music [g]enre for a specific MP3 file:
 
 `mp3info -g {{genre_number}} {{path/to/file.mp3}}`

tldr/msgcat

@@ -0,0 +1,34 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# msgcat
+
+> Concatenate and merge multiple `.po` translation files.
+> Useful in software localization pipelines to combine message catalogs with filtering options.
+> More information: <https://www.gnu.org/software/gettext/manual/html_node/msgcat-Invocation.html>.
+
+- Combine multiple `.po` files into one:
+
+`msgcat {{file1.po file2.po ...}} {{[-o|--output-file]}} {{combined.po}}`
+
+- Combine input files listed in a text file:
+
+`msgcat {{[-f|--files-from]}} {{path/to/file_list.txt}} {{[-o|--output-file]}} {{combined.po}}`
+
+- Set the output encoding (e.g. UTF-8):
+
+`msgcat {{[-t|--to-code]}} {{UTF-8}} {{input.po}} {{[-o|--output-file]}} {{output.po}}`
+
+- Output only unique messages (appearing in one file only):
+
+`msgcat {{[-u|--unique]}} {{file1.po file2.po ...}} {{[-o|--output-file]}} {{unique.po}}`
+
+- Use the first available translation for duplicate entries:
+
+`msgcat --use-first {{file1.po file2.po ...}} {{[-o|--output-file]}} {{output.po}}`
+
+- Display help:
+
+`msgcat {{[-h|--help]}}`

tldr/patator

@@ -28,6 +28,6 @@ source: https://github.com/tldr-pages/tldr.git
 
 `patator --help`
 
-- Show help for a particular module:
+- Display help for a particular module:
 
 `patator {{module_name}} --help`

tldr/piper

@@ -9,7 +9,7 @@ source: https://github.com/tldr-pages/tldr.git
 > Try out and download speech models from <https://rhasspy.github.io/piper-samples>.
 > More information: <https://github.com/rhasspy/piper>.
 
-- Output a WAV [f]ile using a text-to-speech [m]odel (assuming a config file at model_path + .json):
+- Output a WAV [f]ile using a text-to-speech [m]odel (assuming a configuration file at model_path + .json):
 
 `echo {{Thing to say}} | piper -m {{path/to/model.onnx}} -f {{outputfile.wav}}`
 

tldr/pre-commit

@@ -24,6 +24,6 @@ source: https://github.com/tldr-pages/tldr.git
 
 `pre-commit clean`
 
-- Update pre-commit config file to the latest repos' versions:
+- Update pre-commit configuration file to the latest repos' versions:
 
 `pre-commit autoupdate`

tldr/rage

@@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git
 ---
 # rage
 
-> A simple, secure and modern file encryption tool (and Rust library) with small explicit keys, no config options, and UNIX-style composability.
+> A simple, secure and modern file encryption tool (and Rust library) with small explicit keys, no configuration options, and UNIX-style composability.
 > Rust implementation of `age`.
 > More information: <https://github.com/str4d/rage>.
 

tldr/secrethub

@@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git
 ---
 # secrethub
 
-> Keep secrets out of config files.
+> Keep secrets out of configuration files.
 > More information: <https://github.com/secrethub/secrethub-cli>.
 
 - Print a secret to `stdout`:

tldr/step

@@ -37,6 +37,6 @@ source: https://github.com/tldr-pages/tldr.git
 
 `step crypto keypair {{path/to/public_key}} {{path/to/private_key}} --kty {{RSA|EC}}`
 
-- Show help for subcommands:
+- Display help for subcommands:
 
 `step {{path|base64|certificate|completion|context|crl|crypto|oauth|ca|beta|ssh}} --help`

tldr/zdb

@@ -14,8 +14,8 @@ source: https://github.com/tldr-pages/tldr.git
 
 - Show detailed configuration for a specific ZFS pool:
 
-`zdb -C {{poolname}}`
+`zdb {{[-C|--config]}} {{poolname}}`
 
 - Show statistics about number, size and deduplication of blocks:
 
-`zdb -b {{poolname}}`
+`zdb {{[-b|--block-stats]}} {{poolname}}`