diff --git a/tldr/[ b/tldr/[
index d4a9b195..caf88088 100644
--- a/tldr/[
+++ b/tldr/[
@@ -21,7 +21,7 @@ source: https://github.com/tldr-pages/tldr.git
`[ -n "${{variable}}" ]`
-- Test if the specified variable has an empty value:
+- Test if the specified variable has an empty value ([z]ero length):
`[ -z "${{variable}}" ]`
diff --git a/tldr/[[ b/tldr/[[
index 605affe3..d930a685 100644
--- a/tldr/[[
+++ b/tldr/[[
@@ -25,7 +25,7 @@ source: https://github.com/tldr-pages/tldr.git
`[[ -n ${{variable}} ]]`
-- Test if the specified variable has an empty value:
+- Test if the specified variable has an empty value ([z]ero length):
`[[ -z ${{variable}} ]]`
diff --git a/tldr/basenc b/tldr/basenc
index b0bbb310..3bb98f42 100644
--- a/tldr/basenc
+++ b/tldr/basenc
@@ -14,11 +14,11 @@ source: https://github.com/tldr-pages/tldr.git
- Decode a file with base64 encoding:
-`basenc --decode --base64 {{path/to/file}}`
+`basenc {{[-d|--decode]}} --base64 {{path/to/file}}`
- Encode from `stdin` with base32 encoding with 42 columns:
-`{{command}} | basenc --base32 -w42`
+`{{command}} | basenc --base32 {{[-w|--wrap]}} 42`
- Encode from `stdin` with base32 encoding:
diff --git a/tldr/faker b/tldr/faker
new file mode 100644
index 00000000..9cc1ce60
--- /dev/null
+++ b/tldr/faker
@@ -0,0 +1,33 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# faker
+
+> A Python library and a tool to generate fake data.
+> More information: .
+
+- Show all fake data providers along with examples:
+
+`faker`
+
+- Generate fake data of a specific type:
+
+`faker {{name|address|passport_full|credit_card_full|phone_number|email|company|date_time|user_name|password|job|...}}`
+
+- Generate a number of fake addresses from a specific country (use `localectl list-locales | cut -d. -f1` to get list of locales):
+
+`faker --repeat {{number}} --lang {{de_DE|de_CH|...}} address`
+
+- Generate a number of cities in a specific country and output them to a file (use `localectl list-locales | cut -d. -f1` to get list of locales):
+
+`faker --repeat {{number}} --lang {{en_AU|en_US|...}} city -o {{path/to/file.txt}}`
+
+- Generate a number of random HTTP user-agents showing verbose output:
+
+`faker --repeat {{number}} --verbose user_agent`
+
+- Generate a number of domain names and separate each using a specific separator:
+
+`faker --repeat {{number}} --sep '{{,}}' domain_name`
diff --git a/tldr/linux/steamos-select-branch b/tldr/linux/steamos-select-branch
new file mode 100644
index 00000000..608b3831
--- /dev/null
+++ b/tldr/linux/steamos-select-branch
@@ -0,0 +1,29 @@
+---
+syntax: markdown
+tags: [tldr, linux]
+source: https://github.com/tldr-pages/tldr.git
+---
+# steamos-select-branch
+
+> Select a SteamOS system release branch.
+> More information: .
+
+- View the current branch:
+
+`steamos-select-branch -c`
+
+- List all available branches:
+
+`steamos-select-branch -l`
+
+- Switch to the beta branch:
+
+`steamos-select-branch beta`
+
+- Switch back to the stable release:
+
+`steamos-select-branch stable`
+
+- Switch to the bleeding edge branch:
+
+`steamos-select-branch main`
diff --git a/tldr/linux/wpctl b/tldr/linux/wpctl
index 7a623788..6fb744d7 100644
--- a/tldr/linux/wpctl
+++ b/tldr/linux/wpctl
@@ -33,6 +33,10 @@ source: https://github.com/tldr-pages/tldr.git
`wpctl set-volume {{id}} {{n}}%{{+|-}}`
+- Increase the volume of a sink by `n` percent but limit the volume below 100%:
+
+`wpctl set-volume {{[-l|--limit]}} 1 {{id}} {{n}}%-`
+
- Mute/Unmute a sink (1 is mute, 0 is unmute):
`wpctl set-mute {{id}} {{1|0|toggle}}`
diff --git a/tldr/test b/tldr/test
index e09c8512..c1a48cf6 100644
--- a/tldr/test
+++ b/tldr/test
@@ -13,15 +13,15 @@ source: https://github.com/tldr-pages/tldr.git
`test "{{$MY_VAR}}" = "{{/bin/zsh}}"`
-- Test if a given variable is empty:
+- Test if a given variable is empty ([z]ero length):
`test -z "{{$GIT_BRANCH}}"`
-- Test if a file exists:
+- Test if a [f]ile exists:
`test -f "{{path/to/file_or_directory}}"`
-- Test if a directory does not exist:
+- Test if a [d]irectory does not exist:
`test ! -d "{{path/to/directory}}"`
diff --git a/tldr/vdir b/tldr/vdir
index 8c21a4db..490e444d 100644
--- a/tldr/vdir
+++ b/tldr/vdir
@@ -5,9 +5,9 @@ source: https://github.com/tldr-pages/tldr.git
---
# vdir
-> List directory contents.
-> Drop-in replacement for `ls -l`.
-> More information: .
+> Verbosely list directory contents.
+> Drop-in replacement for `ls -l -b`.
+> More information: .
- List files and directories in the current directory, one per line, with details:
@@ -15,11 +15,11 @@ source: https://github.com/tldr-pages/tldr.git
- List with sizes displayed in human-readable units (KB, MB, GB):
-`vdir -h`
+`vdir {{[-h|--human-readable]}}`
- List including hidden files (starting with a dot):
-`vdir -a`
+`vdir {{[-a|--all]}}`
- List files and directories sorting entries by size (largest first):
@@ -35,4 +35,4 @@ source: https://github.com/tldr-pages/tldr.git
- Recursively list all files and directories in a specific directory:
-`vdir --recursive {{path/to/directory}}`
+`vdir {{[-R|--recursive]}} {{path/to/directory}}`