Improve command detail quality

Author: SimonSchubert

assets/commands/Xnest.md

@@ -1,6 +1,6 @@
 # TAGLINE
 
-Nested X server within a window
+A nested X server that runs as a client window
 
 # TLDR
 
@@ -31,10 +31,10 @@ Nested X server within a window
 # PARAMETERS
 
 **-display** _name_
-> Parent X server to connect to.
+> Parent X server to connect to. Defaults to DISPLAY environment variable.
 
 **-geometry** _WxH+X+Y_
-> Window geometry for nested server.
+> Window geometry for the nested server.
 
 **-scrns** _num_
 > Number of screens to create.
@@ -43,21 +43,27 @@ Nested X server within a window
 > Default color depth.
 
 **-fullscreen**
-> Run fullscreen on parent display.
+> Run fullscreen on the parent display.
 
 **-bw** _n_
 > Border width in pixels.
 
 **-name** _string_
-> Window name.
+> Window name for the nested server.
+
+**-sss**
+> Enable separate screen saver for each screen.
+
+**-sync**
+> Synchronize window and graphics operations with the parent server. Useful for debugging but significantly slows performance.
 
 # DESCRIPTION
 
-**Xnest** is a nested X server that runs as a window within another X server. It appears as a regular X client to the parent server while providing a complete X server environment to its own clients.
+**Xnest** is both an X client and an X server. It runs as a window within another X server (the parent), appearing as a regular X client to the parent while providing a complete X server environment to its own clients.
 
-Applications connect to Xnest using its display number (e.g., :1) and receive a fully functional X environment. This enables testing window managers, running isolated X sessions, or displaying remote X applications in a contained window.
+Applications connect to Xnest using its display number (e.g., `:1`) and receive a fully functional X environment. Multiple screens can be referenced by the number after the dot in the display name (e.g., `xterm -display :1.1` for the second screen). This enables testing window managers, running isolated X sessions, or displaying remote X applications in a contained window.
 
-Xnest is resource-intensive since most requests pass through to the parent server. For better performance and modern extension support, Xephyr is recommended as a replacement.
+Xnest manages fonts by loading them locally and passing the font name to the real server. For better performance and modern X extension support, **Xephyr** is recommended as a replacement.
 
 # CAVEATS
 
@@ -69,4 +75,4 @@ Lacks modern X extensions (XRender, Composite, RandR). No hardware acceleration.
 
 # SEE ALSO
 
-[Xephyr](/man/Xephyr)(1), [Xvfb](/man/Xvfb)(1), [Xorg](/man/Xorg)(1), [startx](/man/startx)(1)
+[Xvfb](/man/Xvfb)(1), [Xorg](/man/Xorg)(1), [startx](/man/startx)(1)

assets/commands/abrt-cli.md

@@ -4,64 +4,81 @@ command-line interface for automatic bug reporting
 
 # TLDR
 
-**List** detected problems
+**List all detected problems**
 
 ```abrt-cli list```
 
-Show **details** of a specific problem
+**List only unreported problems**
 
-```abrt-cli info [problem_id]```
+```abrt-cli list -n```
 
-**Remove** a crash report
+**Show detailed info about a specific problem**
 
-```abrt-cli remove [problem_id]```
+```abrt-cli info [problem_dir]```
 
-**Report** a problem to the configured bug tracker
+**Report a problem to the configured bug tracker**
 
-```abrt-cli report [problem_id]```
+```abrt-cli report [problem_dir]```
 
-Generate a report for **debugging** manually
+**Remove a crash report**
 
-```abrt-cli report --analyze [problem_id]```
+```abrt-cli remove [problem_dir]```
+
+**Show count of detected problems**
+
+```abrt-cli status```
+
+**Enable or disable auto-reporting**
+
+```abrt-cli auto-report [on|off]```
 
 # SYNOPSIS
 
-**abrt-cli** [_list_] [_info_] [_report_] [_remove_] [_problem_id_]
+**abrt-cli** _command_ [_options_] [_problem_dir_]
 
 # DESCRIPTION
 
-**abrt-cli** is the command-line interface for the Automatic Bug Reporting Tool (ABRT) used on Fedora-based systems. It detects, analyzes, and reports application crashes, sending them to bug tracking systems like Bugzilla.
+**abrt-cli** is the command-line interface for the Automatic Bug Reporting Tool (ABRT) used on Fedora and RHEL systems. It manages detected application crashes, kernel oopses, and other software defects, allowing users to list, inspect, report, and remove problem data.
 
 Crash information includes identifiers, timestamps, package names, crash reasons, and report status/URLs when applicable.
 
 # PARAMETERS
 
-**list**
-> Display all detected crashes on the machine
+**list** [**-n**] [**--detailed**] [**--since** _NUM_] [**--until** _NUM_]
+> Display detected crashes. **-n** shows only unreported problems. **--detailed** shows full report. **--since**/**--until** filter by timestamp.
+
+**info** [**-d**] [**-s** _SIZE_] _PROBLEM_DIR_
+> Show details of a specific problem. **-d** for detailed output. **-s** abridges text larger than SIZE bytes.
+
+**report** [**--delete**] [**--unsafe**] _PROBLEM_DIR_
+> Submit a problem for analysis and reporting. **--delete** removes the problem dir after reporting. **--unsafe** ignores security checks.
+
+**remove** _PROBLEM_DIR_
+> Delete a problem from the system.
 
-**list -d ID_OR_PATH**
-> Display detailed report for a specific problem
+**status** [**-b**] [**--since** _NUM_]
+> Show count of detected problems. **-b** prints only the count (bare mode).
 
-**info PROBLEM_ID**
-> Show details of a specific problem
+**process** [**--since** _NUM_] [**--unsafe**] _PROBLEM_DIR_
+> Analyze and report problems in batch.
 
-**report PROBLEM_ID**
-> Submit a problem for analysis and reporting
+**auto-report** [**on**|**off**]
+> Enable or disable automatic reporting of detected problems.
 
-**report -a, --analyze PROBLEM_ID**
-> Generate a report for manual debugging
+**-v**, **--verbose**
+> Increase verbosity.
 
-**remove PROBLEM_ID**
-> Delete a problem from the system
+**-V**, **--version**
+> Show version information.
 
 # CAVEATS
 
-The reporting workflow opens a text editor. Editor selection uses environment variables in order: **$ABRT_EDITOR**, **$VISUAL**, **$EDITOR**, or defaults to **vi**.
+The reporting workflow opens a text editor. Editor selection uses environment variables in order: **$ABRT_EDITOR**, **$VISUAL**, **$EDITOR**, or defaults to **vi**. The ABRT daemon must be running for new problems to be detected.
 
 # HISTORY
 
-Part of **ABRT** (Automatic Bug Reporting Tool), developed by Red Hat for Fedora-based systems starting around **2009** as a replacement for bug-buddy.
+Part of **ABRT** (Automatic Bug Reporting Tool), developed by **Red Hat** for Fedora-based systems starting around **2009** as a replacement for bug-buddy.
 
 # SEE ALSO
 
-[abrt-action-analyze-backtrace](/man/abrt-action-analyze-backtrace)(1), [abrt-action-analyze-c](/man/abrt-action-analyze-c)(1), [journalctl](/man/journalctl)(1)
+[abrt](/man/abrt)(1), [abrt-action-analyze-backtrace](/man/abrt-action-analyze-backtrace)(1), [abrt-action-analyze-c](/man/abrt-action-analyze-c)(1), [coredumpctl](/man/coredumpctl)(1), [journalctl](/man/journalctl)(1)

assets/commands/airserv-ng.md

@@ -1,46 +1,56 @@
 # TAGLINE
 
-Serve a wireless card over TCP/IP for remote access
+Wireless card server for remote access over TCP/IP
 
 # TLDR
 
-**Start** the wireless server
+**Start the wireless server on an interface with a specific channel and port**
 
-```sudo airserv-ng -p [666] -c [6] -d [wlan0mon]```
+```sudo airserv-ng -d [wlan0mon] -c [6] -p [666]```
 
-Start on **specific interface**
+**Start the server on the default port**
 
-```sudo airserv-ng -d [wlan0] -p [666]```
+```sudo airserv-ng -d [wlan0mon]```
+
+**Start with verbose debug output**
+
+```sudo airserv-ng -d [wlan0mon] -v [3]```
 
 # SYNOPSIS
 
-**airserv-ng** [_-d device_] [_-c channel_] [_-p port_]
+**airserv-ng** [_options_]
 
-# DESCRIPTION
+# PARAMETERS
 
-**airserv-ng** is a wireless card server that allows remote access to a wireless interface over TCP/IP. This enables using aircrack-ng tools on one computer while the wireless card is physically connected to another.
+**-d** _IFACE_
+> Wireless interface to serve (required).
 
-The server provides network access to the wireless interface, and clients connect using the interface specification format **ip:port** instead of a local device name.
+**-c** _CHAN_
+> Lock the interface to a specific channel.
 
-# PARAMETERS
+**-p** _PORT_
+> TCP port to listen on (default: 666).
+
+**-v** _LEVEL_
+> Debug level. Level 1 shows client connect/disconnect (default), higher levels show more detail.
 
-**-d** _device_
-> Wireless interface to serve
+**-h**
+> Display help information.
+
+# DESCRIPTION
 
-**-c** _channel_
-> Lock interface to specific channel
+**airserv-ng** is a wireless card server that allows multiple wireless application programs to independently use a wireless card via a client-server TCP network connection. All operating system and wireless card driver specific code is incorporated into the server.
 
-**-p** _port_
-> TCP port to listen on (default: 666)
+Clients connect by specifying **host:port** as the interface name instead of a local device. This enables using aircrack-ng tools on one machine while the wireless card is physically connected to another.
 
 # CAVEATS
 
-No built-in authentication or encryption; use SSH tunneling for secure remote access. Network latency may affect real-time packet injection. The server must have the wireless card in monitor mode.
+No built-in authentication or encryption; use SSH tunneling for secure remote access. Network latency may affect real-time packet injection. The wireless card should typically be in monitor mode before starting the server.
 
 # HISTORY
 
-**airserv-ng** was created as part of the aircrack-ng suite to enable distributed wireless testing scenarios where the wireless hardware and analysis software are on different machines.
+**airserv-ng** was created as part of the **aircrack-ng** suite to enable distributed wireless testing scenarios where the wireless hardware and analysis software run on different machines.
 
 # SEE ALSO
 
-[aircrack-ng](/man/aircrack-ng)(1), [airodump-ng](/man/airodump-ng)(1)
+[aircrack-ng](/man/aircrack-ng)(1), [airodump-ng](/man/airodump-ng)(1), [aireplay-ng](/man/aireplay-ng)(1), [airmon-ng](/man/airmon-ng)(1)

assets/commands/apache.md

@@ -4,15 +4,15 @@ Control the Apache HTTP web server
 
 # TLDR
 
-**Start Apache** in the foreground
+**Start Apache** daemon
 
 ```apachectl start```
 
-**Stop Apache** gracefully
+**Stop Apache** gracefully (finish current requests)
 
 ```apachectl graceful-stop```
 
-**Restart Apache** gracefully (finish current requests)
+**Gracefully restart** Apache (finish current requests, then restart)
 
 ```apachectl graceful```
 
@@ -28,13 +28,13 @@ Control the Apache HTTP web server
 
 ```apachectl -l```
 
-**Show loaded modules**
+**Show all loaded modules** (static and shared)
 
 ```apachectl -M```
 
-**Display full status** (requires mod_status)
+**Show parsed virtual host settings**
 
-```apachectl fullstatus```
+```apachectl -S```
 
 # SYNOPSIS
 
@@ -51,7 +51,7 @@ Control the Apache HTTP web server
 > Stop the daemon immediately.
 
 **restart**
-> Restart the daemon (abort current connections).
+> Restart the daemon (aborts current connections).
 
 **graceful**
 > Gracefully restart (finish current requests, then restart).
@@ -62,6 +62,9 @@ Control the Apache HTTP web server
 **configtest**
 > Check configuration file syntax.
 
+**fullstatus**
+> Display full server status (requires **mod_status** and a text-based browser).
+
 **-v**
 > Show version number.
 
@@ -75,7 +78,7 @@ Control the Apache HTTP web server
 > List all loaded modules (static and shared).
 
 **-t**
-> Test configuration syntax.
+> Test configuration syntax (same as configtest).
 
 **-S**
 > Show parsed virtual host settings.
@@ -88,31 +91,17 @@ Control the Apache HTTP web server
 
 # DESCRIPTION
 
-**Apache HTTP Server** (httpd) is the world's most widely used web server software. It serves static and dynamic content over HTTP/HTTPS, supporting virtual hosting, URL rewriting, authentication, and extensive module-based extensibility.
-
-The **apachectl** script provides a convenient interface for controlling the Apache daemon. It wraps the **httpd** binary with init-script-style commands for starting, stopping, and managing the server.
-
-Configuration is primarily done through **httpd.conf** and related files in the Apache configuration directory. The modular architecture allows enabling features like SSL/TLS (mod_ssl), URL rewriting (mod_rewrite), proxying (mod_proxy), and dynamic content via CGI, PHP, or mod_wsgi.
-
-Apache supports two primary Multi-Processing Modules: **prefork** (process-based) for compatibility and **event/worker** (threaded) for higher concurrency.
-
-# CONFIGURATION
-
-**/etc/httpd/conf/httpd.conf**
-> Main configuration file on RHEL/CentOS/Fedora systems.
+**Apache HTTP Server** (httpd) is one of the most widely used web server software packages. It serves static and dynamic content over HTTP/HTTPS, supporting virtual hosting, URL rewriting, authentication, and extensive module-based extensibility.
 
-**/etc/apache2/apache2.conf**
-> Main configuration file on Debian/Ubuntu systems.
+The **apachectl** script provides a convenient interface for controlling the Apache daemon. It can operate as a simple front-end to the **httpd** command, or act as a SysV init script translating one-word arguments like **start**, **restart**, and **stop** into appropriate signals.
 
-**/etc/httpd/conf.d/**
-> Directory for additional configuration files on RHEL-based systems.
+Configuration is primarily done through **httpd.conf** and related files. The modular architecture allows enabling features like SSL/TLS (mod_ssl), URL rewriting (mod_rewrite), proxying (mod_proxy), and dynamic content via CGI, PHP, or mod_wsgi.
 
-**/etc/apache2/sites-available/**
-> Virtual host configuration files on Debian-based systems.
+Apache supports multiple Multi-Processing Modules: **prefork** (process-based) for compatibility, **worker** (threaded), and **event** (threaded with improved keep-alive handling) for higher concurrency.
 
 # CAVEATS
 
-Configuration changes require a restart or reload. Syntax errors in configuration files prevent startup; always run **configtest** first. The **graceful** restart is preferred for production to avoid dropping active connections. Log files can grow large and require rotation.
+Configuration changes require a restart or reload. Syntax errors in configuration files prevent startup; always run **configtest** first. The **graceful** restart is preferred for production to avoid dropping active connections. Log files can grow large and require rotation. The **apachectl** script returns exit code 0 on success and >0 on error.
 
 # HISTORY