Improve command quality

Author: SimonSchubert

assets/commands/apptainer-test.md

@@ -54,9 +54,15 @@ Run validation tests defined in a container
 **--fakeroot**
 > Run test with fake root privileges.
 
-**--pwd** _path_
+**--cwd**, **--pwd** _path_
 > Set working directory inside container.
 
+**--writable**, **-w**
+> Make file system accessible as read-write.
+
+**--writable-tmpfs**
+> Make file system read-write with non-persistent data (tmpfs overlay).
+
 **--help**, **-h**
 > Display help for the test command.
 
@@ -80,4 +86,4 @@ The test subcommand has been part of Singularity/Apptainer since early versions,
 
 # SEE ALSO
 
-[apptainer](/man/apptainer)(1), [apptainer-build](/man/apptainer-build)(1), [apptainer-run](/man/apptainer-run)(1), [apptainer-inspect](/man/apptainer-inspect)(1)
+[apptainer](/man/apptainer)(1), [apptainer-build](/man/apptainer-build)(1), [apptainer-run](/man/apptainer-run)(1), [apptainer-exec](/man/apptainer-exec)(1), [apptainer-inspect](/man/apptainer-inspect)(1)

assets/commands/aptitude-create-state-bundle.md

@@ -14,7 +14,7 @@ Create with **verbose** output
 
 # SYNOPSIS
 
-**aptitude-create-state-bundle** [_--force-bzip2_] [_--print-inputs_] _output_
+**aptitude-create-state-bundle** [_options_] _output-file_
 
 # DESCRIPTION
 
@@ -25,10 +25,13 @@ The bundle includes package lists, aptitude settings, and resolver state.
 # PARAMETERS
 
 **--force-bzip2**
-> Use bzip2 compression even for .gz extension
+> Force bzip2 compression regardless of file extension.
+
+**--force-gzip**
+> Force gzip compression even if bzip2 is available.
 
 **--print-inputs**
-> List files that would be included
+> Display the list of files and directories that would be included without creating the bundle.
 
 **-v**, **--verbose**
 > Verbose output

assets/commands/asn1parse.1s.md

@@ -6,23 +6,27 @@ Parse and display ASN.1 encoded data
 
 **Parse** ASN.1 data
 
-```asn1parse -in [file.der]```
+```openssl asn1parse -in [file.der]```
 
 Parse **PEM** encoded file
 
-```asn1parse -in [file.pem] -inform PEM```
+```openssl asn1parse -in [file.pem] -inform PEM```
 
 Parse with **offset**
 
-```asn1parse -in [file.der] -offset [100]```
+```openssl asn1parse -in [file.der] -offset [100]```
 
-Show **structure** in detail
+Show **structure** with hex dump
 
-```asn1parse -in [file.der] -dump```
+```openssl asn1parse -in [file.der] -dump```
+
+Parse **nested** ASN.1 structure at a given offset
+
+```openssl asn1parse -in [file.pem] -strparse [offset]```
 
 # SYNOPSIS
 
-**asn1parse** [_-in file_] [_-inform format_] [_-offset n_] [_-dump_] [_options_]
+**openssl asn1parse** [**-help**] [**-inform** _DER|PEM_] [**-in** _filename_] [**-out** _filename_] [**-noout**] [**-offset** _number_] [**-length** _number_] [**-i**] [**-dump**] [**-dlimit** _num_] [**-strparse** _offset_] [**-genstr** _string_] [**-genconf** _file_] [**-strictpem**]
 
 # DESCRIPTION
 
@@ -32,32 +36,47 @@ The tool is invaluable for debugging certificate issues, understanding data stru
 
 # PARAMETERS
 
-**-in** _file_
-> Input file
+**-help**
+> Print usage message.
 
-**-inform** _format_
-> Input format: PEM or DER
+**-in** _filename_
+> Input file, default is standard input.
 
-**-out** _file_
-> Output file
+**-inform** _DER|PEM_
+> Input format; the default is PEM.
+
+**-out** _filename_
+> Output file to place the DER encoded data into.
 
 **-noout**
-> Don't output parsed structure
+> Don't output the parsed version of the input file.
+
+**-offset** _number_
+> Starting offset to begin parsing, default is start of file.
 
-**-offset** _n_
-> Start parsing at offset n
+**-length** _number_
+> Number of bytes to parse, default is until end of file.
 
-**-length** _n_
-> Parse n bytes
+**-i**
+> Indent the output according to the depth of the structures.
 
 **-dump**
-> Hex dump of content
+> Dump unknown data in hex format.
+
+**-dlimit** _num_
+> Like **-dump**, but only the first num bytes are output.
 
 **-strparse** _offset_
-> Parse nested structure at offset
+> Parse the contents octets of the ASN.1 object starting at offset.
 
 **-genstr** _string_
-> Generate ASN.1 from string
+> Generate encoded data based on string using ASN1_generate_nconf format.
+
+**-genconf** _file_
+> Generate encoded data from file using ASN1_generate_nconf format.
+
+**-strictpem**
+> Ignore any data prior to the BEGIN marker or after END marker in PEM.
 
 # CAVEATS
 
@@ -69,4 +88,4 @@ Requires understanding of ASN.1 structure. Output can be verbose for complex obj
 
 # SEE ALSO
 
-[openssl](/man/openssl)(1), [x509](/man/x509)(1), [req](/man/req)(1)
+[openssl](/man/openssl)(1), [openssl-x509](/man/openssl-x509)(1), [openssl-req](/man/openssl-req)(1)

assets/commands/aws-vault.md

@@ -59,16 +59,25 @@ The tool provides defense-in-depth security for AWS credentials and enables easy
 > Rotate access keys
 
 **export** _profile_
-> Export credentials as environment variables
+> Export credentials as environment variables.
+
+**clear** _profile_
+> Clear temporary credentials from the session store.
 
 **--duration=**_time_
-> Session duration (e.g., 12h, 1h30m)
+> Session duration (e.g., 12h, 1h30m).
 
 **--mfa-token=**_token_
-> MFA token code
+> MFA token code.
 
 **--no-session**
-> Don't create STS session
+> Use long-term credentials instead of creating an STS session.
+
+**--server**
+> Start a local EC2 metadata server instead of using environment variables.
+
+**--backend=**_backend_
+> Credential storage backend (keychain, kwallet, pass, secret-service, file).
 
 # FEATURES
 

assets/commands/az-image.md

@@ -34,6 +34,9 @@ Manage custom virtual machine images in Azure
 
 # SUBCOMMANDS
 
+**copy**
+> Copy a managed image to other regions (requires extension).
+
 **create**
 > Create a custom virtual machine image from managed disks or snapshots.
 
@@ -47,7 +50,10 @@ Manage custom virtual machine images in Azure
 > Get information about an image.
 
 **update**
-> Update an image.
+> Update custom VM images.
+
+**wait**
+> Place the CLI in a waiting state until a condition is met.
 
 # PARAMETERS
 
@@ -66,6 +72,15 @@ Manage custom virtual machine images in Azure
 **--os-type**
 > Operating system type: Linux or Windows.
 
+**--location** **-l**
+> Location for the image.
+
+**--hyper-v-generation**
+> Hypervisor generation of the VM: V1 or V2.
+
+**--tags**
+> Space-separated tags: key[=value].
+
 **--data-disk-sources**
 > Managed disks or snapshots for data disks.
 
@@ -81,4 +96,4 @@ Requires Azure CLI to be installed and authenticated with **az login**. The sour
 
 # SEE ALSO
 
-[az](/man/az)(1), [az-disk](/man/az-disk)(1), [az-snapshot](/man/az-snapshot)(1)
+[az](/man/az)(1), [az-disk](/man/az-disk)(1), [az-vm](/man/az-vm)(1)

assets/commands/brew-update.md

@@ -30,7 +30,7 @@ Fetch the latest Homebrew and package definitions
 
 # DESCRIPTION
 
-**brew update** fetches the newest version of Homebrew and all formulae definitions from GitHub. It updates Homebrew itself and refreshes the list of available packages.
+**brew update** fetches the newest version of Homebrew and all formulae from GitHub using git, and performs any necessary migrations.
 
 This command does not upgrade installed packages - use **brew upgrade** for that.
 
@@ -53,9 +53,6 @@ Aliases: **brew up**
 **--merge**
 > Use git merge instead of git rebase
 
-**--quiet, -q**
-> Suppress output
-
 # AUTO-UPDATE
 
 Homebrew auto-updates before **brew install** by default. Configure with:

assets/commands/bzgrep.md

@@ -22,17 +22,17 @@ Search bzip2 compressed files for patterns
 
 # SYNOPSIS
 
-**bzgrep** [_grep-options_] [_pattern_] [_file_...]
+**bzgrep** [_grep-options_] [**-e**] _pattern_ [_filename_...]
 
 # DESCRIPTION
 
-**bzgrep** searches for patterns in bzip2-compressed files without decompressing them to disk. It's a wrapper around grep that transparently handles .bz2 files.
+**bzgrep** invokes grep on bzip2-compressed files. If no file is specified, standard input is decompressed if necessary and fed to grep. Otherwise the given files are uncompressed if necessary and fed to grep.
 
-The tool provides the same functionality as grep but for compressed files.
+When invoked as **bzegrep** or **bzfgrep**, egrep or fgrep is used instead of grep. The grep program can also be overridden via the **GREP** environment variable.
 
 # PARAMETERS
 
-Supports standard grep options:
+All options are passed directly to grep:
 
 **-i**
 > Case-insensitive search
@@ -49,6 +49,9 @@ Supports standard grep options:
 **-l**
 > List matching files
 
+**-e** _pattern_
+> Use pattern as the search pattern (useful for patterns starting with -)
+
 **-H**
 > Print filename
 
@@ -58,10 +61,10 @@ Supports standard grep options:
 # RELATED COMMANDS
 
 **bzegrep**
-> Extended regular expressions (grep -E)
+> Extended regular expressions (egrep / grep -E)
 
 **bzfgrep**
-> Fixed strings (grep -F)
+> Fixed strings (fgrep / grep -F)
 
 # WORKFLOW
 
@@ -80,6 +83,9 @@ bzgrep -C 3 "error" logfile.bz2
 
 # Count occurrences
 bzgrep -c "error" logfile.bz2
+
+# Override grep with fgrep
+GREP=fgrep bzgrep string files
 ```
 
 # CAVEATS
@@ -92,4 +98,4 @@ Slower than searching uncompressed files. Must decompress entire file to search.
 
 # SEE ALSO
 
-[grep](/man/grep)(1), [bzcat](/man/bzcat)(1), [zgrep](/man/zgrep)(1)
+[grep](/man/grep)(1), [egrep](/man/egrep)(1), [fgrep](/man/fgrep)(1), [bzdiff](/man/bzdiff)(1), [bzmore](/man/bzmore)(1), [bzless](/man/bzless)(1), [bzip2](/man/bzip2)(1), [zgrep](/man/zgrep)(1)

assets/commands/crane-digest.md

@@ -24,6 +24,9 @@ retrieve image content digest
 **--full-ref**
 > Print the full image reference with digest.
 
+**--tarball** _path_
+> Path to tarball containing the image.
+
 # DESCRIPTION
 
 **crane digest** retrieves the content-addressable digest (SHA256) of a container image. The digest uniquely identifies the image content regardless of tag.

assets/commands/cwl-runner.md

@@ -58,12 +58,27 @@ Common Workflow Language executor
 **--quiet**
 > Only print warnings and errors.
 
-**--strict**
-> Strict validation mode.
+**--validate**
+> Validate the CWL document without running.
 
 **--leave-tmpdir**
 > Don't delete temporary directories.
 
+**--version**
+> Print version and exit.
+
+**--make-template**
+> Generate template input object.
+
+**--on-error** _action_
+> Workflow behavior on failure (stop or continue).
+
+**--singularity**
+> Use Singularity container runtime instead of Docker.
+
+**--podman**
+> Use Podman container runtime instead of Docker.
+
 # DESCRIPTION
 
 **cwl-runner** executes workflows defined in Common Workflow Language (CWL), a specification for describing analysis workflows in data-intensive sciences. CWL workflows are portable across different execution environments.

assets/commands/dhcpd.md

@@ -58,12 +58,33 @@ ISC DHCP server daemon for IP address assignment
 **-4** / **-6**
 > Force IPv4 or IPv6 mode.
 
+**-p** _port_
+> Listen on alternate UDP port (default 67).
+
+**-s** _address_
+> Send replies to specified address instead of broadcast.
+
 **-q**
-> Quiet startup.
+> Quiet startup (suppress copyright message).
+
+**-user** _user_
+> Setuid to user after privileged operations.
+
+**-group** _group_
+> Setgid to group after privileged operations.
+
+**-chroot** _dir_
+> Chroot to directory.
+
+**-tf** _tracefile_
+> Log startup state and transactions for debugging.
 
 **--no-pid**
 > Don't write PID file.
 
+**--version**
+> Display version and exit.
+
 # CONFIGURATION
 
 **/etc/dhcp/dhcpd.conf**:
@@ -100,4 +121,4 @@ ISC DHCP was originally developed by **Ted Lemon** at the Internet Systems Conso
 
 # SEE ALSO
 
-[dhcpd.conf](/man/dhcpd.conf)(5), [dhcpd.leases](/man/dhcpd.leases)(5), [dhclient](/man/dhclient)(8), [kea-dhcp4](/man/kea-dhcp4)(8)
+[dhclient](/man/dhclient)(8)