From fc41505b06ce36772d8cd98e0cd842d431a997b1 Mon Sep 17 00:00:00 2001
From: ivuorinen <ivuorinen@users.noreply.github.com>
Date: Mon, 20 May 2024 00:14:07 +0000
Subject: [PATCH] Update cheatsheets

---
 tldr/linux/pw-config | 37 +++++++++++++++++++++++++++++++++++++
 tldr/sops            | 20 ++++++++++++--------
 2 files changed, 49 insertions(+), 8 deletions(-)
 create mode 100644 tldr/linux/pw-config

diff --git a/tldr/linux/pw-config b/tldr/linux/pw-config
new file mode 100644
index 00000000..f4d43b55
--- /dev/null
+++ b/tldr/linux/pw-config
@@ -0,0 +1,37 @@
+---
+syntax: markdown
+tags: [tldr, linux]
+source: https://github.com/tldr-pages/tldr.git
+---
+# pw-config
+
+> List configuration paths and sections that will be used by the PipeWire server and clients.
+> More information: <https://docs.pipewire.org/page_man_pw-config_1.html>.
+
+- List all configuration files that will be used:
+
+`pw-config`
+
+- List all configuration files that will be used by the PipeWire PulseAudio server:
+
+`pw-config --name pipewire-pulse.conf`
+
+- List all configuration sections used by the PipeWire PulseAudio server:
+
+`pw-config --name pipewire-pulse.conf list`
+
+- List the `context.properties` fragments used by the JACK clients:
+
+`pw-config --name jack.conf list context.properties`
+
+- List the merged `context.properties` used by the JACK clients:
+
+`pw-config --name jack.conf merge context.properties`
+
+- List the merged `context.modules` used by the PipeWire server and [r]eformat:
+
+`pw-config --name pipewire.conf --recurse merge context.modules`
+
+- Display help:
+
+`pw-config --help`
diff --git a/tldr/sops b/tldr/sops
index a04b1563..316736c1 100644
--- a/tldr/sops
+++ b/tldr/sops
@@ -5,29 +5,33 @@ source: https://github.com/tldr-pages/tldr.git
 ---
 # sops
 
-> SOPS (Secrets OPerationS): manage secrets.
+> SOPS (Secrets OPerationS): a simple and flexible tool for managing secrets.
 > More information: <https://github.com/mozilla/sops>.
 
 - Encrypt a file:
 
-`sops -e {{path/to/myfile.json}} > {{path/to/myfile.enc.json}}`
+`sops -e {{path/to/file.json}} > {{path/to/file.enc.json}}`
 
 - Decrypt a file to `stdout`:
 
-`sops -d {{path/to/myfile.enc.json}}`
+`sops -d {{path/to/file.enc.json}}`
 
-- Rotate data keys for a sops file:
+- Update the declared keys in a `sops` file:
 
-`sops -r {{path/to/myfile.enc.yaml}}`
+`sops updatekeys {{path/to/file.enc.yaml}}`
+
+- Rotate data keys for a `sops` file:
+
+`sops -r {{path/to/file.enc.yaml}}`
 
 - Change the extension of the file once encrypted:
 
-`sops -d --input-type json {{path/to/myfile.enc.json}}`
+`sops -d --input-type json {{path/to/file.enc.json}}`
 
 - Extract keys by naming them, and array elements by numbering them:
 
-`sops -d --extract '["an_array"][1]' {{path/to/myfile.enc.json}}`
+`sops -d --extract '["an_array"][1]' {{path/to/file.enc.json}}`
 
-- Show the difference between two sops files:
+- Show the difference between two `sops` files:
 
 `diff <(sops -d {{path/to/secret1.enc.yaml}}) <(sops -d {{path/to/secret2.enc.yaml}})`