*: remove and merge duplicate pages (#15983)

Author: Managor

Diff for: pages/common/chsh.md

@@ -23,6 +23,10 @@
 
 `coproc {{name}} { while read line; do {{command1; command2; ...}}; done }`
 
+- Create a coprocess which repeatedly reads `stdin`, runs a pipeline on the input, and writes the output to `stdout`:
+
+`coproc {{name}} { while read line; do echo "$line" | {{command1 | command2 | ...}} | cat /dev/fd/0; done }`
+
 - Create and use a coprocess running `bc`:
 
 `coproc BC { bc --mathlib; }; echo "1/3" >&"${BC[1]}"; read output <&"${BC[0]}"; echo "$output"`

Diff for: pages/common/coproc.md

@@ -13,24 +13,24 @@
 
 - Recursively copy a directory's contents to another location (if the destination exists, the directory is copied inside it):
 
-`cp -R {{path/to/source_directory}} {{path/to/target_directory}}`
+`cp {{[-r|--recursive]}} {{path/to/source_directory}} {{path/to/target_directory}}`
 
 - Copy a directory recursively, in verbose mode (shows files as they are copied):
 
-`cp -vR {{path/to/source_directory}} {{path/to/target_directory}}`
+`cp {{[-vr|--verbose --recursive]}} {{path/to/source_directory}} {{path/to/target_directory}}`
 
 - Copy multiple files at once to a directory:
 
-`cp -t {{path/to/destination_directory}} {{path/to/file1 path/to/file2 ...}}`
+`cp {{[-t|--target-directory]}} {{path/to/destination_directory}} {{path/to/file1 path/to/file2 ...}}`
 
-- Copy text files to another location, in interactive mode (prompts user before overwriting):
+- Copy all files with a specific extension to another location, in interactive mode (prompts user before overwriting):
 
-`cp -i {{*.txt}} {{path/to/target_directory}}`
+`cp {{[-i|--interactive]}} {{*.ext}} {{path/to/target_directory}}`
 
 - Follow symbolic links before copying:
 
-`cp -L {{link}} {{path/to/target_directory}}`
+`cp {{[-L|--dereference]}} {{link}} {{path/to/target_directory}}`
 
-- Use the first argument as the destination directory (useful for `xargs ... | cp -t <DEST_DIR>`):
+- Use the full path of source files, creating any missing intermediate directories when copying:
 
-`cp -t {{path/to/target_directory}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}`
+`cp --parents {{source/path/to/file}} {{path/to/target_file}}`

Diff for: pages/common/cp.md

@@ -4,17 +4,17 @@
 > Duc maintains a database of accumulated sizes of directories of the file system, allowing queries in this database, or creating fancy graphs to show where data is.
 > More information: <http://duc.zevv.nl>.
 
-- Index the /usr directory, writing to the default database location ~/.duc.db:
+- Index the `/usr` directory, writing to the default database location `~/.duc.db`:
 
 `duc index {{/usr}}`
 
-- List all files and directories under /usr/local, showing relative file sizes in a [g]raph:
+- List all files and directories under `/usr/local`, showing relative file sizes in a graph:
 
-`duc ls -Fg {{/usr/local}}`
+`duc ls {{[-Fg|--classify --graph]}} {{/usr/local}}`
 
-- List all files and directories under /usr/local using treeview recursively:
+- List all files and directories under `/usr/local` using treeview recursively:
 
-`duc ls -Fg -R {{/usr/local}}`
+`duc ls {{[-Fg|--classify --graph]}} {{[-R|--recursive]}} {{/usr/local}}`
 
 - Start the graphical interface to explore the file system using sunburst graphs:
 

Diff for: pages/common/duc.md

@@ -18,7 +18,7 @@
 
 - Start an interactive editor session with an empty document and without diagnostics, byte counts and '!' prompt:
 
-`ed {{[-q|--quiet]}}`
+`ed {{[-q|--quiet]}} {{[-s|--script]}}`
 
 - Start an interactive editor session without exit status change when command fails:
 

Diff for: pages/common/ed.md

@@ -3,26 +3,34 @@
 > View the last logged in users.
 > More information: <https://manned.org/last>.
 
-- View last logins, their duration and other information as read from `/var/log/wtmp`:
+- View last login infromation (e.g., username, terminal, boot time, kernel) of all users as read from `/var/log/wtmp`:
 
 `last`
 
+- List login information of a specific user:
+
+`last {{username}}`
+
 - Specify how many of the last logins to show:
 
-`last -n {{login_count}}`
+`last {{[-n|--limit]}} {{login_count}}`
 
 - Print the full date and time for entries and then display the hostname column last to prevent truncation:
 
-`last -F -a`
+`last {{[-F|--fulltimes]}} {{[-a|--hostlast]}}`
 
 - View all logins by a specific user and show the IP address instead of the hostname:
 
-`last {{username}} -i`
+`last {{username}} {{[-i|--ip]}}`
+
+- List information since a specific time and date:
+
+`last {{[-s|--since]}} {{-7days}}`
 
 - View all recorded reboots (i.e., the last logins of the pseudo user "reboot"):
 
 `last reboot`
 
-- View all recorded shutdowns (i.e., the last logins of the pseudo user "shutdown"):
+- Display help:
 
-`last shutdown`
+`last {{[-h|--help]}}`

Diff for: pages/common/flex.md

@@ -3,7 +3,7 @@
 > Lexical analyzer generator.
 > Given the specification for a lexical analyzer, generates C code implementing it.
 > Note: on most major OSes, this command is an alias for `flex`.
-> More information: <https://manned.org/lex.1>.
+> More information: <https://manned.org/lex>.
 
 - Generate an analyzer from a Lex file, storing it to the file `lex.yy.c`:
 

Diff for: pages/common/last.md

@@ -7,26 +7,30 @@
 
 `man {{command}}`
 
+- Open the man page for a command in a browser (`BROWSER` environment variable can replace `=browser_name`):
+
+`man {{[-Hbrowser_name|--html=browser_name]}} {{command}}`
+
 - Display the man page for a command from section 7:
 
 `man {{7}} {{command}}`
 
 - List all available sections for a command:
 
-`man -f {{command}}`
+`man {{[-f|--whatis]}} {{command}}`
 
 - Display the path searched for manpages:
 
-`man --path`
+`man {{[-w|--path]}}`
 
 - Display the location of a manpage rather than the manpage itself:
 
-`man -w {{command}}`
+`man {{[-w|--where]}} {{command}}`
 
 - Display the man page using a specific locale:
 
-`man {{command}} --locale={{locale}}`
+`man {{[-L|--locale]}} {{locale}} {{command}}`
 
 - Search for manpages containing a search string:
 
-`man -k "{{search_string}}"`
+`man {{[-k|--apropos]}} "{{search_string}}"`

Diff for: pages/common/lex.md

@@ -1,16 +1,16 @@
 # mycli
 
-> A command-line client for MySQL that can do auto-completion and syntax highlighting.
-> More information: <https://mycli.net>.
+> A CLI for MySQL, MariaDB, and Percona that can do auto-completion and syntax highlighting.
+> More information: <https://manned.org/mycli>.
 
 - Connect to a local database on port 3306, using the current user's username:
 
 `mycli {{database_name}}`
 
 - Connect to a database (user will be prompted for a password):
 
-`mycli -u {{username}} {{database_name}}`
+`mycli {{[-u|--user]}} {{username}} {{database_name}}`
 
 - Connect to a database on another host:
 
-`mycli -h {{database_host}} -P {{port}} -u {{username}} {{database_name}}`
+`mycli {{[-h|--host]}} {{database_host}} {{[-P|--port]}} {{port}} {{[-u|--user]}} {{username}} {{database_name}}`

Diff for: pages/common/man.md

@@ -1,9 +1,10 @@
 # pngcheck
 
-> Print detailed information about and verify PNG, JNG, and MNG files.
-> More information: <http://www.libpng.org/pub/png/apps/pngcheck.html>.
+> Forensics tool for validating the integrity of PNG based (PNG, JNG, MNG) image files.
+> Can also extract embedded images and text from a file.
+> More information: <https://github.com/pnggroup/pngcheck>.
 
-- Print a summary for an image (width, height, and color depth):
+- Verify the integrity of an image file (width, height, and color depth):
 
 `pngcheck {{path/to/image.png}}`
 

Diff for: pages/common/mycli.md

@@ -5,14 +5,18 @@
 > See also: `nice`.
 > More information: <https://manned.org/renice>.
 
-- Increase/decrease the priority of a running [p]rocess:
+- Set the absolute priority of a running process:
 
-`renice -n {{3}} -p {{pid}}`
+`renice --priority {{3}} {{[-p|--pid]}} {{pid}}`
 
-- Increase/decrease the priority of all processes owned by a [u]ser:
+- Increase the priority of a running process:
 
-`renice -n {{-4}} -u {{uid|user}}`
+`sudo renice --relative {{-4}} {{[-p|--pid]}} {{pid}}`
 
-- Increase/decrease the priority of all processes that belong to a process [g]roup:
+- Decrease the priority of all processes owned by a user:
 
-`renice -n {{5}} -g {{process_group}}`
+`renice --relative {{4}} {{[-u|--user]}} {{uid|user}}`
+
+- Set the priority of all processes that belong to a process group:
+
+`sudo renice {{-5}} {{[-g|--pgrp]}} {{process_group}}`

Diff for: pages/common/pngcheck.md

@@ -10,16 +10,20 @@
 
 - Remove specific files ignoring nonexistent ones:
 
-`rm -f {{path/to/file1 path/to/file2 ...}}`
+`rm {{[-f|--force]}} {{path/to/file1 path/to/file2 ...}}`
 
 - Remove specific files interactively prompting before each removal:
 
-`rm -i {{path/to/file1 path/to/file2 ...}}`
+`rm {{[-i|--interactive]}} {{path/to/file1 path/to/file2 ...}}`
 
 - Remove specific files printing info about each removal:
 
-`rm -v {{path/to/file1 path/to/file2 ...}}`
+`rm {{[-v|--verbose]}} {{path/to/file1 path/to/file2 ...}}`
 
 - Remove specific files and directories recursively:
 
-`rm -r {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}`
+`rm {{[-r|--recursive]}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}`
+
+- Remove empty directories (this is considered the safe method):
+
+`rm {{[-d|--dir]}} {{path/to/directory}}`

Diff for: pages/common/renice.md

@@ -10,4 +10,4 @@
 
 - Remove specific nested directories recursively:
 
-`rmdir -p {{path/to/directory1 path/to/directory2 ...}}`
+`rmdir {{[-p|--parents]}} {{path/to/directory1 path/to/directory2 ...}}`

Diff for: pages/common/rm.md

@@ -1,24 +1,32 @@
 # script
 
-> Make a typescript file of a terminal session.
+> Record all terminal output to a typescript file.
 > More information: <https://manned.org/script>.
 
-- Start recording in file named "typescript":
+- Record a new session to a file named `typescript` in the current directory:
 
 `script`
 
 - Stop recording:
 
 `exit`
 
-- Start recording in a given file:
+- Record a new session to a custom filepath:
 
-`script {{logfile.log}}`
+`script {{path/to/session.out}}`
 
 - Append to an existing file:
 
-`script -a {{logfile.log}}`
+`script {{[-a|--append]}} {{logfile.log}}`
+
+- Record timing information (data is outputted to `stderr`):
+
+`script {{[-t|--timing]}} 2> {{path/to/timing_file}}`
+
+- Write out data as soon as it happens:
+
+`script {{[-f|--flush]}} {{path/to/file}}`
 
 - Execute quietly without start and done messages:
 
-`script -q {{logfile.log}}`
+`script {{[-q|--quiet]}} {{logfile.log}}`

Diff for: pages/common/rmdir.md

@@ -12,14 +12,14 @@
 
 `{{cat path/to/file}} | tac`
 
-- Use a specific [s]eparator:
+- Use a specific separator:
 
-`tac -s {{separator}} {{path/to/file1 path/to/file2 ...}}`
+`tac {{[-s|--separator]}} {{separator}} {{path/to/file1 path/to/file2 ...}}`
 
-- Use a specific [r]egex as a [s]eparator:
+- Use a specific regex as a separator:
 
-`tac -r -s {{separator}} {{path/to/file1 path/to/file2 ...}}`
+`tac {{[-r|--regex]}} {{[-s|--separator]}} {{separator}} {{path/to/file1 path/to/file2 ...}}`
 
-- Use a separator [b]efore each file:
+- Use a separator before each file:
 
-`tac -b {{path/to/file1 path/to/file2 ...}}`
+`tac {{[-b|--before]}} {{path/to/file1 path/to/file2 ...}}`

Diff for: pages/common/script.md

@@ -8,18 +8,30 @@
 
 `uname`
 
+- Print all available system information:
+
+`uname {{[-a|--all]}}`
+
 - Print system architecture and processor information:
 
-`uname --machine --processor`
+`uname {{[-mp|--machine --processsor]}}`
 
 - Print kernel name, kernel release and kernel version:
 
-`uname --kernel-name --kernel-release --kernel-version`
+`uname {{[-srv|--kernel-name --kernel-release --kernel-version]}}`
 
 - Print system hostname:
 
-`uname --nodename`
+`uname {{[-n|--nodename]}}`
 
-- Print all available system information:
+- Print the current operating system name:
+
+`uname {{[-o|--operating-system]}}`
+
+- Print the current network node host name:
+
+`uname {{[-n|--nodename]}}`
+
+- Display help:
 
-`uname --all`
+`uname --help`