Improve command quality

Author: SimonSchubert

assets/basics/index.txt

@@ -1,12 +1,10 @@
-.DS_Store
 aitools.md
 compressionarchiving.md
 cryptocurrencies.md
 emacstexteditor.md
 filesfolders.md
 git.md
 hackingtools.md
-index.txt
 input.md
 json.md
 microtexteditor.md
@@ -27,4 +25,4 @@ textprocessing.md
 tmux.md
 usersgroups.md
 videoaudio.md
-vimtexteditor.md
+vimtexteditor.md

assets/commands/NetworkManager.conf.md

@@ -30,25 +30,61 @@ main configuration file for NetworkManager
 > Main configuration section.
 
 **plugins**
-> Connection plugins to use.
+> System settings plugin names (keyfile is always appended).
 
 **dns**
-> DNS processing mode.
+> DNS processing mode (default, dnsmasq, systemd-resolved, none).
+
+**dhcp**
+> DHCP client to use (internal, dhcpcd).
+
+**hostname-mode**
+> How the transient hostname is managed (default, dhcp, none).
+
+**no-auto-default**
+> Devices for which no automatic default connection is created.
+
+**[keyfile]**
+> Keyfile plugin-specific settings.
+
+**[ifupdown]**
+> Settings for the ifupdown plugin (Debian/Ubuntu).
+
+**managed**
+> Whether devices listed in /etc/network/interfaces are managed by NetworkManager (true/false).
 
 **[connection]**
-> Default connection settings.
+> Default values for connection properties.
 
 **[device]**
-> Device-specific settings.
+> Per-device persistent configuration.
 
 **[logging]**
-> Logging configuration.
+> Controls logging output.
+
+**level**
+> Log verbosity level (OFF, ERR, WARN, INFO, DEBUG, TRACE).
+
+**domains**
+> Filter log messages by topic (PLATFORM, WIFI, DHCP4, DNS, VPN, etc.).
+
+**[connectivity]**
+> Optional internet connectivity checking.
+
+**uri**
+> URL to check for connectivity.
+
+**interval**
+> Check frequency in seconds (default: 300).
+
+**[global-dns]**
+> System-wide DNS configuration that overrides per-connection settings.
 
 # DESCRIPTION
 
-**NetworkManager.conf** is the main configuration file for NetworkManager. It controls DNS handling, plugins, device management, and various global settings.
+**NetworkManager.conf** is the main configuration file for NetworkManager. It controls DNS handling, plugins, device management, and various global settings. The file uses an ini-style key file format with sections of key-value pairs.
 
-Additional configuration can be placed in /etc/NetworkManager/conf.d/.
+Additional configuration can be placed in /etc/NetworkManager/conf.d/ as drop-in files.
 
 # EXAMPLE CONFIG
 
@@ -73,16 +109,16 @@ level=WARN
 # DNS MODES
 
 ```
-default      - Use resolv.conf
-dnsmasq      - Local dnsmasq
-systemd-resolved - Use resolved
-none         - No DNS management
+default          - Update resolv.conf directly
+dnsmasq          - Run local dnsmasq instance
+systemd-resolved - Use systemd-resolved
+none             - No DNS management
 ```
 
 # CAVEATS
 
-Syntax errors may prevent NM from starting. Use conf.d/ for drop-in files. Restart NM after changes.
+Syntax errors may prevent NetworkManager from starting. Use conf.d/ for drop-in files. Restart NetworkManager after changes with `systemctl restart NetworkManager`.
 
 # SEE ALSO
 
-[NetworkManager](/man/NetworkManager)(8), [nmcli](/man/nmcli)(1), [nm-settings](/man/nm-settings)(5)
+[NetworkManager](/man/NetworkManager)(8), [nmcli](/man/nmcli)(1), [nmtui](/man/nmtui)(1), [nm-settings](/man/nm-settings)(5)

assets/commands/aa-mergeprof.md

@@ -1,41 +1,41 @@
 # TAGLINE
 
-Merge AppArmor profile files into the profile directory
+Merge AppArmor security profiles
 
 # TLDR
 
 **Merge** one or more profile files into the default profile directory
 
 ```sudo aa-mergeprof [file1] [file2]```
 
-Merge profile files into a **specific directory**
+**Merge** profile files into a **specific directory**
 
 ```sudo aa-mergeprof -d /path/to/profiles [file1] [file2]```
 
 # SYNOPSIS
 
-**aa-mergeprof** _file_ [_file_ ...] [_-d /path/to/profiles_]
+**aa-mergeprof** _file_ [_file_ ...] [**-d** _/path/to/profiles_]
 
 # DESCRIPTION
 
-**aa-mergeprof** merges one or more AppArmor security profile files into the system profile directory. It is an interactive tool that presents differences between existing and incoming profiles, allowing administrators to resolve conflicts manually. This is useful for importing profiles from other systems, combining profiles from different sources, or consolidating profiles after a system migration.
+**aa-mergeprof** is an interactive tool that merges one or more AppArmor security profile files into the system profile directory. When conflicts exist between incoming and existing profiles, it presents the differences and allows the administrator to choose how to resolve them. This is useful for importing profiles from other systems, combining profiles from different sources, or consolidating profiles after a system migration.
 
 # PARAMETERS
 
-**-d, --dir /path/to/profiles**
-> Specifies the destination directory for merged profiles; defaults to /etc/apparmor.d
+**-d**, **--dir** _/path/to/profiles_
+> Specifies the target directory for merged profiles. Defaults to **/etc/apparmor.d**.
 
-**-h, --help**
-> Display help information
+**-h**, **--help**
+> Display help information and exit.
 
 # CAVEATS
 
-Merging profiles may overwrite existing profiles in the destination directory. Review changes before committing merged profiles.
+Merging profiles may overwrite existing profiles in the destination directory. The tool is interactive and requires manual conflict resolution -- it cannot be run unattended. Requires root privileges.
 
 # HISTORY
 
 Part of the **AppArmor** utilities package for managing application security profiles on Linux systems.
 
 # SEE ALSO
 
-[aa-genprof](/man/aa-genprof)(8), [aa-logprof](/man/aa-logprof)(8), [aa-cleanprof](/man/aa-cleanprof)(8), [apparmor](/man/apparmor)(7)
+[aa-genprof](/man/aa-genprof)(8), [aa-logprof](/man/aa-logprof)(8), [aa-cleanprof](/man/aa-cleanprof)(8), [aa-enforce](/man/aa-enforce)(8), [aa-complain](/man/aa-complain)(8), [apparmor](/man/apparmor)(7)

assets/commands/afconvert.md

@@ -20,45 +20,74 @@ Set **bit rate** for AAC encoding
 
 ```afconvert -f m4af -d aac -b [128000] [input.wav] [output.m4a]```
 
+Convert with VBR **strategy**
+
+```afconvert -f m4af -d aac -s 3 -b [128000] [input.wav] [output.m4a]```
+
+List supported **formats**
+
+```afconvert -hf```
+
 # SYNOPSIS
 
-**afconvert** [_-f file-format_] [_-d data-format_] [_-b bit-rate_] _input_ _output_
+**afconvert** [_options_] _input_ [_output_]
 
 # DESCRIPTION
 
-**afconvert** is a macOS command-line tool for converting between audio file formats. It supports all audio formats handled by Core Audio, including WAV, AIFF, MP3, AAC, ALAC, CAF, and more.
+**afconvert** is a macOS command-line tool for converting between audio file formats. It supports all audio formats handled by Core Audio, including WAV, AIFF, MP3, AAC, ALAC, CAF, and more. If no output file is specified, the name is generated automatically and saved in the same directory as the input.
 
 The tool provides access to Apple's audio codecs and can perform sample rate conversion, bit depth conversion, and channel remapping along with format conversion.
 
 # PARAMETERS
 
-**-f** _format_
-> Output file format: m4af, WAVE, AIFF, caff, etc.
+**-f**, **--file** _format_
+> Output file format (m4af, WAVE, AIFF, caff, etc.).
+
+**-d**, **--data** _format_
+> Audio data format (aac, alac, BEI16, LEF32, etc.). Can include sample rate and format flags.
+
+**-b**, **--bitrate** _rate_
+> Total bit rate in bits per second for compressed formats.
+
+**-c**, **--channels** _number_
+> Number of output channels.
+
+**-l**, **--channellayout** _tag_
+> Channel layout tag.
+
+**-q**, **--quality** _quality_
+> Codec quality (0-127, higher is better).
+
+**-r**, **--src-quality** _quality_
+> Sample rate converter quality (0-127, default: 127).
+
+**--src-complexity** _complexity_
+> Sample rate converter complexity (line, norm, bats).
 
-**-d** _format_
-> Audio data format: aac, alac, BEI16, LEF32, etc.
+**-s**, **--strategy** _strategy_
+> Bitrate allocation strategy (0=CBR, 1=ABR, 2=VBR_constrained, 3=VBR).
 
-**-b** _rate_
-> Bit rate in bits per second for compressed formats
+**-o** _filename_
+> Specify output file path.
 
-**-s** _rate_
-> Sample rate for output file
+**--dither** _algorithm_
+> Dither algorithm (1 or 2).
 
-**-c** _channels_
-> Number of output channels
+**--mix**
+> Enable channel downmixing.
 
-**-q** _quality_
-> Encoder quality (0-127, higher is better)
+**-v**, **--verbose**
+> Display progress information.
 
-**-v**
-> Verbose output
+**-h**, **--help**
+> Display help information.
 
-**-h**
-> Display available formats and help
+**-hf**, **--help-formats**
+> List all supported file and data formats.
 
 # CAVEATS
 
-This tool is macOS-only. Some format conversions may be lossy. AAC encoding quality varies with bit rate settings. Not all format combinations are valid.
+This tool is macOS-only. Some format conversions may be lossy. AAC encoding quality varies with bit rate settings. Not all format combinations are valid. Use **-hf** to see which formats are supported on your system.
 
 # HISTORY
 

assets/commands/apptainer-config.md

@@ -75,6 +75,9 @@ The command operates through two subcommands: **fakeroot** for managing user nam
 **--dry-run**
 > Display the resulting configuration without writing to file (global subcommand)
 
+**-h**, **--help**
+> Display help for the config command
+
 # CONFIGURATION
 
 The global subcommand modifies **/etc/apptainer/apptainer.conf** (or the equivalent path for unprivileged installations). Common directives include:
@@ -101,4 +104,4 @@ Apptainer originated as **Singularity**, created by **Gregory Kurtzer** at **Law
 
 # SEE ALSO
 
-[apptainer](/man/apptainer)(1), [docker](/man/docker)(1), [podman](/man/podman)(1)
+[apptainer](/man/apptainer)(1), [singularity](/man/singularity)(1), [docker](/man/docker)(1), [podman](/man/podman)(1)

assets/commands/apt-key.md

@@ -1,6 +1,6 @@
 # TAGLINE
 
-Manage trusted keys for package authentication.
+Deprecated APT key management utility for package authentication
 
 # TLDR
 
@@ -24,15 +24,27 @@ Add a key from **keyserver** with only key ID
 
 ```apt-key adv --keyserver pgp.mit.edu --recv [KEYID]```
 
+**Export** all trusted keys
+
+```apt-key exportall```
+
+**Modern replacement**: download a key directly into trusted.gpg.d (no apt-key needed)
+
+```curl -fsSL [https://example.com/key.gpg] | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/[example].gpg```
+
+**Modern replacement**: use signed-by in sources.list
+
+```echo "deb [signed-by=/usr/share/keyrings/[example].gpg] [https://repo.example.com] [stable] main" | sudo tee /etc/apt/sources.list.d/[example].list```
+
 # SYNOPSIS
 
 **apt-key** [_command_] [_arguments_]
 
 # DESCRIPTION
 
-**apt-key** is a key management utility for the APT Package Manager on Debian and Ubuntu. It manages the list of keys used by apt to authenticate packages.
+**apt-key** is a deprecated key management utility for the APT Package Manager on Debian and Ubuntu. It manages the list of keys used by apt to authenticate packages.
 
-**Note:** apt-key is now deprecated. Keys should be stored in /etc/apt/trusted.gpg.d/ or /usr/share/keyrings/ and referenced via signed-by in sources.list.
+**Note:** apt-key is deprecated since Debian 11 (Bullseye) and Ubuntu 22.04 (Jammy). The recommended approach is to place keyring files directly in /etc/apt/trusted.gpg.d/ (with .gpg or .asc extension) or in /usr/share/keyrings/ and reference them via the `signed-by` option in sources.list entries. Only `apt-key del` remains supported for use in maintainer scripts.
 
 # PARAMETERS
 
@@ -61,7 +73,10 @@ Add a key from **keyserver** with only key ID
 > Output all trusted keys to standard output
 
 **finger**
-> List fingerprints of trusted keys
+> List fingerprints of trusted keys (deprecated)
+
+**--keyring** _filename_
+> Operate on a specific keyring file (deprecated)
 
 # CONFIGURATION
 
@@ -81,4 +96,4 @@ Part of the **APT** (Advanced Package Tool) suite. Deprecated starting with Debi
 
 # SEE ALSO
 
-[apt](/man/apt)(8), [apt-get](/man/apt-get)(8), [gpg](/man/gpg)(1)
+[apt](/man/apt)(8), [apt-get](/man/apt-get)(8), [gpg](/man/gpg)(1), [apt-secure](/man/apt-secure)(8)