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}}`