diff --git a/tldr/! b/tldr/! index 0dc40f40..6d9e0e51 100644 --- a/tldr/! +++ b/tldr/! @@ -6,6 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # ! > Reuse and expand the shell history in `sh`, Bash, Zsh, `rbash`, and `ksh`. +> See also: `^`. > More information: . - Substitute with the previous command and run it with `sudo`: diff --git a/tldr/^ b/tldr/^ index 076b7487..732b3284 100644 --- a/tldr/^ +++ b/tldr/^ @@ -7,6 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Bash builtin to quick substitute a string in the previous command and run the result. > Equivalent to `!!:s^string1^string2`. +> See also: `!`. > More information: . - Run the previous command replacing `string1` with `string2`: diff --git a/tldr/addcomputer.py b/tldr/addcomputer.py new file mode 100644 index 00000000..720466ef --- /dev/null +++ b/tldr/addcomputer.py @@ -0,0 +1,33 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# addcomputer.py + +> Add a computer account to domain. +> More information: . + +- Add a computer with a specific name and password: + +`addcomputer.py -computer-name {{COMPUTER_NAME$}} -computer-pass {{computer_password}} {{domain}}/{{username}}:{{password}}` + +- Only set a new password on an existing computer: + +`addcomputer.py -no-add -computer-name {{COMPUTER_NAME$}} -computer-pass {{computer_password}} {{domain}}/{{username}}:{{password}}` + +- Delete an existing computer account: + +`addcomputer.py -delete -computer-name {{COMPUTER_NAME$}} {{domain}}/{{username}}:{{password}}` + +- Add computer using Kerberos authentication: + +`addcomputer.py -k -no-pass {{domain}}/{{username}}@{{hostname}}` + +- Add computer via LDAPS (port 636) instead of SAMR (port 445): + +`addcomputer.py -method LDAPS -port 636 {{domain}}/{{username}}:{{password}}` + +- Specify exact domain controller when multiple DCs exist: + +`addcomputer.py -dc-host {{hostname}} {{domain}}/{{username}}:{{password}}` diff --git a/tldr/ansible-vault b/tldr/ansible-vault index 14cb5dd8..c7b54dc6 100644 --- a/tldr/ansible-vault +++ b/tldr/ansible-vault @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # ansible-vault -> Encrypt and decrypt values, data structures and files within Ansible projects. +> Encrypt and decrypt values, data structures, and files within Ansible projects. > More information: . - Create a new encrypted vault file with a prompt for a password: diff --git a/tldr/aws-codeartifact b/tldr/aws-codeartifact index 26a1d4bc..f83a931f 100644 --- a/tldr/aws-codeartifact +++ b/tldr/aws-codeartifact @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # aws codeartifact -> Manage CodeArtifact repositories, domains, packages, package versions and assets. +> Manage CodeArtifact repositories, domains, packages, package versions, and assets. > CodeArtifact is an artifact repository compatible with popular package managers and build tools like Maven, Gradle, npm, Yarn, Twine, pip, NuGet, and SwiftPM. > More information: . diff --git a/tldr/aws-quicksight b/tldr/aws-quicksight index 6e12532e..f1e846a7 100644 --- a/tldr/aws-quicksight +++ b/tldr/aws-quicksight @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # aws quicksight -> Create, delete, list, search and update AWS QuickSight entities. +> Create, delete, list, search, and update AWS QuickSight entities. > More information: . - List datasets: diff --git a/tldr/aws-rds b/tldr/aws-rds index 73bb583a..f9bcd7d1 100644 --- a/tldr/aws-rds +++ b/tldr/aws-rds @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # aws rds -> Use AWS Relational Database Service, a web service for setting up, operating and scaling relational databases. +> Use AWS Relational Database Service, a web service for setting up, operating, and scaling relational databases. > More information: . - Display help for a specific RDS subcommand: diff --git a/tldr/awslogs b/tldr/awslogs index d4e9c3f7..8c5a1535 100644 --- a/tldr/awslogs +++ b/tldr/awslogs @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # awslogs -> Queries groups, streams and events from Amazon CloudWatch logs. +> Query groups, streams, and events from Amazon CloudWatch logs. > More information: . - List log groups: diff --git a/tldr/balena b/tldr/balena index f6486565..1b2df433 100644 --- a/tldr/balena +++ b/tldr/balena @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # balena -> Interact with the balenaCloud, openBalena and the balena API. +> Interact with the balenaCloud, openBalena, and the balena API. > More information: . - Log in to the balenaCloud account: diff --git a/tldr/bash b/tldr/bash index cc46bd62..1086d661 100644 --- a/tldr/bash +++ b/tldr/bash @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # bash > Bourne-Again SHell, an `sh`-compatible command-line interpreter. -> See also: `zsh`, `histexpand` (history expansion). +> See also: `zsh`, `!` (history expansion). > More information: . - Start an interactive shell session: diff --git a/tldr/bat b/tldr/bat index 33e0d496..54425e43 100644 --- a/tldr/bat +++ b/tldr/bat @@ -25,7 +25,7 @@ source: https://github.com/tldr-pages/tldr.git `bat {{[-H|--highlight-line]}} {{10|5:10|:10|10:|10:+5}} {{path/to/file}}` -- Show non-printable characters like space, tab or newline: +- Show non-printable characters like space, tab, or newline: `bat {{[-A|--show-all]}} {{path/to/file}}` diff --git a/tldr/bgpgrep b/tldr/bgpgrep index fdf393ce..993b3db6 100644 --- a/tldr/bgpgrep +++ b/tldr/bgpgrep @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # bgpgrep > Filter and print BGP data within MRT dumps. -> Can read files compressed with `gzip`, `bzip2` and `xz`. +> Can read files compressed with `gzip`, `bzip2`, and `xz`. > More information: . - List all routes: diff --git a/tldr/binwalk b/tldr/binwalk index d8d1c2a3..52dc2847 100644 --- a/tldr/binwalk +++ b/tldr/binwalk @@ -28,6 +28,6 @@ source: https://github.com/tldr-pages/tldr.git `binwalk {{[-E|--entropy]}} {{[-J|--save]}} {{path/to/binary}}` -- Combine entropy, signature and opcodes analysis in a single command: +- Combine entropy, signature, and opcodes analysis in a single command: `binwalk {{[-E|--entropy]}} {{[-B|--signature]}} {{[-A|--opcodes]}} {{path/to/binary}}` diff --git a/tldr/black b/tldr/black index 13a95ac1..62e6e8c7 100644 --- a/tldr/black +++ b/tldr/black @@ -6,6 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # black > Format Python code automatically. +> See also: `ruff`. > More information: . - Auto-format a file or entire directory: diff --git a/tldr/blackfire b/tldr/blackfire index 8bb662c1..931dc0ef 100644 --- a/tldr/blackfire +++ b/tldr/blackfire @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # blackfire -> Monitor, profile and test a PHP application. +> Monitor, profile, and test a PHP application. > More information: . - Initialize and configure the Blackfire client: diff --git a/tldr/bpytop b/tldr/bpytop index 58b13806..f7f514fd 100644 --- a/tldr/bpytop +++ b/tldr/bpytop @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # bpytop -> A resource monitor that shows information about the CPU, memory, disks, network and processes. +> A resource monitor that shows information about the CPU, memory, disks, network, and processes. > A Python version of `bashtop`. > More information: . diff --git a/tldr/break b/tldr/break index 9f2bda5c..9b837e61 100644 --- a/tldr/break +++ b/tldr/break @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # break -> Break out of a `for`, `while`, `until` or `select` loop. +> Break out of a `for`, `while`, `until`, or `select` loop. > More information: . - Break out of a single loop: diff --git a/tldr/buzzphrase b/tldr/buzzphrase index 3cb8c9eb..5042b43e 100644 --- a/tldr/buzzphrase +++ b/tldr/buzzphrase @@ -8,7 +8,7 @@ source: https://github.com/tldr-pages/tldr.git > Output a random buzzphrase. Written in Node.js. > More information: . -- Generate a string of three random phrases containing an adjective, a past tense verb and a plural noun: +- Generate a string of three random phrases containing an adjective, a past tense verb, and a plural noun: `buzzphrase` diff --git a/tldr/bzegrep b/tldr/bzegrep index 765ea492..f059b97b 100644 --- a/tldr/bzegrep +++ b/tldr/bzegrep @@ -5,29 +5,8 @@ source: https://github.com/tldr-pages/tldr.git --- # bzegrep -> Find extended `regex` patterns in `bzip2` compressed files using `egrep`. -> More information: . +> This command is an alias of `bzgrep --extended-regexp`. -- Search for extended `regex` (supporting `?`, `+`, `{}`, `()` and `|`) in a compressed file (case-sensitive): +- View documentation for the original command: -`bzegrep "{{search_pattern}}" {{path/to/file}}` - -- Search for extended `regex` (supporting `?`, `+`, `{}`, `()` and `|`) in a compressed file (case-insensitive): - -`bzegrep {{[-i|--ignore-case]}} "{{search_pattern}}" {{path/to/file}}` - -- Search for lines that do not match a pattern: - -`bzegrep {{[-v|--invert-match]}} "{{search_pattern}}" {{path/to/file}}` - -- Print file name and line number for each match: - -`bzegrep {{[-H|--with-filename]}} {{[-n|--line-number]}} "{{search_pattern}}" {{path/to/file}}` - -- Search for lines matching a pattern, printing only the matched text: - -`bzegrep {{[-o|--only-matching]}} "{{search_pattern}}" {{path/to/file}}` - -- Recursively search files in a bzip2 compressed tar archive for a pattern: - -`bzegrep {{[-r|--recursive]}} "{{search_pattern}}" {{path/to/file}}` +`tldr bzgrep` diff --git a/tldr/bzfgrep b/tldr/bzfgrep index 26808400..16df72a4 100644 --- a/tldr/bzfgrep +++ b/tldr/bzfgrep @@ -5,29 +5,8 @@ source: https://github.com/tldr-pages/tldr.git --- # bzfgrep -> Find any fixed strings separated by new lines in `bzip2` compressed files using `fgrep`. -> More information: . +> This command is an alias of `bzgrep --fixed-strings`. -- Search for lines matching the list of search strings separated by new lines in a compressed file (case-sensitive): +- View documentation for the original command: -`bzfgrep "{{search_string}}" {{path/to/file}}` - -- Search for lines matching the list of search strings separated by new lines in a compressed file (case-insensitive): - -`bzfgrep {{[-i|--ignore-case]}} "{{search_string}}" {{path/to/file}}` - -- Search for lines that do not match the list of search strings separated by new lines in a compressed file: - -`bzfgrep {{[-v|--invert-match]}} "{{search_string}}" {{path/to/file}}` - -- Print file name and line number for each match: - -`bzfgrep {{[-H|--with-filename]}} {{[-n|--line-number]}} "{{search_string}}" {{path/to/file}}` - -- Search for lines matching a pattern, printing only the matched text: - -`bzfgrep {{[-o|--only-matching]}} "{{search_string}}" {{path/to/file}}` - -- Recursively search files in a bzip2 compressed tar archive for the given list of strings: - -`bzfgrep {{[-r|--recursive]}} "{{search_string}}" {{path/to/file}}` +`tldr bzgrep` diff --git a/tldr/caller b/tldr/caller index af2e7d0a..acaab2d4 100644 --- a/tldr/caller +++ b/tldr/caller @@ -12,10 +12,10 @@ source: https://github.com/tldr-pages/tldr.git `caller` -- Print the line, function and filename where the current function was called: +- Print the line, function, and filename where the current function was called: `caller 0` -- Print the line, the function name and the filename of a function call `n` frames back: +- Print the line, the function name, and the filename of a function call `n` frames back: `caller {{n}}` diff --git a/tldr/chroma b/tldr/chroma index 8797c660..7f02a1b2 100644 --- a/tldr/chroma +++ b/tldr/chroma @@ -21,6 +21,6 @@ source: https://github.com/tldr-pages/tldr.git `{{command}} | chroma {{[-l|--lexer]}} {{c++}} {{[-f|--formatter]}} {{svg}} {{[-s|--style]}} {{monokai}} > {{path/to/target_file.svg}}` -- List available lexers, styles and formatters: +- List available lexers, styles, and formatters: `chroma --list` diff --git a/tldr/clang-tidy b/tldr/clang-tidy index 88784a07..bf3b113c 100644 --- a/tldr/clang-tidy +++ b/tldr/clang-tidy @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # clang-tidy -> An LLVM-based C/C++ linter to find style violations, bugs and security flaws through static analysis. +> An LLVM-based C/C++ linter to find style violations, bugs, and security flaws through static analysis. > More information: . - Run default checks on a source file: diff --git a/tldr/codespell b/tldr/codespell index 09b93497..571d2c50 100644 --- a/tldr/codespell +++ b/tldr/codespell @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # codespell > Spellchecker for source code. -> More information: . +> More information: . - Check for typos in all text files in the current directory, recursively: @@ -14,28 +14,28 @@ source: https://github.com/tldr-pages/tldr.git - Correct all typos found in-place: -`codespell --write-changes` +`codespell {{[-w|--write-changes]}}` - Skip files with names that match the specified pattern (accepts a comma-separated list of patterns using wildcards): -`codespell --skip "{{pattern}}"` +`codespell {{[-S|--skip]}} "{{pattern}}"` - Use a custom dictionary file when checking (`--dictionary` can be used multiple times): -`codespell --dictionary {{path/to/file.txt}}` +`codespell {{[-D|--dictionary]}} {{path/to/file.txt}}` - Do not check words that are listed in the specified file: -`codespell --ignore-words {{path/to/file.txt}}` +`codespell {{[-I|--ignore-words]}} {{path/to/file.txt}}` - Do not check the specified words: -`codespell --ignore-words-list {{ignored_word1,ignored_word2,...}}` +`codespell {{[-L|--ignore-words-list]}} {{ignored_word1,ignored_word2,...}}` -- Print 3 lines of context around, before or after each match: +- Print 3 lines of [C]ontext around, [B]efore, or [A]fter each match: -`codespell --{{context|before-context|after-context}} {{3}}` +`codespell --{{context|before-context|after-context}} 3` - Check file names for typos, in addition to file contents: -`codespell --check-filenames` +`codespell {{[-f|--check-filenames]}}` diff --git a/tldr/command b/tldr/command index 322b1734..0d8b6b0e 100644 --- a/tldr/command +++ b/tldr/command @@ -10,7 +10,7 @@ source: https://github.com/tldr-pages/tldr.git - Execute the `ls` program literally, even if an `ls` alias exists: -`command {{ls}}` +`command ls` - Find and execute a command using a default `$PATH` (`/bin:/usr/bin:/sbin:/usr/sbin:/etc:/usr/etc`) that guarantees to find all standard utilities: diff --git a/tldr/cosign b/tldr/cosign index 43af729a..baaf3d77 100644 --- a/tldr/cosign +++ b/tldr/cosign @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # cosign -> Container Signing, Verification and Storage in an OCI registry. +> Container Signing, Verification, and Storage in an OCI registry. > More information: . - Generate a key-pair: diff --git a/tldr/crane-registry b/tldr/crane-registry index 21fba5a2..85b75f84 100644 --- a/tldr/crane-registry +++ b/tldr/crane-registry @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # crane registry -> This command serves a registry implementation on an automatically chosen port (`:0`), `$PORT` or `--address`. +> This command serves a registry implementation on an automatically chosen port (`:0`), `$PORT`, or `--address`. > The command blocks while the server accepts pushes and pulls and contents are can be stored in memory, and disk. > More information: . diff --git a/tldr/dfc b/tldr/dfc index ddee8336..d672d891 100644 --- a/tldr/dfc +++ b/tldr/dfc @@ -12,7 +12,7 @@ source: https://github.com/tldr-pages/tldr.git `dfc` -- Display all filesystems including pseudo, duplicate and inaccessible filesystems: +- Display all filesystems including pseudo, duplicate, and inaccessible filesystems: `dfc -a` diff --git a/tldr/djxl b/tldr/djxl index bc901601..21ab0303 100644 --- a/tldr/djxl +++ b/tldr/djxl @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # djxl > Decompress JPEG XL images. -> Accepted output extensions are PNG, APNG, JPEG, EXR, PGM, PPM, PNM, PFM, PAM, EXIF, XMP and JUMBF. +> Accepted output extensions are PNG, APNG, JPEG, EXR, PGM, PPM, PNM, PFM, PAM, EXIF, XMP, and JUMBF. > More information: . - Decompress a JPEG XL image to another format: diff --git a/tldr/docker-image b/tldr/docker-image index cba5f846..3e405950 100644 --- a/tldr/docker-image +++ b/tldr/docker-image @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # docker image > Manage Docker images. -> See also: `docker build`, `docker import`, `docker pull`. +> See also: `docker build`, `docker pull`, `docker image rm`. > More information: . - List local Docker images: @@ -24,7 +24,3 @@ source: https://github.com/tldr-pages/tldr.git - Show the history of a local Docker image: `docker image history {{image}}` - -- View documentation for `docker image rm`: - -`tldr docker rmi` diff --git a/tldr/docker-image-ls b/tldr/docker-image-ls new file mode 100644 index 00000000..1dbfc2a6 --- /dev/null +++ b/tldr/docker-image-ls @@ -0,0 +1,33 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# docker image ls + +> Manage Docker images. +> More information: . + +- List all Docker images: + +`docker image ls` + +- List all Docker images including intermediates: + +`docker image ls {{[-a|--all]}}` + +- List the output in quiet mode (only numeric IDs): + +`docker image ls {{[-q|--quiet]}}` + +- List all Docker images not used by any container: + +`docker image ls {{[-f|--filter]}} dangling=true` + +- List images that contain a substring in their name: + +`docker image ls "{{*name*}}"` + +- Sort images by size: + +`docker image ls --format "\{\{.ID\}\} \{\{.Size\}\} \{\{.Repository\}\}:\{\{.Tag\}\}" | sort {{[-k|--key]}} 2 {{[-h|--human-numeric-sort]}}` diff --git a/tldr/docker-image-rm b/tldr/docker-image-rm new file mode 100644 index 00000000..545e8c71 --- /dev/null +++ b/tldr/docker-image-rm @@ -0,0 +1,25 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# docker image rm + +> Remove Docker images. +> More information: . + +- Remove one or more images given their names: + +`docker image rm {{image1 image2 ...}}` + +- Force remove an image: + +`docker image rm {{[-f|--force]}} {{image}}` + +- Remove an image without deleting untagged parents: + +`docker image rm --no-prune {{image}}` + +- Display help: + +`docker image rm` diff --git a/tldr/docker-images b/tldr/docker-images index 9d8f0104..fdb0f411 100644 --- a/tldr/docker-images +++ b/tldr/docker-images @@ -5,29 +5,8 @@ source: https://github.com/tldr-pages/tldr.git --- # docker images -> Manage Docker images. -> More information: . +> This command is an alias of `docker image ls`. -- List all Docker images: +- View documentation for the original command: -`docker images` - -- List all Docker images including intermediates: - -`docker images {{[-a|--all]}}` - -- List the output in quiet mode (only numeric IDs): - -`docker images {{[-q|--quiet]}}` - -- List all Docker images not used by any container: - -`docker images {{[-f|--filter]}} dangling=true` - -- List images that contain a substring in their name: - -`docker images "{{*name*}}"` - -- Sort images by size: - -`docker images --format "\{\{.ID\}\} \{\{.Size\}\} \{\{.Repository\}\}:\{\{.Tag\}\}" | sort {{[-k|--key]}} 2 {{[-h|--human-numeric-sort]}}` +`tldr docker image ls` diff --git a/tldr/docker-rmi b/tldr/docker-rmi index dd18a38a..c763c741 100644 --- a/tldr/docker-rmi +++ b/tldr/docker-rmi @@ -5,21 +5,8 @@ source: https://github.com/tldr-pages/tldr.git --- # docker rmi -> Remove Docker images. -> More information: . +> This command is an alias of `docker image rm`. -- Remove one or more images given their names: +- View documentation for the original command: -`docker rmi {{image1 image2 ...}}` - -- Force remove an image: - -`docker rmi {{[-f|--force]}} {{image}}` - -- Remove an image without deleting untagged parents: - -`docker rmi --no-prune {{image}}` - -- Display help: - -`docker rmi` +`tldr docker image rm` diff --git a/tldr/docker-start b/tldr/docker-start index dbe38b03..5bf03774 100644 --- a/tldr/docker-start +++ b/tldr/docker-start @@ -12,7 +12,7 @@ source: https://github.com/tldr-pages/tldr.git `docker start {{container}}` -- Start a container, attaching `stdout` and `stderr` and forwarding signals: +- Start a container, attaching `stdout` and `stderr`, and forwarding signals: `docker start {{[-a|--attach]}} {{container}}` diff --git a/tldr/duf b/tldr/duf index 50f6d93f..c23ee607 100644 --- a/tldr/duf +++ b/tldr/duf @@ -12,7 +12,7 @@ source: https://github.com/tldr-pages/tldr.git `duf` -- List everything (such as pseudo, duplicate or inaccessible file systems): +- List everything (such as pseudo, duplicate, or inaccessible file systems): `duf --all` diff --git a/tldr/dvc-freeze b/tldr/dvc-freeze index 9fcebeda..3648f148 100644 --- a/tldr/dvc-freeze +++ b/tldr/dvc-freeze @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Freeze stages in the DVC pipeline. > This prevents DVC from tracking changes in stage dependencies and re-execution until unfreeze. -> See also: `dvs unfreeze`. +> See also: `dvc unfreeze`. > More information: . - Freeze one or more specified stages: diff --git a/tldr/egrep b/tldr/egrep index b3d75440..2ef61261 100644 --- a/tldr/egrep +++ b/tldr/egrep @@ -5,29 +5,8 @@ source: https://github.com/tldr-pages/tldr.git --- # egrep -> Find patterns in files using extended `regex` (supports `?`, `+`, `{}`, `()`, and `|`). -> More information: . +> This command is an alias of `grep --extended-regexp`. -- Search for a pattern within a file: +- View documentation for the original command: -`egrep "{{search_pattern}}" {{path/to/file}}` - -- Search for a pattern within multiple files: - -`egrep "{{search_pattern}}" {{path/to/file1 path/to/file2 ...}}` - -- Search `stdin` for a pattern: - -`cat {{path/to/file}} | egrep {{search_pattern}}` - -- Print file name and line number for each match: - -`egrep {{[-H|--with-filename]}} {{[-n|--line-number]}} "{{search_pattern}}" {{path/to/file}}` - -- Search for a pattern in all files recursively in a directory, ignoring binary files: - -`egrep {{[-r|--recursive]}} --binary-files={{without-match}} "{{search_pattern}}" {{path/to/directory}}` - -- Search for lines that do not match a pattern: - -`egrep {{[-v|--invert-match]}} "{{search_pattern}}" {{path/to/file}}` +`tldr grep` diff --git a/tldr/fgrep b/tldr/fgrep index 920e3557..6c99490c 100644 --- a/tldr/fgrep +++ b/tldr/fgrep @@ -5,30 +5,8 @@ source: https://github.com/tldr-pages/tldr.git --- # fgrep -> Matches fixed strings in files. -> Equivalent to `grep -F`. -> More information: . +> This command is an alias of `grep --fixed-strings`. -- Search for an exact string in a file: +- View documentation for the original command: -`fgrep {{search_string}} {{path/to/file}}` - -- Search only lines that match entirely in one or more files: - -`fgrep {{[-x|--line-regexp]}} {{search_string}} {{path/to/file1 path/to/file2 ...}}` - -- Count the number of lines that match the given string in a file: - -`fgrep {{[-c|--count]}} {{search_string}} {{path/to/file}}` - -- Show the line number in the file along with the line matched: - -`fgrep {{[-n|--line-number]}} {{search_string}} {{path/to/file}}` - -- Display all lines except those that contain the search string: - -`fgrep {{[-v|--invert-match]}} {{search_string}} {{path/to/file}}` - -- Display filenames whose content matches the search string at least once: - -`fgrep {{[-l|--files-with-matches]}} {{search_string}} {{path/to/file1 path/to/file2 ...}}` +`tldr grep` diff --git a/tldr/fossil-init b/tldr/fossil-init index 403ef73f..23e8c151 100644 --- a/tldr/fossil-init +++ b/tldr/fossil-init @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # fossil init > Initialize a new repository for a project. -> See also: `fossil clone`. > More information: . - Create a new repository in a named file: diff --git a/tldr/grep b/tldr/grep index 63e62229..580b9919 100644 --- a/tldr/grep +++ b/tldr/grep @@ -24,7 +24,7 @@ source: https://github.com/tldr-pages/tldr.git `grep {{[-Ei|--extended-regexp --ignore-case]}} "{{search_pattern}}" {{path/to/file}}` -- Print 3 lines of [C]ontext around, [B]efore or [A]fter each match: +- Print 3 lines of [C]ontext around, [B]efore, or [A]fter each match: `grep {{--context|--before-context|--after-context}} 3 "{{search_pattern}}" {{path/to/file}}` diff --git a/tldr/id b/tldr/id index ee2b807b..02e94b7c 100644 --- a/tldr/id +++ b/tldr/id @@ -8,7 +8,7 @@ source: https://github.com/tldr-pages/tldr.git > Display current user and group identity. > More information: . -- Display current user's ID (UID), group ID (GID) and groups to which they belong: +- Display current user's ID (UID), group ID (GID), and groups to which they belong: `id` @@ -32,7 +32,7 @@ source: https://github.com/tldr-pages/tldr.git `id {{[-Gn|--groups --name]}}` -- Display an arbitrary user's ID (UID), group ID (GID) and groups to which they belong: +- Display an arbitrary user's ID (UID), group ID (GID), and groups to which they belong: `id {{username}}` diff --git a/tldr/imapsync b/tldr/imapsync index 51bc75b1..cb5ddb8b 100644 --- a/tldr/imapsync +++ b/tldr/imapsync @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # imapsync -> Email IMAP tool for syncing, copying and migrating email mailboxes between two IMAP servers, one way, and without duplicates. +> Email IMAP tool for syncing, copying, and migrating email mailboxes between two IMAP servers, one way, and without duplicates. > More information: . - Synchronize IMAP account between host1 and host2: diff --git a/tldr/ipfs b/tldr/ipfs index c791e7d8..f268a0fa 100644 --- a/tldr/ipfs +++ b/tldr/ipfs @@ -9,7 +9,7 @@ source: https://github.com/tldr-pages/tldr.git > A peer-to-peer hypermedia protocol. Aims to make the web more open. > More information: . -- Add a file from local to the filesystem, pin it and print the relative hash: +- Add a file from local to the filesystem, pin it, and print the relative hash: `ipfs add {{path/to/file}}` diff --git a/tldr/ippeveprinter b/tldr/ippeveprinter index dcabbe2c..053af9db 100644 --- a/tldr/ippeveprinter +++ b/tldr/ippeveprinter @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # ippeveprinter > A simple IPP Everywhere printer server. -> See also: `ippeveps`, `ippevepcl`. +> See also: `ippeveps`. > More information: . - Run the server with a specific service name: diff --git a/tldr/ippeveps b/tldr/ippeveps index 7dd581bc..3ada565e 100644 --- a/tldr/ippeveps +++ b/tldr/ippeveps @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Print to Adobe PostScript printers. > Supports PDF, PostScript, JPEG, PWG Raster or Apple Raster files. -> See also: `ippevepcl`, `ippeveprinter`. +> See also: `ippeveprinter`. > More information: . - Print a file to `stdout` (status and progress messages are sent to `stderr`): diff --git a/tldr/jira-browse b/tldr/jira-browse new file mode 100644 index 00000000..2df8cd15 --- /dev/null +++ b/tldr/jira-browse @@ -0,0 +1,12 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# jira browse + +> This command is an alias of `jira open`. + +- View documentation for the original command: + +`tldr jira open` diff --git a/tldr/jira-navigate b/tldr/jira-navigate new file mode 100644 index 00000000..9fc4161e --- /dev/null +++ b/tldr/jira-navigate @@ -0,0 +1,12 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# jira navigate + +> This command is an alias of `jira open`. + +- View documentation for the original command: + +`tldr jira open` diff --git a/tldr/jira-open b/tldr/jira-open new file mode 100644 index 00000000..7c5bba40 --- /dev/null +++ b/tldr/jira-open @@ -0,0 +1,25 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# jira open + +> Open a Jira issue or project in the browser. +> More information: . + +- Open the Jira project in the browser and print the URL: + +`jira open` + +- Open a specific issue in the browser and print the URL: + +`jira open {{issue_id}}` + +- Print the URL without opening in the browser: + +`jira open {{issue_id}} {{[-n|--no-browser]}}` + +- Display help: + +`jira open {{[-h|--help]}}` diff --git a/tldr/jira-project b/tldr/jira-project new file mode 100644 index 00000000..9d5bd8ee --- /dev/null +++ b/tldr/jira-project @@ -0,0 +1,17 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# jira project + +> Manage Jira projects. +> More information: . + +- List all projects: + +`jira project {{[ls|list]}}` + +- Display help: + +`jira project {{[-h|--help]}}` diff --git a/tldr/jira-projects b/tldr/jira-projects new file mode 100644 index 00000000..d20dee72 --- /dev/null +++ b/tldr/jira-projects @@ -0,0 +1,12 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# jira projects + +> This command is an alias of `jira project`. + +- View documentation for the original command: + +`tldr jira project` diff --git a/tldr/kops b/tldr/kops index 63d2a7c7..1598e75b 100644 --- a/tldr/kops +++ b/tldr/kops @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # kops -> Create, destroy, upgrade and maintain Kubernetes clusters. +> Create, destroy, upgrade, and maintain Kubernetes clusters. > More information: . - Create a cluster from the configuration specification: diff --git a/tldr/linux/gs b/tldr/linux/gs index 02103101..6a92c339 100644 --- a/tldr/linux/gs +++ b/tldr/linux/gs @@ -18,7 +18,7 @@ source: https://github.com/tldr-pages/tldr.git - Convert PDF file (pages 1 through 3) to an image with 150 dpi resolution: -`gs -dQUIET -dBATCH -dNOPAUSE -sDEVICE=jpeg -r150 -dFirstPage={{1}} -dLastPage={{3}} -sOutputFile={{output_%d.jpg}} {{input.pdf}}` +`gs -dQUIET -dBATCH -dNOPAUSE -sDEVICE=jpeg -r150 -dFirstPage=1 -dLastPage=3 -sOutputFile={{output_%d.jpg}} {{input.pdf}}` - Extract pages from a PDF file: diff --git a/tldr/linux/ncat b/tldr/linux/ncat index 6fa0c255..d2d54149 100644 --- a/tldr/linux/ncat +++ b/tldr/linux/ncat @@ -19,7 +19,7 @@ source: https://github.com/tldr-pages/tldr.git - Write output of specified file to the specified host on the specified port: -`ncat {{address}} {{port}} < {{path/to/file}}` +`ncat < {{path/to/file}} {{address}} {{port}}` - Accept multiple incoming connections on an encrypted channel evading detection of traffic content: diff --git a/tldr/linux/pkgstats b/tldr/linux/pkgstats new file mode 100644 index 00000000..be316504 --- /dev/null +++ b/tldr/linux/pkgstats @@ -0,0 +1,33 @@ +--- +syntax: markdown +tags: [tldr, linux] +source: https://github.com/tldr-pages/tldr.git +--- +# pkgstats + +> Submit and view Arch Linux package popularity statistics. +> More information: . + +- Send installed package data: + +`pkgstats submit` + +- View the sent data: + +`pkgstats submit {{[-d|--dump-json]}}` + +- Search for packages: + +`pkgstats search {{search_term}}` + +- Limit search result count (10 by default): + +`pkgstats search {{search_term}} {{[-l|--limit]}} {{count}}` + +- Pick packages for comparison: + +`pkgstats show {{package1 package2 ...}}` + +- Display help: + +`pkgstats {{[-h|--help]}}` diff --git a/tldr/linux/postfix b/tldr/linux/postfix index a2a2612c..40925f3f 100644 --- a/tldr/linux/postfix +++ b/tldr/linux/postfix @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # postfix > Postfix mail transfer agent (MTA) control program. -> See also: `dovecot`, a mail delivery agent (MDA) that integrates with Postfix. > More information: . - Check the configuration: diff --git a/tldr/linux/sesearch b/tldr/linux/sesearch index a8afbb7d..9963c0ac 100644 --- a/tldr/linux/sesearch +++ b/tldr/linux/sesearch @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Search SELinux policy rules. > Part of the `setools` package. -> See also: `seinfo`, `semodule`. +> See also: `semodule`. > More information: . - Search for all allow rules: diff --git a/tldr/linux/swww b/tldr/linux/swww index 43e34945..98f5ca15 100644 --- a/tldr/linux/swww +++ b/tldr/linux/swww @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # swww > Efficient animated wallpaper daemon for Wayland. -> See also: `swww-daemon`. > More information: . - Set wallpaper: diff --git a/tldr/linux/systemctl-import-environment b/tldr/linux/systemctl-import-environment index 3a500fa9..14eba42e 100644 --- a/tldr/linux/systemctl-import-environment +++ b/tldr/linux/systemctl-import-environment @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # systemctl import-environment > Import environment variables from the shell into systemd's environment. -> See also: `show-environment`, `unset-environment`. +> See also: `systemctl show-environment`, `systemctl unset-environment`. > More information: . - Import a variable: diff --git a/tldr/linux/urpmi b/tldr/linux/urpmi index ab596deb..cb586f3a 100644 --- a/tldr/linux/urpmi +++ b/tldr/linux/urpmi @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # urpmi > Install packages in Mageia. -> See also: `urpm.update`, `urpme`, `urpmi.addmedia`, `urpmi.removemedia`, `urpmf`, `urpmq`. +> See also: `urpmi.update`, `urpme`, `urpmi.addmedia`, `urpmi.removemedia`, `urpmf`, `urpmq`. > More information: . - Install a package from the repository or from a local RPM file: diff --git a/tldr/lwp-request b/tldr/lwp-request index 9aab2c25..a22dc959 100644 --- a/tldr/lwp-request +++ b/tldr/lwp-request @@ -15,7 +15,7 @@ source: https://github.com/tldr-pages/tldr.git - Upload a file with a POST request: -`lwp-request -m POST {{http://example.com/some/path}} < {{path/to/file}}` +`lwp-request < {{path/to/file}} -m POST {{http://example.com/some/path}}` - Make a request with a custom user agent: diff --git a/tldr/lzegrep b/tldr/lzegrep index dad8b784..1cd1a579 100644 --- a/tldr/lzegrep +++ b/tldr/lzegrep @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # lzegrep > This command is an alias of `xzgrep --extended-regexp`. -> See also: `egrep`. - View documentation for the original command: diff --git a/tldr/lzfgrep b/tldr/lzfgrep index f395af78..2f97cdc1 100644 --- a/tldr/lzfgrep +++ b/tldr/lzfgrep @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # lzfgrep > This command is an alias of `xzgrep --fixed-strings`. -> See also: `fgrep`. - View documentation for the original command: diff --git a/tldr/mlr b/tldr/mlr index f18cb6f9..ddac848b 100644 --- a/tldr/mlr +++ b/tldr/mlr @@ -24,7 +24,7 @@ source: https://github.com/tldr-pages/tldr.git `mlr --icsv --opprint sort -nr {{field}} {{example.csv}}` -- Convert CSV to JSON, performing calculations and display those calculations: +- Convert CSV to JSON, performing calculations, and display those calculations: `mlr --icsv --ojson put '${{newField1}} = ${{oldFieldA}}/${{oldFieldB}}' {{example.csv}}` diff --git a/tldr/neofetch b/tldr/neofetch index f31f4f98..21f9cd98 100644 --- a/tldr/neofetch +++ b/tldr/neofetch @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # neofetch -> Display information about the operating system, software and hardware. +> Display information about the operating system, software, and hardware. > Note: `neofetch` is no longer maintained. > See also: `fastfetch`. > More information: . diff --git a/tldr/pamcut b/tldr/pamcut index 6eae884f..3269db67 100644 --- a/tldr/pamcut +++ b/tldr/pamcut @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # pamcut > Cut out a rectangular region from a Netpbm image. -> See also: `pamcrop`, `pamdice`, `pamcomp`. +> See also: `pamdice`, `pamcomp`. > More information: . - Discard the specified number of columns/rows on each side of the image: diff --git a/tldr/pastel b/tldr/pastel index 42366bfd..899ee2a7 100644 --- a/tldr/pastel +++ b/tldr/pastel @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # pastel -> Generate, analyze, convert and manipulate colors. +> Generate, analyze, convert, and manipulate colors. > More information: . - Convert colors from one format to another. Here from RGB to HSL: diff --git a/tldr/pio-update b/tldr/pio-update index 97dcec17..884a4a31 100644 --- a/tldr/pio-update +++ b/tldr/pio-update @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # pio update > Update installed PlatformIO Core packages, development platforms, and global libraries. -> See also: `pio platform update`, `pio lib update`. > More information: . - Perform a full update of all packages, development platforms, and global libraries: diff --git a/tldr/pm2 b/tldr/pm2 index 2f42cae1..546782a3 100644 --- a/tldr/pm2 +++ b/tldr/pm2 @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # pm2 > Process manager for Node.js. -> Used for log management, monitoring and configuring processes. +> Used for log management, monitoring, and configuring processes. > More information: . - Start a process with a name that can be used for later operations: diff --git a/tldr/pnmmercator b/tldr/pnmmercator index bf9adfdf..6f91d3f2 100644 --- a/tldr/pnmmercator +++ b/tldr/pnmmercator @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # pnmmercator > Perform Mercator transformations on Netpbm images. -> See also: `pnmglobe`. > More information: . - Convert a rectangular projection worldmap to Mercator projection: diff --git a/tldr/podman b/tldr/podman index 11350ced..c43782e4 100644 --- a/tldr/podman +++ b/tldr/podman @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # podman -> Simple management tool for pods, containers and images. +> Simple management tool for pods, containers, and images. > Podman provides a Docker-CLI comparable command-line. Simply put: `alias docker=podman`. > More information: . diff --git a/tldr/podman-ps b/tldr/podman-ps index 4975f65f..d2ea0131 100644 --- a/tldr/podman-ps +++ b/tldr/podman-ps @@ -32,9 +32,9 @@ source: https://github.com/tldr-pages/tldr.git `podman ps {{[-a|--all]}} {{[-f|--filter]}} "exited={{code}}"` -- Filter containers by status (created, running, removing, paused, exited and dead): +- Filter containers by status: -`podman ps {{[-f|--filter]}} "status={{status}}"` +`podman ps {{[-f|--filter]}} "status={{created|running|removing|paused|exited|dead}}"` - Filter containers that mount a specific volume or have a volume mounted in a specific path: diff --git a/tldr/printf b/tldr/printf index c34906e1..198e8d7f 100644 --- a/tldr/printf +++ b/tldr/printf @@ -34,7 +34,7 @@ source: https://github.com/tldr-pages/tldr.git `printf -v {{myvar}} {{"This is %s = %d " "a year" 2016}}` -- Print a hexadecimal, octal and scientific number: +- Print a hexadecimal, octal, and scientific number: `printf "{{hex=%x octal=%o scientific=%e }}" 0x{{FF}} 0{{377}} {{100000}}` diff --git a/tldr/psysh b/tldr/psysh index 6e8aa10b..be3d63d9 100644 --- a/tldr/psysh +++ b/tldr/psysh @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # psysh -> A runtime developer console, interactive debugger and REPL for PHP. +> A runtime developer console, interactive debugger, and REPL for PHP. > More information: . - Open a shell in the current directory: diff --git a/tldr/pueue-group b/tldr/pueue-group index 48b2d45b..dc45c9a5 100644 --- a/tldr/pueue-group +++ b/tldr/pueue-group @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # pueue group -> Display, add or remove groups. +> Display, add, or remove groups. > More information: . - Show all groups with their statuses and number of parallel jobs: diff --git a/tldr/pwqgen b/tldr/pwqgen index 89104636..858c9150 100644 --- a/tldr/pwqgen +++ b/tldr/pwqgen @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # pwqgen > Generate a random passphrase. -> See also: `libpasswdqc`. > More information: . - Generate a passphrase: diff --git a/tldr/rbash b/tldr/rbash index d56452ab..d8085829 100644 --- a/tldr/rbash +++ b/tldr/rbash @@ -7,6 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Restricted Bash shell, equivalent to `bash --restricted`. > Does not permit changing the working directory, redirecting command output, or modifying environment variables, among other things. +> See also: `!` and `^` for history expansion. > More information: . - Start an interactive shell session: diff --git a/tldr/read b/tldr/read index ed704359..6af35776 100644 --- a/tldr/read +++ b/tldr/read @@ -38,4 +38,4 @@ source: https://github.com/tldr-pages/tldr.git - Read `stdin` and perform an action on every line: -`while read line; do {{echo|ls|rm|...}} "$line"; done < {{/dev/stdin|path/to/file|...}}` +`cat {{/dev/stdin|path/to/file|...}} | while read line; do {{echo|ls|rm|...}} "$line"; done` diff --git a/tldr/restic b/tldr/restic index d9db417a..938e1252 100644 --- a/tldr/restic +++ b/tldr/restic @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # restic -> A fast, secure and secure backup program. +> A fast and secure backup program. > More information: . - Initialize a backup repository in the specified local directory: diff --git a/tldr/rgrep b/tldr/rgrep index 333019cd..a80e574d 100644 --- a/tldr/rgrep +++ b/tldr/rgrep @@ -5,26 +5,8 @@ source: https://github.com/tldr-pages/tldr.git --- # rgrep -> Recursively find patterns in files using `regex`. -> Equivalent to `grep -r`. -> More information: . +> This command is an alias of `grep --recursive`. -- Recursively search for a pattern in the current working directory: +- View documentation for the original command: -`rgrep "{{search_pattern}}"` - -- Recursively search for a case-insensitive pattern in the current working directory: - -`rgrep {{[-i|--ignore-case]}} "{{search_pattern}}"` - -- Recursively search for an extended `regex` pattern (supports `?`, `+`, `{}`, `()`, and `|`) in the current working directory: - -`rgrep {{[-E|--extended-regexp]}} "{{search_pattern}}"` - -- Recursively search for an exact string (disables `regex`) in the current working directory: - -`rgrep {{[-F|--fixed-strings]}} "{{exact_string}}"` - -- Recursively search for a pattern in a specified directory (or file): - -`rgrep "{{search_pattern}}" {{path/to/file_or_directory}}` +`tldr grep` diff --git a/tldr/ruff b/tldr/ruff index 7b7e4d10..be005e1f 100644 --- a/tldr/ruff +++ b/tldr/ruff @@ -6,6 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # ruff > An extremely fast Python linter and code formatter, written in Rust. +> See also: `black`. > More information: . - View documentation for the Ruff linter: diff --git a/tldr/scamper b/tldr/scamper index 8eafc2b4..83a1b666 100644 --- a/tldr/scamper +++ b/tldr/scamper @@ -17,7 +17,7 @@ source: https://github.com/tldr-pages/tldr.git `scamper -I "{{ping}} {{192.0.2.1}}" -I "{{trace}} {{192.0.2.2}}"` -- Ping several hosts with UDP, use a specific port number for the first ping and increase it for each subsequent ping: +- Ping several hosts with UDP, use a specific port number for the first ping, and increase it for each subsequent ping: `scamper -c "{{ping}} -P {{UDP-dport}} -d {{33434}}" -i {{192.0.2.1}} -i {{192.0.2.2}}` diff --git a/tldr/sh b/tldr/sh index ba750bb8..6be9ff25 100644 --- a/tldr/sh +++ b/tldr/sh @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # sh > Bourne shell, the standard command language interpreter. -> See also: `histexpand` for history expansion. +> See also: `!` and `^` for history expansion. > More information: . - Start an interactive shell session: diff --git a/tldr/shred b/tldr/shred index 26864288..854a2837 100644 --- a/tldr/shred +++ b/tldr/shred @@ -28,6 +28,6 @@ source: https://github.com/tldr-pages/tldr.git `shred {{[-u|--remove]}} {{path/to/file}}` -- Overwrite a file 100 times, add a final overwrite with zeros, remove the file after overwriting it and show verbose progress on the screen: +- Overwrite a file 100 times, add a final overwrite with zeros, remove the file after overwriting it, and show verbose progress on the screen: `shred {{[-vzu|--verbose --zero --remove]}} {{[-n|--iterations]}} 100 {{path/to/file}}` diff --git a/tldr/tee b/tldr/tee index 6cd175a3..53402680 100644 --- a/tldr/tee +++ b/tldr/tee @@ -20,6 +20,6 @@ source: https://github.com/tldr-pages/tldr.git `echo "example" | tee {{/dev/tty}} | {{xargs printf "[%s]"}}` -- Create a directory called "example", count the number of characters in "example" and write "example" to the terminal: +- Create a directory called "example", count the number of characters in "example", and write "example" to the terminal: `echo "example" | tee >(xargs mkdir) >(wc {{[-c|--bytes]}})` diff --git a/tldr/tidy b/tldr/tidy index ab52fb4d..dd965050 100644 --- a/tldr/tidy +++ b/tldr/tidy @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # tidy -> Clean up and pretty print HTML, XHTML and XML files. +> Clean up and pretty print HTML, XHTML, and XML files. > Note: `tidy` cannot preserve original indentation. > More information: . diff --git a/tldr/tlmgr b/tldr/tlmgr index 36b20b06..58e6a614 100644 --- a/tldr/tlmgr +++ b/tldr/tlmgr @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Manage packages and configuration options of an existing TeX Live installation. > Some subcommands such as `paper` have their own usage documentation. -> More information: . +> More information: . - Install a package and its dependencies: diff --git a/tldr/tlmgr-platform b/tldr/tlmgr-platform index 30242e19..c529afb7 100644 --- a/tldr/tlmgr-platform +++ b/tldr/tlmgr-platform @@ -10,20 +10,20 @@ source: https://github.com/tldr-pages/tldr.git - List all available platforms in the package repository: -`tlmgr platform list` +`tlmgr {{[arch|platform]}} list` - Add the executables for a specific platform: -`sudo tlmgr platform add {{platform}}` +`sudo tlmgr {{[arch|platform]}} add {{platform}}` - Remove the executables for a specific platform: -`sudo tlmgr platform remove {{platform}}` +`sudo tlmgr {{[arch|platform]}} remove {{platform}}` - Auto-detect and switch to the current platform: -`sudo tlmgr platform set auto` +`sudo tlmgr {{[arch|platform]}} set auto` - Switch to a specific platform: -`sudo tlmgr platform set {{platform}}` +`sudo tlmgr {{[arch|platform]}} set {{platform}}` diff --git a/tldr/uncrustify b/tldr/uncrustify index cc26e923..c558acda 100644 --- a/tldr/uncrustify +++ b/tldr/uncrustify @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # uncrustify -> C, C++, C#, D, Java and Pawn source code formatter. +> C, C++, C#, D, Java, and Pawn source code formatter. > More information: . - Format a single file: diff --git a/tldr/uptime b/tldr/uptime index 2dddb81d..0d49b463 100644 --- a/tldr/uptime +++ b/tldr/uptime @@ -8,7 +8,7 @@ source: https://github.com/tldr-pages/tldr.git > Tell how long the system has been running and other information. > More information: . -- Print current time, uptime, number of logged-in users and other information: +- Print current time, uptime, number of logged-in users, and other information: `uptime` diff --git a/tldr/usleep b/tldr/usleep index 0d0bb7f3..79fe0fab 100644 --- a/tldr/usleep +++ b/tldr/usleep @@ -7,7 +7,7 @@ source: https://github.com/tldr-pages/tldr.git > Delay execution for a specific interval in microseconds. > Largely deprecated in favor of `nanosleep`. -> See also: `sleep`, `nanosleep`. +> See also: `sleep`. > More information: . - Delay in microseconds: diff --git a/tldr/w b/tldr/w index d03fce44..58de8bb6 100644 --- a/tldr/w +++ b/tldr/w @@ -21,6 +21,6 @@ source: https://github.com/tldr-pages/tldr.git `w {{[-h|--no-header]}}` -- Display information without including the login, JCPU and PCPU columns: +- Display information without including the login, JCPU, and PCPU columns: `w {{[-s|--short]}}` diff --git a/tldr/whence b/tldr/whence index 2983916d..3911868c 100644 --- a/tldr/whence +++ b/tldr/whence @@ -12,7 +12,7 @@ source: https://github.com/tldr-pages/tldr.git `whence "{{command}}"` -- Display type of `command`, with location if defined as a function, or binary (equivalent to the `type` and `command -V` builtins): +- Display type of `command`, with location if defined as a function or binary (equivalent to the `type` and `command -V` builtins): `whence -v "{{command}}"` @@ -24,6 +24,6 @@ source: https://github.com/tldr-pages/tldr.git `whence -ca "{{command}}"` -- Search only the `$PATH` for `command`, ignoring builtins, aliases or shell functions (equivalent to the `where` command): +- Search only the `$PATH` for `command`, ignoring builtins, aliases, or shell functions (equivalent to the `where` command): `whence -p "{{command}}"` diff --git a/tldr/windows/powershell b/tldr/windows/powershell index 93fe0df8..aacdb013 100644 --- a/tldr/windows/powershell +++ b/tldr/windows/powershell @@ -6,7 +6,8 @@ source: https://github.com/tldr-pages/tldr.git # powershell > Command-line shell and scripting language designed especially for system administration. -> This command refers to PowerShell version 5.1 and below (also known as the legacy Windows PowerShell). To use the newer, cross-platform version of PowerShell (also known as PowerShell Core), use `pwsh` instead of `powershell`. +> This command refers to PowerShell version 5.1 and below (also known as the legacy Windows PowerShell). +> To use the newer, cross-platform version of PowerShell (also known as PowerShell Core), use `pwsh` instead of `powershell`. > More information: . - Start an interactive shell session: diff --git a/tldr/wlc b/tldr/wlc index d22c801c..93ae6d9c 100644 --- a/tldr/wlc +++ b/tldr/wlc @@ -12,7 +12,7 @@ source: https://github.com/tldr-pages/tldr.git `wlc {{[-c|--config]}} {{path/to/file}} list-projects` -- List components in a project, and override API URL and API key: +- List components in a project and override API URL and API key: `wlc {{[-u|--url]}} {{URL}} {{[-k|--key]}} {{key}} ls {{project}}` diff --git a/tldr/xzegrep b/tldr/xzegrep index 92cb34e1..d10e352c 100644 --- a/tldr/xzegrep +++ b/tldr/xzegrep @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # xzegrep > This command is an alias of `xzgrep --extended-regexp`. -> See also: `egrep`. - View documentation for the original command: diff --git a/tldr/xzfgrep b/tldr/xzfgrep index bb8980f7..c00bbc82 100644 --- a/tldr/xzfgrep +++ b/tldr/xzfgrep @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # xzfgrep > This command is an alias of `xzgrep --fixed-strings`. -> See also: `fgrep`. - View documentation for the original command: diff --git a/tldr/yadm-git-crypt b/tldr/yadm-git-crypt index a2de14b3..8c5357ad 100755 --- a/tldr/yadm-git-crypt +++ b/tldr/yadm-git-crypt @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # yadm git-crypt > Git Crypt enables transparent encryption and decryption of files in a git repository. -> See also: `git-crypt`. > More information: . - Initialize repo to use Git Crypt: diff --git a/tldr/ykman-openpgp b/tldr/ykman-openpgp index 13711975..1f95df99 100644 --- a/tldr/ykman-openpgp +++ b/tldr/ykman-openpgp @@ -17,7 +17,7 @@ source: https://github.com/tldr-pages/tldr.git `ykman openpgp access set-retries {{3}} {{3}} {{3}}` -- Change the User PIN, Reset Code or Admin PIN: +- Change the User PIN, Reset Code, or Admin PIN: `ykman openpgp access change-{{pin|reset-code|admin-pin}}` diff --git a/tldr/zdb b/tldr/zdb index c03dfe1a..e026fc5d 100644 --- a/tldr/zdb +++ b/tldr/zdb @@ -16,6 +16,6 @@ source: https://github.com/tldr-pages/tldr.git `zdb {{[-C|--config]}} {{poolname}}` -- Show statistics about number, size and deduplication of blocks: +- Show statistics about number, size, and deduplication of blocks: `zdb {{[-b|--block-stats]}} {{poolname}}` diff --git a/tldr/zegrep b/tldr/zegrep index 207b2338..768b9d27 100644 --- a/tldr/zegrep +++ b/tldr/zegrep @@ -5,29 +5,8 @@ source: https://github.com/tldr-pages/tldr.git --- # zegrep -> Find extended `regex` patterns in compressed files using `egrep`. -> More information: . +> This command is an alias of `zgrep --extended-regexp`. -- Search for extended `regex` (supporting `?`, `+`, `{}`, `()` and `|`) in a compressed file (case-sensitive): +- View documentation for the original command: -`zegrep "{{search_pattern}}" {{path/to/file}}` - -- Search for extended `regex` (supporting `?`, `+`, `{}`, `()` and `|`) in a compressed file (case-insensitive): - -`zegrep {{[-i|--ignore-case]}} "{{search_pattern}}" {{path/to/file}}` - -- Search for lines that do not match a pattern: - -`zegrep {{[-v|--invert-match]}} "{{search_pattern}}" {{path/to/file}}` - -- Print file name and line number for each match: - -`zegrep {{[-H|--with-filename]}} {{[-n|--line-number]}} "{{search_pattern}}" {{path/to/file}}` - -- Search for lines matching a pattern, printing only the matched text: - -`zegrep {{[-o|--only-matching]}} "{{search_pattern}}" {{path/to/file}}` - -- Recursively search files in a compressed file for a pattern: - -`zegrep {{[-r|--recursive]}} "{{search_pattern}}" {{path/to/file}}` +`tldr zgrep` diff --git a/tldr/zfgrep b/tldr/zfgrep index 72f1e8e5..058cb669 100644 --- a/tldr/zfgrep +++ b/tldr/zfgrep @@ -5,26 +5,8 @@ source: https://github.com/tldr-pages/tldr.git --- # zfgrep -> Matches fixed strings in possibly compressed files. -> Equivalent to `grep --fixed-strings` with input decompressed first if necessary. -> More information: . +> This command is an alias of `zgrep --fixed-strings`. -- Search for an exact string in a file: +- View documentation for the original command: -`zfgrep {{search_string}} {{path/to/file}}` - -- Count the number of lines that match the given string in a file: - -`zfgrep {{[-c|--count]}} {{search_string}} {{path/to/file}}` - -- Show the line number in the file along with the matching lines: - -`zfgrep {{[-n|--line-number]}} {{search_string}} {{path/to/file}}` - -- Display all lines except those that contain the search string: - -`zfgrep {{[-v|--invert-match]}} {{search_string}} {{path/to/file}}` - -- List only filenames whose content matches the search string at least once: - -`zfgrep {{[-l|--files-with-matches]}} {{search_string}} {{path/to/file1 path/to/file2 ...}}` +`tldr zgrep` diff --git a/tldr/zgrep b/tldr/zgrep index 2614c533..075ced56 100644 --- a/tldr/zgrep +++ b/tldr/zgrep @@ -5,7 +5,7 @@ source: https://github.com/tldr-pages/tldr.git --- # zgrep -> Grep text patterns from files within compressed file (equivalent to `grep -Z`). +> Grep text patterns from files within compressed files. > More information: . - Grep a pattern in a compressed file (case-sensitive): diff --git a/tldr/zmv b/tldr/zmv index 82a747f0..7659cc2b 100644 --- a/tldr/zmv +++ b/tldr/zmv @@ -6,7 +6,6 @@ source: https://github.com/tldr-pages/tldr.git # zmv > Move or rename files matching a specified extended glob pattern. -> See also: `zcp`, `zln`. > More information: . - Move files using a `regex`-like pattern: diff --git a/tldr/zsh b/tldr/zsh index 095a4d87..a55661a8 100644 --- a/tldr/zsh +++ b/tldr/zsh @@ -6,7 +6,7 @@ source: https://github.com/tldr-pages/tldr.git # zsh > Z SHell, a Bash-compatible command-line interpreter. -> See also: `bash`, `histexpand`. +> See also: `bash`, `!`, `^`. > More information: . - Start an interactive shell session: diff --git a/tldr/zstd b/tldr/zstd index 981fd15d..b4f43d16 100644 --- a/tldr/zstd +++ b/tldr/zstd @@ -20,7 +20,7 @@ source: https://github.com/tldr-pages/tldr.git `zstd {{[-d|--decompress]}} {{[-c|--stdout]}} {{path/to/file.zst}}` -- Compress a file specifying the compression level, where 1=fastest, 19=slowest and 3=default: +- Compress a file specifying the compression level, where 1=fastest, 19=slowest, and 3=default: `zstd -{{level}} {{path/to/file}}`