Updated TLDR files

fastHistory/tldr/tldr/last_tldr_commit.txt

@@ -1 +1 @@
-6a058b56fe090debff720d06196c02199ea5644c
+6a48a5a31a32d549b221242fe25ad58d8413c400

fastHistory/tldr/tldr/last_update_date.txt

@@ -1 +1 @@
-2021-05-01
+2021-12-07

fastHistory/tldr/tldr/pages/android/am.md

@@ -11,5 +11,5 @@
 - Start an activity matching a specific action and category
 `am start -a {{android.intent.action.MAIN}} -c {{android.intent.category.HOME}}`
 
-- Convert an intent to an URI
+- Convert an intent to a URI
 `am to-uri -a {{android.intent.action.VIEW}} -d {{tel:123}}`

fastHistory/tldr/tldr/pages/android/bugreport.md

@@ -0,0 +1,7 @@
+# bugreport
+> Show an Android bug report.
+> This command can only be used through `adb shell`.
+> More information: <https://cs.android.com/android/platform/superproject/+/master:frameworks/native/cmds/bugreport>.
+
+- Show a complete bug report of an Android device
+`bugreport`

fastHistory/tldr/tldr/pages/android/bugreportz.md

@@ -0,0 +1,16 @@
+# bugreportz
+> Generate a zipped Android bug report.
+> This command can only be used through `adb shell`.
+> More information: <https://cs.android.com/android/platform/superproject/+/master:frameworks/native/cmds/bugreportz>.
+
+- Generate a complete zipped bug report of an Android device
+`bugreportz`
+
+- Show the progress of a running `bugreportz` operation
+`bugreportz -p`
+
+- Show the version of `bugreportz`
+`bugreportz -v`
+
+- Display help
+`bugreportz -h`

fastHistory/tldr/tldr/pages/android/getprop.md

@@ -20,5 +20,5 @@
 - Display the OEM unlock status
 `getprop {{ro.oem_unlock_supported}}`
 
-- Display the MAC address of the Android's WiFi card
+- Display the MAC address of the Android's Wi-Fi card
 `getprop {{ro.boot.wifimacaddr}}`

fastHistory/tldr/tldr/pages/android/logcat.md

@@ -8,5 +8,5 @@
 - Write system logs to a file
 `logcat -f {{path/to/file}}`
 
-- Display lines that match a regex
-`logcat --regex {{regex}}`
+- Display lines that match a regular expression
+`logcat --regex {{regular_expression}}`

fastHistory/tldr/tldr/pages/android/pkg.md

@@ -0,0 +1,18 @@
+# pkg
+> Package management utility for Termux.
+> More information: <https://wiki.termux.com/wiki/Package_Management>.
+
+- Upgrade all installed packages
+`pkg upgrade`
+
+- Install a package
+`pkg install {{package}}`
+
+- Uninstall a package
+`pkg uninstall {{package}}`
+
+- Reinstall a package
+`pkg reinstall {{package}}`
+
+- Search for a package
+`pkg search {{package}}`

fastHistory/tldr/tldr/pages/android/wm.md

@@ -1,6 +1,7 @@
 # wm
 > Show information about the screen of an Android device.
 > This command can only be used through `adb shell`.
+> More information: <https://adbinstaller.com/commands/adb-shell-wm-5b672b17e7958178a2955538>.
 
 - Display the physical size of an Android device's screen
 `wm {{size}}`

fastHistory/tldr/tldr/pages/common/7z.md

@@ -18,7 +18,7 @@
 `7z x {{path/to/archive.7z}} -so`
 
 - archive using a specific archive type
-`7z a -t{{7z|zip|gzip|bzip2|lzip}} {{path/to/archive.7z}} {{path/to/file_or_directory}}`
+`7z a -t{{7z|bzip2|gzip|lzip|tar|zip}} {{path/to/archive.7z}} {{path/to/file_or_directory}}`
 
 - list the contents of an archive
 `7z l {{path/to/archive.7z}}`

fastHistory/tldr/tldr/pages/common/7za.md

@@ -19,7 +19,7 @@
 `7za x {{path/to/archive.7z}} -so`
 
 - archive using a specific archive type
-`7z a -t{{7z|zip|gzip|bzip2|lzip}} {{path/to/archive.7z}} {{path/to/file_or_directory}}`
+`7za a -t{{7z|bzip2|gzip|lzip|tar|zip}} {{path/to/archive.7z}} {{path/to/file_or_directory}}`
 
 - list the contents of an archive
 `7za l {{path/to/archive.7z}}`

fastHistory/tldr/tldr/pages/common/[.md

@@ -1,5 +1,5 @@
 # [
-> Evaluate condition.
+> Check file types and compare values.
 > Returns 0 if the condition evaluates to true, 1 if it evaluates to false.
 > More information: <https://www.gnu.org/software/coreutils/test>.
 

fastHistory/tldr/tldr/pages/common/ack.md

@@ -13,16 +13,16 @@
 `ack -o "{{search_pattern}}"`
 
 - Limit search to files of a specific type
-`ack --type={{ruby}} "{{search_pattern}}`
+`ack --type={{ruby}} "{{search_pattern}}"`
 
 - Do not search in files of a specific type
-`ack --type=no{{ruby}} "{{search_pattern}}`
+`ack --type=no{{ruby}} "{{search_pattern}}"`
 
 - Count the total number of matches found
 `ack --count --no-filename "{{search_pattern}}"`
 
 - Print the file names and the number of matches for each file only
 `ack --count --files-with-matches "{{search_pattern}}"`
 
-- List all values that can be used with `--type`
+- List all the values that can be used with `--type`
 `ack --help-types`

fastHistory/tldr/tldr/pages/common/acme.sh-dns.md

@@ -0,0 +1,18 @@
+# acme.sh --dns
+> Use a DNS-01 challenge to issue a TLS certificate.
+> More information: <https://github.com/acmesh-official/acme.sh/wiki>.
+
+- Issue a certificate using an automatic DNS API mode
+`acme.sh --issue --dns {{gnd_gd}} --domain {{example.com}}`
+
+- Issue a wildcard certificate (denoted by an asterisk) using an automatic DNS API mode
+`acme.sh --issue --dns {{dns_namesilo}} --domain {{example.com}} --domain {{*.example.com}}`
+
+- Issue a certificate using a DNS alias mode
+`acme.sh --issue --dns {{dns_cf}} --domain {{example.com}} --challenge-alias {{alias-for-example-validation.com}}`
+
+- Issue a certificate while disabling automatic Cloudflare / Google DNS polling after the DNS record is added by specifying a custom wait time in seconds
+`acme.sh --issue --dns {{dns_namecheap}} --domain {{example.com}} --dnssleep {{300}}`
+
+- Issue a certificate using a manual DNS mode
+`acme.sh --issue --dns --domain {{example.com}} --yes-I-know-dns-manual-mode-enough-go-ahead-please`

fastHistory/tldr/tldr/pages/common/acme.sh.md

@@ -1,12 +1,13 @@
 # acme.sh
 > Shell script implementing ACME client protocol, an alternative to certbot.
+> See also `acme.sh dns`.
 > More information: <https://github.com/acmesh-official/acme.sh>.
 
 - Issue a certificate using webroot mode
 `acme.sh --issue --domain {{example.com}} --webroot {{/path/to/webroot}}`
 
-- Issue a certificate using standalone mode using port 80
-`acme.sh --issue --standalone --domain {{example.com}}`
+- Issue a certificate for multiple domains using standalone mode using port 80
+`acme.sh --issue --standalone --domain {{example.com}} --domain {{www.example.com}}`
 
 - Issue a certificate using standalone TLS mode using port 443
 `acme.sh --issue --alpn --domain {{example.com}}`
@@ -17,11 +18,8 @@
 - Issue a certificate using a working Apache configuration
 `acme.sh --issue --apache --domain {{example.com}}`
 
-- Issue a wildcard (\*) certificate using a manual DNS mode
-`acme.sh --issue --dns --domain {{example.com}}`
-
-- Issue a certificate using an automatic DNS API mode
-`acme.sh --issue --dns {{dns_cf}} --domain {{example.com}}`
+- Issue a wildcard (\*) certificate using an automatic DNS API mode
+`acme.sh --issue --dns {{dns_cf}} --domain {{*.example.com}}`
 
 - Install certificate files into the specified locations (useful for automatic certificate renewal)
 `acme.sh --install-cert -d {{example.com}} --key-file {{/path/to/example.com.key}} --fullchain-file {{/path/to/example.com.cer}} --reloadcmd {{"systemctl force-reload nginx"}}`

fastHistory/tldr/tldr/pages/common/acyclic.md

@@ -0,0 +1,13 @@
+# acyclic
+> Make a directed graph acyclic by reversing some edges.
+> Graphviz filters: `acyclic`, `bcomps`, `comps`, `edgepaint`, `gvcolor`, `gvpack`, `mingle`, `nop`, `sccmap`, `tred`, & `unflatten`.
+> More information: <https://graphviz.org/pdf/acyclic.1.pdf>.
+
+- Make a directed graph acyclic by reversing some edges
+`acyclic {{path/to/input.gv}} > {{path/to/output.gv}}`
+
+- Print if a graph is acyclic, has a cycle, or is undirected, producing no output graph
+`acyclic -v -n {{path/to/input.gv}}`
+
+- Display help for `acyclic`
+`acyclic -?`

fastHistory/tldr/tldr/pages/common/adb.md

@@ -1,5 +1,6 @@
 # adb
 > Android Debug Bridge: communicate with an Android emulator instance or connected Android devices.
+> Some subcommands such as `adb shell` have their own usage documentation.
 > More information: <https://developer.android.com/studio/command-line/adb>.
 
 - Check whether the adb server process is running and start it

fastHistory/tldr/tldr/pages/common/adscript.md

@@ -0,0 +1,15 @@
+# adscript
+> Compiler for Adscript files.
+> More information: <https://github.com/Amplus2/Adscript>.
+
+- Compile a file to an object file
+`adscript --output {{path/to/file.o}} {{path/to/input_file.adscript}}`
+
+- Compile and link a file to a standalone executable
+`adscript --executable --output {{path/to/file}} {{path/to/input_file.adscript}}`
+
+- Compile a file to LLVM IR instead of native machine code
+`adscript --llvm-ir --output {{path/to/file.ll}} {{path/to/input_file.adscript}}`
+
+- Cross-compile a file to an object file for a foreign CPU architecture or operating system
+`adscript --target-triple {{i386-linux-elf}} --output {{path/to/file.o}} {{path/to/input_file.adscript}}`

fastHistory/tldr/tldr/pages/common/agate.md

@@ -0,0 +1,12 @@
+# agate
+> A simple server for the Gemini network protocol.
+> More information: <https://github.com/mbrubeck/agate>.
+
+- Run and generate a private key and certificate
+`agate --content {{path/to/content/}} --addr {{[::]:1965}} --addr {{0.0.0.0:1965}} --hostname {{example.com}} --lang {{en-US}}`
+
+- Run server
+`agate {{path/to/file}}`
+
+- Display help
+`agate -h`

fastHistory/tldr/tldr/pages/common/alacritty.md

@@ -1,18 +1,18 @@
 # alacritty
 > Cross-platform, GPU-accelerated terminal emulator.
-> More information: <https://github.com/jwilm/alacritty>.
+> More information: <https://github.com/alacritty/alacritty>.
 
-- Open a new alacritty window
+- Open a new Alacritty window
 `alacritty`
 
 - Run in a specific directory
 `alacritty --working-directory {{path/to/directory}}`
 
-- Run a command in a new alacritty window
+- Run a command in a new Alacritty window
 `alacritty -e {{command}}`
 
-- Specify alternative configuration file (defaults to $XDG_CONFIG_HOME/alacritty/alacritty.yml)
+- Specify alternative configuration file (defaults to `$XDG_CONFIG_HOME/alacritty/alacritty.yml`)
 `alacritty --config-file {{path/to/config.yml}}`
 
-- Run with live config reload enabled (can also be enabled by default in alacritty.yml)
+- Run with live config reload enabled (can also be enabled by default in `alacritty.yml`)
 `alacritty --live-config-reload --config-file {{path/to/config.yml}}`

fastHistory/tldr/tldr/pages/common/amass.md

@@ -1,5 +1,6 @@
 # amass
 > In-depth Attack Surface Mapping and Asset Discovery tool.
+> Some subcommands such as `amass db` have their own usage documentation.
 > More information: <https://github.com/OWASP/Amass>.
 
 - Check the Amass version

fastHistory/tldr/tldr/pages/common/ansible-galaxy.md

@@ -3,10 +3,10 @@
 > More information: <https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html>.
 
 - Install a role
-`ansible-galaxy install {{username.role_name}}`
+`ansible-galaxy install {{username}}.{{role_name}}`
 
 - Remove a role
-`ansible-galaxy remove {{username.role_name}}`
+`ansible-galaxy remove {{username}}.{{role_name}}`
 
 - List installed roles
 `ansible-galaxy list`
@@ -16,3 +16,9 @@
 
 - Create a new role
 `ansible-galaxy init {{role_name}}`
+
+- Get information about a user role
+`ansible-galaxy role info {{username}}.{{role_name}}`
+
+- Get information about a collection
+`ansible-galaxy collection info {{username}}.{{collection_name}}`

fastHistory/tldr/tldr/pages/common/ansible-playbook.md

@@ -8,10 +8,10 @@
 - Run tasks in playbook with custom host inventory
 `ansible-playbook {{playbook}} -i {{inventory_file}}`
 
-- Run tasks in playbook with extra variables defined via the command line
+- Run tasks in playbook with extra variables defined via the command-line
 `ansible-playbook {{playbook}} -e "{{variable1}}={{value1}} {{variable2}}={{value2}}"`
 
-- Run tasks in playbook with extra variables defined in a json file
+- Run tasks in playbook with extra variables defined in a JSON file
 `ansible-playbook {{playbook}} -e "@{{variables.json}}"`
 
 - Run tasks in playbook for the given tags

fastHistory/tldr/tldr/pages/common/ansible.md

@@ -1,6 +1,6 @@
 # ansible
-> Manage groups of computers remotely over SSH.
-> Use the `/etc/ansible/hosts` file to add new groups/hosts.
+> Manage groups of computers remotely over SSH. (use the `/etc/ansible/hosts` file to add new groups/hosts).
+> Some subcommands such as `ansible galaxy` have their own usage documentation.
 > More information: <https://www.ansible.com/>.
 
 - List hosts belonging to a group

fastHistory/tldr/tldr/pages/common/antibody.md

@@ -0,0 +1,12 @@
+# antibody
+> The fastest shell plugin manager.
+> More information: <https://getantibody.github.io>.
+
+- Bundle all plugins for static loading
+`antibody bundle < {{~/.zsh_plugins.txt}} > {{~/.zsh_plugins.sh}}`
+
+- Update all bundles
+`antibody update`
+
+- List all installed plugins
+`antibody list`

fastHistory/tldr/tldr/pages/common/apropos.md

@@ -8,5 +8,5 @@
 - Search without restricting the output to the terminal width
 `apropos -l {{regular_expression}}`
 
-- Search for pages that contain all of the expressions given
+- Search for pages that contain all the expressions given
 `apropos {{regular_expression_1}} -a {{regular_expression_2}} -a {{regular_expression_3}}`

fastHistory/tldr/tldr/pages/common/apt-moo.md

@@ -0,0 +1,6 @@
+# apt moo
+> An `APT` easter egg.
+> More information: <https://manpages.debian.org/latest/apt/apt.8.html>.
+
+- Print a cow easter egg
+`apt moo`

fastHistory/tldr/tldr/pages/common/arduino-builder.md

@@ -1,5 +1,5 @@
 # arduino-builder
-> A command line tool for compiling arduino sketches.
+> A command-line tool for compiling arduino sketches.
 > DEPRECATION WARNING: This tool is being phased out in favor of `arduino`.
 > More information: <https://github.com/arduino/arduino-builder>.
 

fastHistory/tldr/tldr/pages/common/aria2.md

@@ -1,25 +1,5 @@
 # aria2
-> A lightweight multi-protocol & multi-source command-line download utility.
-> Supports HTTP, HTTPS, FTP, SFTP, BitTorrent and Metalink.
-> More information: <https://aria2.github.io/>.
+> This command is an alias of `aria2c`.
 
-- Download a web resource
-`aria2c {{http://example.org/myLinux.iso}}`
-
-- Download a resource from multiple sources
-`aria2c {{http://mirror1.org/myLinux.iso}} {{http://mirror2.org/myLinux.iso}}`
-
-- Download using 2 connections per host
-`aria2c -x{{2}} {{http://example.org/myLinux.iso}}`
-
-- Download from a Metalink URI
-`aria2c {{http://example.org/myLinux.metalink}}`
-
-- Download from a BitTorrent URI
-`aria2c {{http://example.org/myLinux.torrent}}`
-
-- Download from a BitTorrent Magnet URI
-`aria2c {{'magnet:?xt=urn:btih:248D0A1CD08284299DE78D5C1ED359BB46717D8C'}}`
-
-- Download URIs from a file
-`aria2c -i {{uris.txt}}`
+- View documentation for the updated command
+`tldr aria2c`

fastHistory/tldr/tldr/pages/common/aria2c.md

@@ -6,17 +6,20 @@
 - Download a URI to a file
 `aria2c {{url}}`
 
-- Download the contents of an URL to a file
-`aria2c -o {{filename}} {{url}}`
+- Download the file pointed to by the specified URI with the specified output name
+`aria2c --out={{filename}} {{url}}`
 
-- Download from multiple sources
+- Download multiple files in parallel
+`aria2c --force-sequential {{url_1}} {{url_2}}`
+
+- Download from multiple sources with each URI pointing to the same file
 `aria2c {{url_1}} {{url_2}}`
 
-- Download the URIs listed in a file
-`aria2c -i {{filename}}`
+- Download the URIs listed in a file with limited parallel downloads
+`aria2c --input-file={{filename}} --max-concurrent-downloads={{number_of_downloads}}`
 
 - Download with multiple connections
-`aria2c -s {{connections_num}} {{url}}`
+`aria2c --split={{number_of_connections}} {{url}}`
 
 - FTP download with username and password
 `aria2c --ftp-user={{username}} --ftp-passwd={{password}} {{url}}`

fastHistory/tldr/tldr/pages/linux/arp-scan.md → fastHistory/tldr/tldr/pages/common/arp-scan.md

@@ -1,5 +1,6 @@
 # arp-scan
 > Send ARP packets to hosts (specified as IP addresses or hostnames) to scan the local network.
+> More information: <https://github.com/royhills/arp-scan>.
 
 - Scan the current local network
 `arp-scan --localnet`