Improve command quality

Author: SimonSchubert

assets/commands/aa-status.md

@@ -43,7 +43,7 @@ Display the number of policies in **kill mode**
 # PARAMETERS
 
 **--enabled**
-> Returns error code if AppArmor is not active
+> Returns error code if AppArmor is not enabled
 
 **--profiled**
 > Shows count of loaded AppArmor policies
@@ -52,16 +52,19 @@ Display the number of policies in **kill mode**
 > Shows count of enforcing policies
 
 **--complaining**
-> Shows count of non-enforcing policies
+> Shows count of non-enforcing (complain mode) policies
 
 **--kill**
 > Shows count of enforcing policies that terminate tasks on violations
 
+**--prompt**
+> Shows count of enforcing policies with fallback to userspace mediation
+
 **--special-unconfined**
 > Shows count of unconfined mode policies
 
 **--process-mixed**
-> Shows processes confined by stacked profiles in different modes
+> Shows count of processes confined by profile stacks with profiles in different modes
 
 **--verbose**
 > Displays comprehensive AppArmor policy data (default behavior)
@@ -72,6 +75,24 @@ Display the number of policies in **kill mode**
 **--pretty-json**
 > Provides human and machine-readable JSON output
 
+**--count**
+> Shows only counts for selected information
+
+**--show** _TYPE_
+> Specify what to display: processes, profiles, or all (default: all)
+
+**--filter.mode** _REGEX_
+> Filter output by profile mode using a POSIX regular expression
+
+**--filter.profiles** _REGEX_
+> Filter output by confining profile name using a POSIX regular expression
+
+**--filter.pid** _REGEX_
+> Filter output by process PID using a POSIX regular expression
+
+**--filter.exe** _REGEX_
+> Filter output by executable name using a POSIX regular expression
+
 **--help**
 > Displays usage information
 

assets/commands/ansible-inventory.md

@@ -1,6 +1,6 @@
 # TAGLINE
 
-Inspect and display inventory data
+Show Ansible inventory information
 
 # TLDR
 
@@ -24,13 +24,21 @@ Output in **YAML** format
 
 ```ansible-inventory --list --yaml```
 
-List hosts matching **pattern**
+List hosts matching a **group pattern**
 
 ```ansible-inventory --graph [webservers]```
 
+**Export** inventory to a file
+
+```ansible-inventory --list --export --output [inventory.json]```
+
+Show inventory in **TOML** format
+
+```ansible-inventory --list --toml```
+
 # SYNOPSIS
 
-**ansible-inventory** [_-i inventory_] [_--list_|_--graph_|_--host host_]
+**ansible-inventory** [_options_] [_-i inventory_] [_--list_|_--graph_|_--host host_] [_group_]
 
 # DESCRIPTION
 

assets/commands/antlr.md

@@ -45,7 +45,7 @@ Generate parsers from grammar files
 > Location to search for imported grammars and token files
 
 **-Dlanguage=**_lang_
-> Target language: Java (default), Python3, CSharp, JavaScript, TypeScript, Go, Cpp, Swift, Dart, PHP
+> Target language: Java (default), Python3, CSharp, JavaScript, TypeScript, Go, Cpp, Swift, Dart, PHP. Use **-D**_option_**=**_value_ to override any grammar-level option.
 
 **-package** _name_
 > Package or namespace for generated code
@@ -83,6 +83,12 @@ Generate parsers from grammar files
 **-Xlog**
 > Create detailed log file (antlr-timestamp.log)
 
+**-Xexact-output-dir**
+> Place all output directly into **-o** directory regardless of paths or package structure
+
+**-XdbgST**
+> Launch StringTemplate visualizer on generated code
+
 # DESCRIPTION
 
 **ANTLR** (ANother Tool for Language Recognition) is a parser generator that creates lexers, parsers, and tree walkers from grammar files. It generates code that can read, process, and translate structured text or binary data.

assets/commands/browsh.md

@@ -8,25 +8,25 @@ Modern text-based web browser for terminals
 
 ```browsh```
 
-**Open specific URL**
+**Open a specific** URL
 
 ```browsh [https://example.com]```
 
-**Run in Docker container**
+**Run with a visible** Firefox **GUI** window instead of headless mode
 
-```docker run --rm -it browsh/browsh```
+```browsh --firefox.with-gui```
 
-**Take screenshot**
+**Use a custom** Firefox **binary** path
 
-```ALT+SHIFT+p```
+```browsh --firefox.path [/path/to/firefox]```
 
-**Toggle monochrome mode**
+**Run in HTTP server** mode for browser-based access
 
-```ALT+m```
+```browsh --http-server-mode```
 
-**Toggle mobile user agent**
+**Connect to an already running** Firefox instance
 
-```ALT+u```
+```browsh --firefox.use-existing```
 
 # SYNOPSIS
 
@@ -41,16 +41,25 @@ The browser supports HTML5, CSS3, JavaScript, images, WebGL content, and video p
 # PARAMETERS
 
 **--firefox.path** _path_
-> Path to Firefox binary
+> Path to Firefox executable. Default is "firefox".
+
+**--firefox.use-existing**
+> Connect to an already running Firefox instance instead of launching a new one. Firefox must have been started with the --marionette flag.
+
+**--firefox.with-gui**
+> Run Firefox with a visible GUI window instead of headless mode.
 
 **--http-server-mode**
-> Run as HTTP server for browser access
+> Run as an HTTP server for browser access.
 
 **--startup-url** _url_
-> URL to open on startup
+> URL to open on startup. Default is "https://google.com".
 
 **--time-limit** _seconds_
-> Limit session duration
+> Kill browsh after the specified number of seconds.
+
+**--debug**
+> Enable debug logging to ./debug.log.
 
 # KEY BINDINGS
 
@@ -83,4 +92,4 @@ Browsh was created as a modern replacement for text browsers like Lynx, capable
 
 # SEE ALSO
 
-[lynx](/man/lynx)(1), [w3m](/man/w3m)(1), [links](/man/links)(1), [firefox](/man/firefox)(1)
+[lynx](/man/lynx)(1), [w3m](/man/w3m)(1), [links](/man/links)(1), [elinks](/man/elinks)(1), [firefox](/man/firefox)(1)

assets/commands/chronic.md

@@ -30,7 +30,7 @@ Silences command output unless it fails
 
 # SYNOPSIS
 
-**chronic** [-ve] _command_ ...
+**chronic** [-ev] _command_ ...
 
 # DESCRIPTION
 

assets/commands/cinnamon.md

@@ -4,21 +4,25 @@ Traditional Linux desktop environment
 
 # TLDR
 
-**Start Cinnamon desktop (typically via display manager)**
+**Start Cinnamon** desktop (typically via display manager)
 
 ```cinnamon```
 
-**Replace the current window manager with Cinnamon**
+**Replace** the current window manager with Cinnamon
 
 ```cinnamon --replace```
 
-**Display version information**
+**Replace** the window manager without session manager connection
+
+```cinnamon --replace --sm-disable```
+
+**Display version** information
 
 ```cinnamon --version```
 
 # SYNOPSIS
 
-**cinnamon** [**--replace**] [**--display** _DISPLAY_]
+**cinnamon** [**--replace**] [**--sm-disable**] [**-d** _DISPLAY_] [**--screen** _SCREEN_]
 
 # DESCRIPTION
 
@@ -33,14 +37,26 @@ Cinnamon supports extensive customization through applets (panel widgets), deskl
 **--replace**
 > Replace the currently running window manager
 
-**--display** _DISPLAY_
+**-d**, **--display** _DISPLAY_
 > X display to use
 
-**--debug**
-> Enable debug output
+**--screen** _SCREEN_
+> X screen to use
+
+**--sm-disable**
+> Disable connection to the session manager
+
+**--sm-client-id** _ID_
+> Specify session management ID
+
+**--sm-save-file** _FILE_
+> Initialize session from a saved session file
+
+**--sync**
+> Make X calls synchronous
 
 **--version**
-> Display version information
+> Print version and exit
 
 # CAVEATS
 
@@ -54,4 +70,4 @@ Cinnamon does not support using a different window manager; Muffin is integral t
 
 # SEE ALSO
 
-[muffin](/man/muffin)(1), [nemo](/man/nemo)(1)
+[muffin](/man/muffin)(1), [nemo](/man/nemo)(1), [cinnamon-launcher](/man/cinnamon-launcher)(1)

assets/commands/dolt-clone.md

@@ -20,6 +20,14 @@ create local copy of remote database repository
 
 ```dolt clone -b [branch] [owner/repo]```
 
+**Shallow clone** with limited history depth
+
+```dolt clone --depth [1] [owner/repo]```
+
+**Clone a private** repository with authentication
+
+```dolt clone --user [username] [owner/repo]```
+
 # SYNOPSIS
 
 **dolt clone** [_options_] _repository_ [_directory_]
@@ -38,9 +46,15 @@ _DIRECTORY_
 **--remote** _NAME_
 > Name for the remote (default: origin).
 
+**--depth** _N_
+> Perform a shallow clone with history limited to N commits.
+
 **--single-branch**
 > Clone only one branch.
 
+**--user** _USERNAME_
+> User name for authentication with the remote. Password is read from the DOLT_REMOTE_PASSWORD environment variable.
+
 **--help**
 > Display help information.
 
@@ -62,4 +76,4 @@ dolt clone is part of **Dolt**, implementing Git's clone semantics for database
 
 # SEE ALSO
 
-[dolt](/man/dolt)(1), [dolt-push](/man/dolt-push)(1), [dolt-pull](/man/dolt-pull)(1), [git-clone](/man/git-clone)(1)
+[dolt](/man/dolt)(1), [dolt-fetch](/man/dolt-fetch)(1), [dolt-branch](/man/dolt-branch)(1), [git-clone](/man/git-clone)(1)

assets/commands/exec.md

@@ -4,7 +4,7 @@ shell builtin to replace process with command
 
 # TLDR
 
-**Execute** a specific command
+**Execute** a specific command, **replacing** the current shell
 
 ```exec [command -with -flags]```
 
@@ -16,35 +16,53 @@ Execute as **login shell**
 
 ```exec -l [command -with -flags]```
 
-Execute with **different name**
+Execute with a **different name** as argv[0]
 
 ```exec -a [name] [command -with -flags]```
 
+**Redirect** all shell **stdout** to a file
+
+```exec >[path/to/logfile]```
+
+**Redirect** both **stdout and stderr** to a file
+
+```exec >[path/to/logfile] 2>&1```
+
+Open a file on **file descriptor** 3 for reading
+
+```exec 3<[path/to/file]```
+
+**Close** file descriptor 3
+
+```exec 3>&-```
+
 # SYNOPSIS
 
-**exec** [_options_] [_command_] [_arguments_]
+**exec** [_-cl_] [_-a name_] [_command_] [_arguments_] [_redirection ..._]
 
 # PARAMETERS
 
 **-c**
-> Execute with mostly empty environment
+> Execute the command with a mostly empty environment, clearing inherited environment variables.
 
 **-l**
-> Pass command as login shell
+> Place a dash at the beginning of argv[0], causing the command to behave as a login shell.
 
 **-a** _name_
-> Pass name as argv[0] to command
+> Pass _name_ as argv[0] to the executed command instead of the actual command name.
 
 # DESCRIPTION
 
 **exec** replaces the current shell process with the specified command without creating a child process. When exec completes, the shell session ends because the shell process no longer exists.
 
-Built-in shell command commonly used in shell scripts and wrapper scripts.
+If no command is specified but redirections are provided, the redirections take effect in the current shell. This allows redirecting stdin, stdout, or stderr for all subsequent commands, and opening or closing arbitrary file descriptors.
+
+If the command cannot be executed, a non-interactive shell exits unless the **execfail** shell option is set. An interactive shell does not exit if exec fails.
 
 # CAVEATS
 
-Shell built-in command. The shell terminates after exec completes. File descriptors can be redirected before exec. Used in init scripts and process management.
+Shell built-in command. The shell terminates after exec completes, so any commands after exec in a script will not run. File descriptor redirections without a command persist in the current shell. Behavior may vary slightly between bash, zsh, and other POSIX shells.
 
 # SEE ALSO
 
-[bash](/man/bash)(1), [sh](/man/sh)(1)
+[bash](/man/bash)(1), [sh](/man/sh)(1), [env](/man/env)(1), [zsh](/man/zsh)(1)