Base: Update man pages for utilities

Man pages for utilities now more closely resemble ArgsParser output

Base/usr/share/man/man1/Shell.md

@@ -28,6 +28,8 @@ The `Shell` utility does not promise POSIX `sh` interoperability.
 * `--skip-shellrc`: Skips running the initialization file (at `~/.shellrc`)
 * `--format`: Format shell code from the given file and print the result to standard output
 * `-f`, `--live-formatting`: Enable live formatting of the line editor buffer (in REPL mode)
+* `--keep-open`: Keep the shell open after running the specified command or file
+* `--posix`: Behave like a POSIX-compatible shell
 
 ## Examples
 

Base/usr/share/man/man1/arp.md

@@ -1,6 +1,6 @@
 ## Name
 
-arp - display ARP cache
+arp - Display or modify the system ARP cache
 
 ## Synopsis
 
@@ -14,6 +14,17 @@ This program run as root displays IP and MAC addresses of devices in local netwo
 
 ARP stands for Address Resolution Protocol, which is used to find devices in local network.
 
+## Options
+
+* `-s`, `--set`: Set an ARP table entry
+* `-d`, `--delete`: Delete an ARP table entry
+* `-n`, `--numeric`: Display numerical addresses. Don't resolve hostnames
+
+## Arguments
+
+* `address`: IPv4 protocol address
+* `hwaddress`: Hardware address
+
 ## Examples
 
 ```sh

Base/usr/share/man/man1/basename.md

@@ -5,7 +5,7 @@ basename - strip directory names from path
 ## Synopsis
 
 ```**sh
-$ basename <path>
+$ basename <path> [suffix]
 ```
 
 ## Description
@@ -15,6 +15,7 @@ $ basename <path>
 ## Arguments
 
 * `path`: The path which we want to get basename of
+* `suffix`: Suffix to strip from name
 
 ## Examples
 

Base/usr/share/man/man1/beep.md

@@ -14,7 +14,7 @@ beep allows the user to beep the PC speaker.
 
 ## Options
 
-* `-f|--beep-tone`: Beep tone (frequency in Hz)
+* `-f frequency`, `--beep-tone frequency`: Beep tone (frequency in Hz)
 
 ## Notes
 

Base/usr/share/man/man1/chgrp.md

@@ -13,6 +13,10 @@ $ chgrp <name> <path>
 
 `chgrp` called as root or as file owner changes owning group of specified `path` to `gid` or `name`.
 
+## Options
+
+* `-h`, `--no-dereference`: Don't follow symlinks
+
 ## Examples
 
 ```sh

Base/usr/share/man/man1/chmod.md

@@ -23,6 +23,10 @@ The letters `[rwx]` controls which permission will be changes: `r` is read, `w`
 
 A numeric mode is combination of 1 to 4 numbers. Omitted digits are assumed to be leading zeros. The first digit select the set user ID (4), set group ID (2) and restricted deletion / sticky (1) attributes. The second, third and fourth digit controls permissions of each user group: owner, owning group and others (not owner or owning group), respectively: read (4), write (2) and execute (1).
 
+## Options
+
+* `-R`, `--recursive`: Change file modes recursively
+
 ## Examples
 
 ```sh

Base/usr/share/man/man1/chown.md

@@ -5,7 +5,7 @@ chown - change file owner / group
 ## Synopsis
 
 ```**sh
-$ chown [user][:group] files...
+$ chown <user[:group]> <path...>
 ```
 
 ## Description
@@ -15,6 +15,12 @@ $ chown [user][:group] files...
 **NOTE**: The caller must be a superuser to change user ownership. Other users can use `chown` to change the group to one of their other
 group.
 
+## Options
+
+* `-h`, `--no-dereference`: Don't follow symlinks
+* `-R`, `--recursive`: Change file ownership recursively
+* `-L`: Follow symlinks while recursing into directories
+
 ## Examples
 
 ```sh

Base/usr/share/man/man1/chres.md

@@ -12,6 +12,10 @@ $ chres <width> <height> [scale factor]
 
 `chres` changes the display resolution to <width>x<height>@<scale factor>x.
 
+## Options
+
+* `-s`, `--screen`: Screen
+
 ## Examples
 
 ```sh

Base/usr/share/man/man1/crash.md

@@ -29,12 +29,13 @@ of crashes.
 * `-T`: Make a syscall while using an invalid stack pointer.
 * `-t`: Trigger a page fault while using an invalid stack pointer.
 * `-S`: Make a syscall from writeable memory.
+* `-y`: Make a syscall from legitimate memory (but outside syscall-code mapped region).
 * `-X`: Attempt to execute non-executable memory (Not mapped with PROT\_EXEC).
 * `-U`: Attempt to trigger an x86 User Mode Instruction Prevention fault.
 * `-I`: Use an x86 I/O instruction in userspace.
-* `-c`: Read the x86 TSC (Time Stamp Counter) directly.
 * `-p`: Violate `pledge()`'d promises.
 * `-n`: Perform a failing assertion.
+* `-R`: Dereference a null RefPtr.
 
 ## Examples
 

Base/usr/share/man/man1/cut.md

@@ -24,7 +24,6 @@ With no FILE, or when FILE is -, read standard input.
 * `-f` `--fields=list`: select only these fields; also print any line that contains no delimiter character
 * `-d` `--delimiter=delim`: use `delim` instead of `tab` for field delimiter
 
-
 ## Examples
 
 ```sh

Base/usr/share/man/man1/dd.md

@@ -18,10 +18,16 @@ $ dd if=[input_file] of=[output_file] [args...]
 
 ## Arguments
 
-* `if`: input file (or device) to read from
+* `if`: input file (or device) to read from (default: stdin)
-* `of`: output file (or device) to write to
+* `of`: output file (or device) to write to (default: stdout)
-* `bs`: block size (of bytes) to use
+* `bs`: block size (of bytes) to use (default: 512)
 * `count`: number of blocks to write
+* `seek`: number of output blocks to skip (default: 0)
+* `skip`: number of input blocks to skip (default: 0)
+* `status`: level of output (default: default)
+  * `default`: error messages + final statistics
+  * `none`: just error messages
+  * `noxfer`: no final statistics
 
 ## Examples
 

Base/usr/share/man/man1/du.md

@@ -16,6 +16,8 @@ $ du [files...]
 
 * `-a`, `--all`: Write counts for all files, not just directories
 * `--apparent-size`: Print apparent sizes, rather than disk usage
+* `-h` , `--human-readable`: Print human-readable sizes
+* `--si`: Print human-readable sizes in SI units
 * `-d N`, `--max-depth N`: Print the total for a directory or file only if it is N or fewer levels below the command line argument
 * `-s`, `--summarize`: Display only a total for each argument
 * `-t size`, `--threshold size`: Exclude entries smaller than size if positive, or entries greater than size if negative

Base/usr/share/man/man1/jail-attach.md

@@ -15,6 +15,7 @@ specified jail index.
 
 ## Options
 
+* `-E`, `--preserve-env`: Preserve user environment when running command
 * `-i`, `--jail-index`: Use an already existing jail with its index
 * `-n`, `--jail-name`: Create a new jail with a provided name
 

Base/usr/share/man/man1/keymap.md

@@ -14,6 +14,11 @@ The `keymap` utility can be used to configure the list of selected keyboard layo
 
 Layouts loaded from `/res/keymaps/*.json`.
 
+## Options
+
+* `-m keymap`, `--set-keymap keymap`: The mapping to be used
+* `-s keymaps`, `--set-keymaps keymaps`: Comma separated list of enabled mappings
+
 ## Examples
 
 Get name of the currently set keymap:

Base/usr/share/man/man1/ls.md

@@ -30,6 +30,7 @@ If no *path* argument is provided the current working directory is used.
 * `-n`, `--numeric-uid-gid`: In long format, display numeric UID/GID
 * `-o`, In long format, do not show group information
 * `-h`, `--human-readable`: Print human-readable sizes
+* `--si`: Print human-readable sizes in SI units
 * `-K`, `--no-hyperlinks`: Disable hyperlinks
 * `-R`, `--recursive`: List subdirectories recursively
 * `-1`: List one file per line

Base/usr/share/man/man1/man.md

@@ -15,6 +15,10 @@ $ man section page
 or man pages for short, from the SerenityOS manual. You're reading
 the manual page for `man` program itself right now.
 
+## Options
+
+* `-P pager`, `--pager pager`: Pager to pipe the man page to
+
 ## Examples
 
 To open documentation for the `echo` command:

Base/usr/share/man/man1/md.md

@@ -17,7 +17,7 @@ standard input.
 
 ## Options
 
-* `--html`: Render the document into HTML.
+* `-H`, `--html`: Render the document into HTML.
 
 ## Examples
 

Base/usr/share/man/man1/mv.md

@@ -16,6 +16,7 @@ $ mv [options...] <source...> <destination>
 ## Options
 
 * `-f`, `--force`: Do not prompt before overwriting (not implemented for now)
+* `-n`, `--no-clobber`: Do not overwrite existing files
 * `-v`, `--verbose`: Display all moved files
 
 ## Examples

Base/usr/share/man/man1/rm.md

@@ -19,6 +19,7 @@ If a directory is specified in `path`, the `-r` (recursive) flag is required. Ot
 * `-r`, `--recursive`: Remove files and directories recursively
 * `-f`, `--force`: Do not prompt before removing
 * `-v`, `--verbose`: Display what files are removed
+* `--no-preserve-root`: Do not treat '/' specially
 
 ## Examples
 

Base/usr/share/man/man1/su.md

@@ -18,7 +18,6 @@ When called with no user-specified, `su` defaults to switch to the *root* user.
 ## Options:
 
 * `-`, `-l`, `--login`: Start the shell as it was a real login
-
 * `-c`, `--command`: Execute a command using `/bin/sh` instead of starting an interactive shell
 
 ## Arguments

Base/usr/share/man/man1/tar.md

@@ -22,6 +22,8 @@ Files may also be compressed and decompressed using GNU Zip (GZIP) compression.
 * `-t`, `--list`: List contents
 * `-v`, `--verbose`: Print paths
 * `-z`, `--gzip`: Compress or decompress file using gzip
+* `--lzma`: Compress or decompress file using lzma
+* `-J`, `--xz`: Compress or decompress file using xz
 * `--no-auto-compress`: Do not use the archive suffix to select the compression algorithm
 * `-C DIRECTORY`, `--directory DIRECTORY`: Directory to extract to/create from
 * `-f FILE`, `--file FILE`: Archive file

Base/usr/share/man/man1/test-js.md

@@ -24,7 +24,13 @@ You can disable output from `dbgln()` calls by setting the `DISABLE_DBG_OUTPUT`
 ## Options
 
 * `-t`, `--show-time`: Show duration of each test
+* `-p`, `--show-progress`: Show progress with OSC 9 (true, false)
+* `-j`, `--json`: Show results as JSON
+* `--per-file`: Show detailed per-file results as JSON (implies -j)
 * `-g`, `--collect-often`: Collect garbage after every allocation
+* `-b`, `--run-bytecode`: Use the bytecode interpreter
+* `-d`, `--dump-bytecode`: Dump the bytecode
+* `-f glob`, `--filter glob`: Only run tests matching the given glob
 * `--test262-parser-tests`: Run test262 parser tests
 
 ## Examples

Base/usr/share/man/man1/uname.md

@@ -18,6 +18,7 @@ system call.
 * `-s`: Print the system name
 * `-n`: Print the node name (hostname)
 * `-r`: Print the system release version
+* `-v`: Print the version of the release
 * `-m`: Print the machine type
 * `-a`: Print all of the above
 

Base/usr/share/man/man1/uniq.md

@@ -17,8 +17,9 @@ Filter out repeated adjacent lines from INPUT (or standard input) and write to O
 * `-c`, `--count`: Precede each line with its number of occurrences.
 * `-d`, `--repeated`: Only print repeated lines.
 * `-u`, `--unique`: Only print unique lines (default).
+* `-i`, `--ignore-case`: Ignore case when comparing lines.
 * `-f N`, `--skip-fields N`: Skip first N fields of each line before comparing.
-* `-c N`, `--skip-chars N`: Skip first N chars of each line before comparing.
+* `-s N`, `--skip-chars N`: Skip first N chars of each line before comparing.
 * `--help`: Display help message and exit.
 * `--version`: Print version.
 

Base/usr/share/man/man1/unzip.md

@@ -16,6 +16,11 @@ The program is compatible with the PKZIP file format specification.
 
 The optional [files] argument can be used to only extract specific files within the archive (using wildcards) during the unzip process. A `_` can be used as a single-character wildcard, and  `*` can be used as a variable-length wildcard.
 
+## Options
+
+* `-d path`, `--output-directory path`: Directory to receive the archive output
+* `-q`, `--quiet`: Be less verbose
+
 ## Examples
 
 ```sh

Base/usr/share/man/man1/wallpaper.md

@@ -17,6 +17,7 @@ list available wallpapers in the `/res/wallpapers/` directory.
 
 * `-a`, `--show-all`: Show all wallpapers
 * `-c`, `--show-current`: Show current wallpaper
+* `-r`, `--set-random`: Set random wallpaper
 
 ## Examples
 

Base/usr/share/man/man1/watch.md

@@ -15,9 +15,10 @@ aggregated error code.
 
 ## Options
 
-* '-n': Interval between executions, in seconds. By default, the program is run every 2 seconds.
+* `-n seconds`: Interval between executions, in seconds. By default, the program is run every 2 seconds.
-* '-t': Don't print the title bar.
+* `-t`, `--no-title`: Don't print the title bar.
-* '-b': Beep each time the command exits with a non-zero status
+* `-b`, `--beep`: Beep each time the command exits with a non-zero status.
+* `-f file`, `--file file`: Run command whenever this file changes. Can be used multiple times.
 
 ## Exit Values
 

Base/usr/share/man/man1/zip.md

@@ -14,6 +14,11 @@ zip will pack the specified files into a zip archive, compressing them when poss
 
 The program is compatible with the PKZIP file format specification.
 
+## Options
+
+* `-r`, `--recurse-paths`: Travel the directory structure recursively
+* `-f`, `--force`: Overwrite existing zip file
+
 ## Examples
 
 ```sh