Improve command quality

Author: SimonSchubert

assets/commands/arduino-cli.md

@@ -18,7 +18,7 @@ Official command-line tool for Arduino development
 
 **Compile and upload** in one command
 
-```arduino-cli compile --fqbn [arduino:avr:uno] --port [/dev/ttyACM0] --upload [path/to/sketch]```
+```arduino-cli compile --fqbn [arduino:avr:uno] --port [/dev/ttyACM0] -u [path/to/sketch]```
 
 **Create a new sketch**
 
@@ -36,6 +36,14 @@ Official command-line tool for Arduino development
 
 ```arduino-cli lib install "[Servo]"```
 
+**Open serial monitor** on a port
+
+```arduino-cli monitor --port [/dev/ttyACM0]```
+
+**Update platform index** and upgrade all installed platforms
+
+```arduino-cli core update-index && arduino-cli core upgrade```
+
 # SYNOPSIS
 
 **arduino-cli** _command_ [_flags_]
@@ -69,15 +77,27 @@ Official command-line tool for Arduino development
 **lib search** _query_
 > Search for libraries
 
+**lib list**
+> List installed libraries
+
 **monitor**
 > Open serial monitor to communicate with the board
 
+**config init**
+> Create a default configuration file
+
+**core upgrade**
+> Upgrade all installed board platforms to the latest version
+
 **-b**, **--fqbn** _string_
 > Fully Qualified Board Name (e.g., arduino:avr:uno)
 
 **-p**, **--port** _string_
 > Port address (e.g., /dev/ttyACM0 or COM3)
 
+**-u**, **--upload**
+> Upload the binary after compilation (use with compile)
+
 **-e**, **--export-binaries**
 > Export compiled binaries to the sketch folder
 
@@ -87,6 +107,9 @@ Official command-line tool for Arduino development
 **-t**, **--verify**
 > Verify uploaded binary after upload
 
+**-v**, **--verbose**
+> Enable verbose output during compile or upload
+
 **-P**, **--programmer** _name_
 > Use a specific programmer for upload
 

assets/commands/aur.md

@@ -20,13 +20,21 @@ Collection of scripts for managing AUR packages through a local repository.
 
 ```aur sync -u```
 
-**Clean** build files after install
+**Clean** build files after syncing
 
-```aur sync -C [package]```
+```aur sync -c [package]```
 
-Install a package **without confirmation prompts**
+Install a package **without review prompts**
 
-```aur sync --noview -n [package]```
+```aur sync --no-view --no-confirm [package]```
+
+**Fetch** package sources from AUR without building
+
+```aur fetch [package]```
+
+Show the **dependency tree** for a package
+
+```aur depends [package]```
 
 # SYNOPSIS
 
@@ -60,7 +68,7 @@ Unlike AUR helpers that install packages directly, aurutils maintains a proper l
 
 # CAVEATS
 
-Requires a local repository to be configured in **/etc/pacman.conf**. Uses **vifm** by default for PKGBUILD review (can be changed). Building occurs in a clean chroot, requiring **devtools** package. Initial setup is more complex than simple AUR helpers.
+Requires a local repository to be configured in **/etc/pacman.conf**. Uses **vifm** by default for PKGBUILD review (configurable via **AUR_PAGER** environment variable). Building occurs in a clean chroot, requiring the **devtools** package. Initial setup is more involved than simple AUR helpers like yay or paru.
 
 # HISTORY
 

assets/commands/aws-budgets.md

@@ -14,7 +14,7 @@ Manage cost budgets and spending alerts.
 
 **List all budgets** for an account
 
-```aws budgets describe-budgets --account-id [123456789012]```
+```aws budgets describe-budgets --account-id [123456789012] --max-results [100]```
 
 **Get details** of a specific budget
 
@@ -28,9 +28,9 @@ Manage cost budgets and spending alerts.
 
 ```aws budgets delete-budget --account-id [123456789012] --budget-name "[MyBudget]"```
 
-**Create a budget action** (auto-response)
+**List budget actions** for a specific budget
 
-```aws budgets create-budget-action --account-id [123456789012] --budget-name "[MyBudget]" --action-type APPLY_IAM_POLICY --action-threshold file://[threshold.json]```
+```aws budgets describe-budget-actions-for-budget --account-id [123456789012] --budget-name "[MyBudget]"```
 
 # SYNOPSIS
 
@@ -77,6 +77,9 @@ Manage cost budgets and spending alerts.
 **--new-budget** _json_
 > Updated budget specification
 
+**--max-results** _integer_
+> Maximum number of results to return (for list operations)
+
 # BUDGET JSON STRUCTURE
 
 ```json
@@ -102,12 +105,12 @@ Time units include DAILY, MONTHLY, QUARTERLY, and ANNUALLY. If no start date is
 
 # CAVEATS
 
-Budgets have a processing delay of up to 24 hours for cost data. Budget limits are soft limits that trigger alerts but don't automatically stop spending. Free tier includes 2 budgets; additional budgets incur charges. Account ID must be specified explicitly in CLI commands.
+Budgets have a processing delay of up to 24 hours for cost data. Budget limits are soft limits that trigger alerts but don't automatically stop spending unless budget actions are configured. Free tier includes 2 action-enabled budgets per account; additional budgets incur charges. Account ID must be specified explicitly in CLI commands.
 
 # HISTORY
 
 **AWS Budgets** launched in **January 2017** as part of AWS Cost Management tools. It evolved from the earlier Billing Alerts feature. Budget actions for automated responses were added in **2020**, enabling automatic cost control measures beyond just notifications.
 
 # SEE ALSO
 
-[aws](/man/aws)(1), [aws-ce](/man/aws-ce)(1), [aws-organizations](/man/aws-organizations)(1)
+[aws](/man/aws)(1), [aws-ce](/man/aws-ce)(1), [aws-sns](/man/aws-sns)(1), [aws-organizations](/man/aws-organizations)(1)

assets/commands/blastdbcmd.md

@@ -58,43 +58,68 @@ The tool is part of the NCBI BLAST+ suite and works with databases created by **
 > File containing list of sequence identifiers
 
 **-out** _file_
-> Output file (default: stdout)
+> Output file (default: stdout).
 
 **-outfmt** _format_
-> Custom output format string
+> Custom output format string using % tokens.
 
 **-info**
-> Display database information
+> Display database information (type, number of sequences, total length, date).
 
 **-list** _path_
-> List databases in specified path
+> List databases in specified path.
 
 **-recursive**
-> Search directories recursively (with -list)
+> Search directories recursively (with -list).
 
 **-show_blastdb_search_path**
-> Display BLAST database search paths
+> Display BLAST database search paths.
+
+**-dbtype** _type_
+> Database type: nucl (nucleotide) or prot (protein). Needed when both types share a name.
+
+**-target_only**
+> Retrieve only target sequences (no redundant group members).
 
 **-tax_info**
-> Display taxonomy information (requires taxonomy database)
+> Display taxonomy information (requires taxonomy database).
 
 **-range** _start-stop_
-> Extract subsequence range
+> Extract subsequence range (1-based, inclusive).
+
+**-strand** _strand_
+> Strand to retrieve: plus or minus (nucleotide only).
+
+**-line_length** _N_
+> Line length for FASTA output (default: 80). Use 0 for single-line sequences.
+
+**-long_seqids**
+> Use long sequence identifiers including database and accession.version.
 
 # OUTPUT FORMAT TOKENS
 
 **%a** - Accession
-**%t** - Title
-**%s** - Sequence
+**%g** - GI number
+**%o** - OID (ordinal ID)
+**%t** - Title (definition line)
+**%s** - Sequence data
 **%l** - Sequence length
 **%T** - Taxonomy ID
 **%S** - Scientific name
 **%L** - Common name
+**%m** - Masking data
+**%h** - Hash value
+**%e** - Membership integer
+
+# ENVIRONMENT
+
+**BLASTDB**
+> Colon-separated list of directories to search for BLAST databases.
 
 # CAVEATS
 
-Requires pre-formatted BLAST databases. Taxonomy information requires the BLAST taxonomy database to be installed. Large extractions may require significant time and disk space.
+Requires pre-formatted BLAST databases created by **makeblastdb** or downloaded from NCBI. Taxonomy information requires the BLAST taxonomy database (taxdb.btd/bti) to be installed. Large extractions may require significant time and disk space. The **-range** option uses 1-based inclusive coordinates.
 
 # SEE ALSO
 
-[makeblastdb](/man/makeblastdb)(1), [blastn](/man/blastn)(1), [blastp](/man/blastp)(1), [blastx](/man/blastx)(1)
+[makeblastdb](/man/makeblastdb)(1), [blastn](/man/blastn)(1), [blastp](/man/blastp)(1), [blastx](/man/blastx)(1), [tblastn](/man/tblastn)(1)

assets/commands/ccache.md

@@ -8,6 +8,10 @@ compiler cache for faster recompilation
 
 ```ccache -s```
 
+**Show verbose cache statistics** including hit rates
+
+```ccache -sv```
+
 **Clear the cache**
 
 ```ccache -C```
@@ -16,19 +20,23 @@ compiler cache for faster recompilation
 
 ```ccache -M [5G]```
 
-**Show configuration**
+**Show current configuration**
 
 ```ccache -p```
 
-**Zero statistics**
+**Zero statistics counters**
 
 ```ccache -z```
 
 **Run compiler through ccache**
 
 ```ccache [gcc] -c [file.c]```
 
-**Show cache directory**
+**Set a configuration value**
+
+```ccache -o [max_size=10G]```
+
+**Show the cache directory path**
 
 ```ccache -k cache_dir```
 
@@ -47,31 +55,43 @@ Supports GCC, Clang, MSVC and similar compilers for C, C++, Objective-C, CUDA, a
 # PARAMETERS
 
 **-s**, **--show-stats**
-> Show cache statistics
+> Show cache statistics summary.
+
+**-sv**
+> Show verbose statistics including hit/miss details.
 
 **-z**, **--zero-stats**
-> Zero statistics counters
+> Zero statistics counters.
 
 **-C**, **--clear**
-> Clear entire cache
+> Clear entire cache.
 
 **-M**, **--max-size** _size_
-> Set maximum cache size (e.g., 5G, 500M)
+> Set maximum cache size (e.g., 5G, 500M).
+
+**-F**, **--max-files** _count_
+> Set maximum number of files in the cache.
 
 **-p**, **--show-config**
-> Show current configuration
+> Show current configuration with origins.
 
 **-k**, **--get-config** _key_
-> Get configuration value
+> Get a single configuration value.
 
 **-o**, **--set-config** _key=value_
-> Set configuration value
+> Set a configuration value persistently.
+
+**-d**, **--directory** _path_
+> Operate on specified cache directory instead of the default.
 
 **--cleanup**
-> Clean up cache to stay within size limit
+> Clean up cache to stay within size limit.
+
+**--evict-older-than** _age_
+> Remove files older than given age (e.g., 30d, 24h).
 
 **-V**, **--version**
-> Show version
+> Show version.
 
 # SETUP
 
@@ -95,14 +115,28 @@ export CXX="ccache g++"
 **/etc/ccache.conf**
 > System-wide configuration defaults.
 
+# ENVIRONMENT
+
+**CCACHE_DIR**
+> Path to the cache directory (default: ~/.cache/ccache or ~/.ccache).
+
+**CCACHE_CONFIGPATH**
+> Path to the configuration file.
+
+**CCACHE_MAXSIZE**
+> Maximum cache size (overrides config file).
+
+**CCACHE_DISABLE** / **CCACHE_NODISABLE**
+> Disable or re-enable ccache.
+
 # REMOTE CACHING
 
 Supports remote caching via HTTP, Redis, or NFS for sharing across build machines.
 
 # CAVEATS
 
-Only caches single-file compilations. Multi-file compilation and linking fall back to real compiler. Produces identical output to direct compilation.
+Only caches single-file compilations. Multi-file compilation and linking fall back to the real compiler. Produces identical output to direct compilation. Precompiled headers require special configuration.
 
 # SEE ALSO
 
-[gcc](/man/gcc)(1), [clang](/man/clang)(1), [make](/man/make)(1), [distcc](/man/distcc)(1)
+[gcc](/man/gcc)(1), [clang](/man/clang)(1), [make](/man/make)(1), [distcc](/man/distcc)(1), [sccache](/man/sccache)(1), [cmake](/man/cmake)(1)