Improve command quality

Author: SimonSchubert

assets/commands/apptainer-exec.md

@@ -22,7 +22,7 @@ Execute a command within an Apptainer container.
 
 **Execute from Docker Hub** image
 
-```apptainer exec docker://[ubuntu:latest] [cat /etc/os-release]```
+```apptainer exec docker://[image:tag] [command]```
 
 **Run with isolated network**
 
@@ -32,9 +32,9 @@ Execute a command within an Apptainer container.
 
 ```apptainer exec --env [VAR=value] [container.sif] [command]```
 
-**Run with all host filesystems bound**
+**Run in a writable sandbox directory**
 
-```apptainer exec --bind /:/host:ro [container.sif] [command]```
+```apptainer exec --writable [sandbox/] [command]```
 
 # SYNOPSIS
 
@@ -58,7 +58,7 @@ Execute a command within an Apptainer container.
 > Use minimal /dev and empty other directories.
 
 **--containall**, **-C**
-> Full isolation: contain plus clean environment and no PID namespace.
+> Full isolation: contain filesystems plus new PID and IPC namespaces and clean environment.
 
 **--cleanenv**, **-e**
 > Clean environment before running container.
@@ -72,8 +72,8 @@ Execute a command within an Apptainer container.
 **--home** _path_
 > Set custom home directory.
 
-**--pwd** _path_
-> Set initial working directory in container.
+**--cwd** _path_
+> Set initial working directory in container. (**--pwd** is a deprecated synonym.)
 
 **--net**
 > Enable network namespace.
@@ -88,7 +88,37 @@ Execute a command within an Apptainer container.
 > Add writable tmpfs overlay.
 
 **--no-mount** _type_
-> Disable specific mount (proc, sys, dev, devpts, home, tmp, cwd).
+> Disable a specific mount point. Valid values: proc, sys, dev, devpts, home, tmp, hostfs, cwd.
+
+**--no-home**
+> Do not mount the user's home directory into the container.
+
+**--writable**, **-w**
+> Make the container filesystem read-write (requires a writable image or sandbox directory).
+
+**--scratch**, **-S** _dir_
+> Include a scratch directory within the container that is linked to a temporary directory on the host.
+
+**--workdir**, **-W** _path_
+> Working directory used for /tmp, /var/tmp, and $HOME overrides when using **--contain** or **--scratch**.
+
+**--ipc**, **-i**
+> Run container in a new IPC namespace.
+
+**--pid**, **-p**
+> Run container in a new PID namespace.
+
+**--userns**, **-u**
+> Run container in a new user namespace.
+
+**--uts**
+> Run container in a new UTS namespace.
+
+**--no-eval**
+> Do not shell-evaluate environment variables or OCI CMD/ENTRYPOINT.
+
+**--fusemount** _spec_
+> Mount a FUSE filesystem inside the container using the format: _type:fuse_command container_path_.
 
 # DESCRIPTION
 
@@ -115,4 +145,4 @@ Apptainer is the continuation of the **Singularity** project after it joined the
 
 # SEE ALSO
 
-[apptainer](/man/apptainer)(1), [apptainer-shell](/man/apptainer-shell)(1), [apptainer-run](/man/apptainer-run)(1), [apptainer-build](/man/apptainer-build)(1), [apptainer-pull](/man/apptainer-pull)(1), [docker](/man/docker)(1)
+[apptainer](/man/apptainer)(1), [apptainer-shell](/man/apptainer-shell)(1), [apptainer-run](/man/apptainer-run)(1), [apptainer-build](/man/apptainer-build)(1), [apptainer-pull](/man/apptainer-pull)(1), [apptainer-overlay](/man/apptainer-overlay)(1), [docker](/man/docker)(1)

assets/commands/arping.md

@@ -4,25 +4,25 @@ Send ARP requests to discover and test network hosts
 
 # TLDR
 
-**Ping** host using ARP
+**Ping a host using ARP**
 
 ```sudo arping [192.168.1.1]```
 
-Ping with **specific interface**
+**Ping using a specific interface**
 
 ```sudo arping -I [eth0] [192.168.1.1]```
 
-Send **count** requests
+**Send a specific number of requests**
 
 ```sudo arping -c [5] [192.168.1.1]```
 
-**Detect duplicate** IP addresses
+**Detect duplicate IP addresses on the network**
 
 ```sudo arping -D [192.168.1.1]```
 
-Find **MAC address** of IP
+**Quit after first reply** (check if host is alive)
 
-```sudo arping -c 1 [192.168.1.1]```
+```sudo arping -f [192.168.1.1]```
 
 # SYNOPSIS
 

assets/commands/ascii-image-converter.md

@@ -1,38 +1,34 @@
 # TAGLINE
 
-Transform images into ASCII art for terminal display.
+Transform images into ASCII art for terminal display
 
 # TLDR
 
-**Convert** image to ASCII
+**Convert image to ASCII art**
 
 ```ascii-image-converter [image.png]```
 
-Convert with **color**
+**Convert with color output**
 
 ```ascii-image-converter -C [image.png]```
 
-Convert with **specific width**
+**Convert with specific width**
 
 ```ascii-image-converter -W [80] [image.png]```
 
-Save to **file**
+**Convert using braille characters**
 
-```ascii-image-converter [image.png] > [output.txt]```
+```ascii-image-converter -b [image.png]```
 
-Use **custom character map** (darkest to lightest)
+**Use a custom character map** (darkest to lightest)
 
 ```ascii-image-converter -m " .:-=+*#%@" [image.png]```
 
-Convert using **braille** characters
-
-```ascii-image-converter -b [image.png]```
-
-Set **specific dimensions** (width,height)
+**Fit output to terminal width**
 
-```ascii-image-converter -d [80],[40] [image.png]```
+```ascii-image-converter -f [image.png]```
 
-Save as **PNG image**
+**Save output as PNG image**
 
 ```ascii-image-converter -s [output_dir] -C [image.png]```
 

assets/commands/avahi-publish-address.md

@@ -40,9 +40,6 @@ Register mDNS hostname-to-address mappings
 **-d, --domain=**_DOMAIN_
 > Specify mDNS domain name to register in (defaults to .local)
 
-**-P, --proto=**_PROTO_
-> Specify IP protocol to publish (ipv4, ipv6, or all)
-
 **-R, --no-reverse**
 > Do not publish reverse DNS (PTR) entry for the address
 
@@ -63,7 +60,7 @@ The tool enables local network name resolution by advertising a hostname and its
 
 When invoked, **avahi-publish-address** connects to the Avahi daemon and maintains the hostname-to-address mapping until the process is terminated. The mapping is automatically withdrawn when the process exits.
 
-By default, the tool publishes both forward (name-to-address) and reverse (address-to-name) DNS entries. The reverse entry can be suppressed using the **--no-reverse** option. The protocol can be explicitly specified using **--proto** when needed, though the tool automatically detects the protocol from the address format.
+By default, the tool publishes both forward (name-to-address) and reverse (address-to-name) DNS entries. The reverse entry can be suppressed using the **--no-reverse** option. The protocol (IPv4 or IPv6) is automatically determined from the address format.
 
 The published hostname becomes discoverable by other mDNS-capable devices on the local network segment, including Linux systems with Avahi, macOS systems with Bonjour, and Windows systems with appropriate mDNS support.
 

assets/commands/b2-tools.md

@@ -1,38 +1,76 @@
 # TAGLINE
 
-Utilities for Backblaze B2 cloud storage operations.
+Official Backblaze B2 cloud storage command-line tool
 
 # TLDR
 
-**Upload** to B2
+**Authorize account**
 
-```b2-upload [bucketName] [file]```
+```b2 account authorize [applicationKeyId] [applicationKey]```
 
-**Download** from B2
+**Upload a file to a bucket**
 
-```b2-download [bucketName] [fileName] [destination]```
+```b2 file upload [bucketName] [localFile] [remoteName]```
 
-**List** files
+**Download a file from a bucket**
 
-```b2-list [bucketName]```
+```b2 file download [b2://bucketName/fileName] [localPath]```
+
+**List files in a bucket**
+
+```b2 ls [bucketName]```
+
+**Create a new bucket**
+
+```b2 bucket create [bucketName] [allPrivate]```
+
+**Sync a local directory to B2**
+
+```b2 sync [localDir] b2://[bucketName]/[prefix]```
 
 # SYNOPSIS
 
-**b2-tools** utilities for Backblaze B2
+**b2** _command_ [_options_]
+
+# PARAMETERS
+
+**account authorize** _keyID_ _key_
+> Authorize with B2 using application key.
+
+**file upload** _bucket_ _local_ _remote_
+> Upload a file to a bucket.
+
+**file download** _uri_ _local_
+> Download a file from B2.
+
+**ls** _bucket_
+> List files in a bucket.
+
+**bucket create** _name_ _type_
+> Create a bucket (allPrivate or allPublic).
+
+**bucket delete** _name_
+> Delete a bucket.
+
+**sync** _source_ _destination_
+> Synchronize files between local and B2 or between B2 buckets.
+
+**file hide** _bucket_ _file_
+> Hide a file (soft delete).
 
 # DESCRIPTION
 
-**b2-tools** is a collection of utilities for interacting with Backblaze B2 Cloud Storage. It provides simplified wrappers around common B2 operations for backup and file management.
+**b2-tools** (invoked as **b2**) is the official command-line tool for Backblaze B2 Cloud Storage. It provides file upload, download, sync, and bucket management operations for B2's S3-compatible object storage.
 
-The tools offer convenience functions built on top of the official B2 CLI.
+The sync command efficiently mirrors local directories to B2, uploading only changed files. B2 provides affordable cloud storage with free egress through Cloudflare's bandwidth alliance.
 
 # CAVEATS
 
-Less actively maintained than official b2 CLI. May not support all B2 features. Consider using official b2 command instead.
+Requires application key authorization before use. Large file uploads are automatically split into parts. The sync command compares by SHA1 hash, so the first sync of large directories can be slow. B2-native URIs use the `b2://` prefix.
 
 # HISTORY
 
-**b2-tools** was created as a community project to simplify B2 operations before the official CLI matured.
+**b2-tools** is the official CLI developed by **Backblaze** for their B2 Cloud Storage service. It was open-sourced on GitHub and is installable via pip as `b2`.
 
 # SEE ALSO
 

assets/commands/blkdiscard.md

@@ -12,46 +12,56 @@ Discard sectors on a storage device
 
 ```blkdiscard -s /dev/device```
 
-Discard first **100 MB**
+Discard first **100 MiB**
 
-```blkdiscard -l 100MB /dev/device```
+```blkdiscard -l 100M /dev/device```
+
+Discard in **512 MiB** steps (avoids long uninterruptible operations)
+
+```blkdiscard -p 512M /dev/device```
 
 # SYNOPSIS
 
 **blkdiscard** [_OPTIONS_] _device_
 
 # DESCRIPTION
 
-**blkdiscard** sends TRIM/DISCARD commands to a storage device to mark sectors as unused. This is particularly useful for SSDs as it allows the drive to optimize its internal storage and improve write performance.
+**blkdiscard** sends TRIM/DISCARD commands to a block device to mark sectors as unused. Unlike **fstrim**(8), it operates directly on the block device rather than a mounted filesystem. This is particularly useful for SSDs and thinly-provisioned storage. All data in the discarded region will be lost.
 
 # PARAMETERS
 
+**-o, --offset** _offset_
+> Byte offset into the device to start discarding. Must be aligned to the device sector size. Default is 0.
+
 **-l, --length** _size_
-> Number of bytes to discard from the offset
+> Number of bytes to discard from the offset. Must be aligned to the device sector size.
 
-**-o, --offset** _offset_
-> Byte offset into the device to start discarding
+**-p, --step** _size_
+> Discard this many bytes per iteration instead of all at once. Useful for avoiding long uninterruptible operations on large devices.
 
 **-s, --secure**
-> Perform a secure discard (hardware must support this)
+> Perform a secure discard. This tells the device to also erase any copies of the discarded data (e.g. in garbage collection). Requires device support.
 
 **-z, --zeroout**
-> Zero-fill rather than discard
+> Zero-fill the specified region rather than discarding it.
 
 **-f, --force**
-> Disable all checking
+> Disable exclusive-open check, allowing operation on mounted devices. Use with caution.
+
+**-q, --quiet**
+> Suppress warning messages.
 
 **-v, --verbose**
-> Print aligned offset and length
+> Print aligned offset and length values and progress information.
 
 # CAVEATS
 
-This operation destroys data and is irreversible. Not all devices support discard operations. Secure discard requires hardware support and may not be more secure than regular discard on all devices. The device must not be mounted.
+This operation destroys data and is irreversible. All data in the discarded region is lost. Not all devices support discard operations; on unsupported devices, blkdiscard exits with status 2 (since util-linux 2.39). Secure discard requires explicit hardware support and may not provide stronger guarantees than regular discard on all devices.
 
 # HISTORY
 
 **blkdiscard** is part of the **util-linux** package, providing SSD optimization and secure erase functionality.
 
 # SEE ALSO
 
-[fstrim](/man/fstrim)(8), [hdparm](/man/hdparm)(8), [blkid](/man/blkid)(8)
+[fstrim](/man/fstrim)(8), [hdparm](/man/hdparm)(8), [wipefs](/man/wipefs)(8), [blkid](/man/blkid)(8)