From ef9af3c3fa782a919fdbfa30541e963246fcac07 Mon Sep 17 00:00:00 2001 From: Managor <42655600+Managor@users.noreply.github.com> Date: Mon, 24 Nov 2025 03:10:31 +0200 Subject: [PATCH] *: improve more info links and add option placeholders part 1 (#19556) --- pages/common/acme.sh.md | 2 +- pages/common/duc.md | 2 +- pages/common/duckdb.md | 2 +- pages/common/gource.md | 2 +- pages/common/inkscape.md | 2 +- pages/common/lilypond.md | 2 +- pages/common/lmms.md | 6 +++--- pages/common/magick.md | 2 +- pages/common/mlr.md | 2 +- pages/common/mocha.md | 8 ++++---- pages/common/pass.md | 2 +- pages/common/pygbag.md | 2 +- pages/common/surge.md | 2 +- pages/linux/archinstall.md | 6 +----- pages/linux/ctr.md | 2 +- pages/linux/darling.md | 2 +- pages/linux/goaccess.md | 2 +- pages/linux/lsinitrd.md | 4 ++-- pages/linux/perf.md | 2 +- pages/linux/pstoedit.md | 2 +- pages/linux/slapt-get.md | 2 +- pages/linux/stratis.md | 2 +- pages/linux/tshark.md | 2 +- pages/osx/mate.md | 8 ++++---- pages/osx/orb.md | 2 +- pages/osx/wacaw.md | 8 ++++---- 26 files changed, 38 insertions(+), 42 deletions(-) diff --git a/pages/common/acme.sh.md b/pages/common/acme.sh.md index 8c9c1ad552..6f8a57d63a 100644 --- a/pages/common/acme.sh.md +++ b/pages/common/acme.sh.md @@ -2,7 +2,7 @@ > Shell script implementing ACME client protocol, an alternative to `certbot`. > See also: `acme.sh dns`. -> More information: . +> More information: . - Issue a certificate using webroot mode: diff --git a/pages/common/duc.md b/pages/common/duc.md index 8f8258ad11..cc30ab1418 100644 --- a/pages/common/duc.md +++ b/pages/common/duc.md @@ -2,7 +2,7 @@ > A collection of tools for indexing, inspecting, and visualizing disk usage. > Duc maintains a database of accumulated sizes of directories of the file system, allowing queries in this database, or creating fancy graphs to show where data is. -> More information: . +> More information: . - Index the `/usr` directory, writing to the default database location `~/.duc.db`: diff --git a/pages/common/duckdb.md b/pages/common/duckdb.md index dfb31dc55f..36e7b52de4 100644 --- a/pages/common/duckdb.md +++ b/pages/common/duckdb.md @@ -1,7 +1,7 @@ # duckdb > Client for DuckDB, an in-process analytical SQL engine. -> More information: . +> More information: . - Start an interactive shell with a transient in-memory database: diff --git a/pages/common/gource.md b/pages/common/gource.md index 41310dcc1f..65daf255fc 100644 --- a/pages/common/gource.md +++ b/pages/common/gource.md @@ -2,7 +2,7 @@ > Renders an animated tree diagram of Git, SVN, Mercurial and Bazaar repositories. > It shows files and directories being created, modified or removed over time. -> More information: . +> More information: . - Run gource in a directory (if it isn't the repository's root directory, the root is sought up from there): diff --git a/pages/common/inkscape.md b/pages/common/inkscape.md index ced6a714a1..204008b6f3 100644 --- a/pages/common/inkscape.md +++ b/pages/common/inkscape.md @@ -2,7 +2,7 @@ > An SVG (Scalable Vector Graphics) editing program. > For Inkscape versions up to 0.92.x, use -e instead of -o. -> More information: . +> More information: . - Open an SVG file in the Inkscape GUI: diff --git a/pages/common/lilypond.md b/pages/common/lilypond.md index 276911d4aa..f4963f69b7 100644 --- a/pages/common/lilypond.md +++ b/pages/common/lilypond.md @@ -2,7 +2,7 @@ > Typeset music and/or produce MIDI from file. > See also: `musescore`. -> More information: . +> More information: . - Compile a lilypond file into a PDF: diff --git a/pages/common/lmms.md b/pages/common/lmms.md index 13824e2bcd..416707b046 100644 --- a/pages/common/lmms.md +++ b/pages/common/lmms.md @@ -3,7 +3,7 @@ > Free, open source, cross-platform digital audio workstation. > Render a `.mmp` or `.mmpz` project file, dump a `.mmpz` as XML, or start the GUI. > See also: `mixxx`. -> More information: . +> More information: . - Start the GUI: @@ -11,7 +11,7 @@ - Start the GUI and load external config: -`lmms --config {{path/to/config.xml}}` +`lmms {{[-c|--config]}} {{path/to/config.xml}}` - Start the GUI and import MIDI or Hydrogen file: @@ -35,4 +35,4 @@ - Render with custom samplerate, format, and as a loop: -`lmms render --samplerate {{88200}} --format {{ogg}} --loop --output {{path/to/output_file.ogg}}` +`lmms render {{[-s|--samplerate]}} {{88200}} {{[-f|--format]}} {{ogg}} {{[-l|--loop]}} {{[-o|--output]}} {{path/to/output_file.ogg}}` diff --git a/pages/common/magick.md b/pages/common/magick.md index 2659775f82..64c22d0186 100644 --- a/pages/common/magick.md +++ b/pages/common/magick.md @@ -3,7 +3,7 @@ > Create, edit, compose, or convert between image formats. > This tool replaces `convert` in ImageMagick 7+. See `magick convert` to use the old tool in versions 7+. > Some subcommands, such as `mogrify` have their own usage documentation. -> More information: . +> More information: . - Convert between image formats: diff --git a/pages/common/mlr.md b/pages/common/mlr.md index 15f09f1394..778be71bb0 100644 --- a/pages/common/mlr.md +++ b/pages/common/mlr.md @@ -1,7 +1,7 @@ # mlr > Miller is like `awk`, `sed`, `cut`, `join`, and `sort` for name-indexed data such as CSV, TSV, and tabular JSON. -> More information: . +> More information: . - Pretty-print a CSV file in a tabular format: diff --git a/pages/common/mocha.md b/pages/common/mocha.md index 5f306eb919..2dc9c89b70 100644 --- a/pages/common/mocha.md +++ b/pages/common/mocha.md @@ -1,7 +1,7 @@ # mocha > A feature-rich JavaScript test framework. -> More information: . +> More information: . - Run tests with default configuration or as configured in `mocha.opts`: @@ -13,12 +13,12 @@ - Run tests that match a specific `grep` pattern: -`mocha --grep {{regex}}` +`mocha {{[-g|--grep]}} {{regex}}` - Run tests on changes to JavaScript files in the current directory and once initially: -`mocha --watch` +`mocha {{[-w|--watch]}}` - Run tests with a specific reporter: -`mocha --reporter {{reporter}}` +`mocha {{[-R|--reporter]}} {{reporter}}` diff --git a/pages/common/pass.md b/pages/common/pass.md index f0b612881a..00f370bdf4 100644 --- a/pages/common/pass.md +++ b/pages/common/pass.md @@ -2,7 +2,7 @@ > Store and read passwords or other sensitive data. > All data is GPG-encrypted, and managed with a Git repository. -> More information: . +> More information: . - Initialize (or re-encrypt) the storage using one or more GPG IDs: diff --git a/pages/common/pygbag.md b/pages/common/pygbag.md index b95cf1ec6a..52e04c6590 100644 --- a/pages/common/pygbag.md +++ b/pages/common/pygbag.md @@ -1,7 +1,7 @@ # pygbag > Package Pygame projects as WebAssembly to run in web browsers. -> More information: . +> More information: . - Package a Pygame project and start a local test server: diff --git a/pages/common/surge.md b/pages/common/surge.md index 5d77447f01..f463b79a05 100644 --- a/pages/common/surge.md +++ b/pages/common/surge.md @@ -1,7 +1,7 @@ # surge > Simple web publishing. -> More information: . +> More information: . - Upload a new site to surge.sh: diff --git a/pages/linux/archinstall.md b/pages/linux/archinstall.md index 339954ab68..5b37a0fbaa 100644 --- a/pages/linux/archinstall.md +++ b/pages/linux/archinstall.md @@ -1,12 +1,8 @@ # archinstall > Guided Arch Linux installer with a twist. -> More information: . +> More information: . - Start the interactive installer: `archinstall` - -- Start a preset installer: - -`archinstall {{minimal|unattended}}` diff --git a/pages/linux/ctr.md b/pages/linux/ctr.md index 500623b0bf..538795f809 100644 --- a/pages/linux/ctr.md +++ b/pages/linux/ctr.md @@ -1,7 +1,7 @@ # ctr > Manage `containerd` containers and images. -> More information: . +> More information: . - List all containers (running and stopped): diff --git a/pages/linux/darling.md b/pages/linux/darling.md index d877fd4cb8..3c70704eb4 100644 --- a/pages/linux/darling.md +++ b/pages/linux/darling.md @@ -1,7 +1,7 @@ # darling > Run macOS software on Linux. -> More information: . +> More information: . - Run a builtin command: diff --git a/pages/linux/goaccess.md b/pages/linux/goaccess.md index 42e53d9b0c..3decd6984c 100644 --- a/pages/linux/goaccess.md +++ b/pages/linux/goaccess.md @@ -1,7 +1,7 @@ # goaccess > An open source real-time web log analyzer. -> More information: . +> More information: . - Analyze one or more log files in interactive mode: diff --git a/pages/linux/lsinitrd.md b/pages/linux/lsinitrd.md index 0b93c69b3b..1caa33b851 100644 --- a/pages/linux/lsinitrd.md +++ b/pages/linux/lsinitrd.md @@ -10,7 +10,7 @@ - Show the contents of the initramfs image for the specified kernel: -`lsinitrd --kver {{kernel_version}}` +`lsinitrd {{[-k|--kver]}} {{kernel_version}}` - Show the contents of the specified initramfs image: @@ -18,7 +18,7 @@ - List modules included in the initramfs image: -`lsinitrd --mod` +`lsinitrd {{[-m|--mod]}}` - Unpack the initramfs to the current directory: diff --git a/pages/linux/perf.md b/pages/linux/perf.md index f3f2a440c0..2a0a21537c 100644 --- a/pages/linux/perf.md +++ b/pages/linux/perf.md @@ -1,7 +1,7 @@ # perf > Framework for Linux performance counter measurements. -> More information: . +> More information: . - Display basic performance counter stats for a command: diff --git a/pages/linux/pstoedit.md b/pages/linux/pstoedit.md index 8a178b1cde..52cd259a96 100644 --- a/pages/linux/pstoedit.md +++ b/pages/linux/pstoedit.md @@ -1,7 +1,7 @@ # pstoedit > Convert PDF files into various image formats. -> More information: . +> More information: . - Convert a PDF page to PNG or JPEG format: diff --git a/pages/linux/slapt-get.md b/pages/linux/slapt-get.md index 82aed3ade4..5bafe83c4d 100644 --- a/pages/linux/slapt-get.md +++ b/pages/linux/slapt-get.md @@ -2,7 +2,7 @@ > An `apt` like system for Slackware package management. > Package sources need to be configured in the slapt-getrc file. -> More information: . +> More information: . - Update the list of available packages and versions: diff --git a/pages/linux/stratis.md b/pages/linux/stratis.md index a37b258474..61b8f2c427 100644 --- a/pages/linux/stratis.md +++ b/pages/linux/stratis.md @@ -2,7 +2,7 @@ > Manage local storage pools and volumes using the Stratis storage manager. > Stratis volumes use the XFS filesystem and require the `stratisd` service. -> More information: . +> More information: . - Start the Stratis service (must be active before managing pools or volumes): diff --git a/pages/linux/tshark.md b/pages/linux/tshark.md index 6d73f1d0f0..d99f528e52 100644 --- a/pages/linux/tshark.md +++ b/pages/linux/tshark.md @@ -1,7 +1,7 @@ # tshark > Packet analysis tool, CLI version of Wireshark. -> More information: . +> More information: . - Monitor everything on localhost: diff --git a/pages/osx/mate.md b/pages/osx/mate.md index 981985254b..66cc0ace3d 100644 --- a/pages/osx/mate.md +++ b/pages/osx/mate.md @@ -1,7 +1,7 @@ # mate > General-purpose text editor for macOS. -> More information: . +> More information: . - Start TextMate: @@ -13,12 +13,12 @@ - Specify the filetype of a file: -`mate --type {{filetype}} {{path/to/file}}` +`mate {{[-t|--type]}} {{filetype}} {{path/to/file}}` - Open and wait until finished editing a specific file: -`mate --wait {{path/to/file}}` +`mate {{[-w|--wait]}} {{path/to/file}}` - Open a file with the cursor at a specific line and column: -`mate --line {{line_number}}:{{column_number}} {{path/to/file}}` +`mate {{[-l|--line]}} {{line_number}}:{{column_number}} {{path/to/file}}` diff --git a/pages/osx/orb.md b/pages/osx/orb.md index b58f28f92a..7210706826 100644 --- a/pages/osx/orb.md +++ b/pages/osx/orb.md @@ -2,7 +2,7 @@ > Interface for OrbStack, a fast and lightweight container and virtual machine runtime for macOS. > Provides Docker-compatible commands and Linux VM management. -> More information: . +> More information: . - List all containers and VMs: diff --git a/pages/osx/wacaw.md b/pages/osx/wacaw.md index 06e407ce68..badabc47cb 100644 --- a/pages/osx/wacaw.md +++ b/pages/osx/wacaw.md @@ -1,7 +1,7 @@ # wacaw > Capture both still pictures and video from an attached camera. -> More information: . +> More information: . - Take a picture from webcam: @@ -9,11 +9,11 @@ - Record a video: -`wacaw --video {{filename}} --duration {{10}}` +`wacaw --video {{filename}} {{[-D|--duration]}} {{10}}` - Take a picture with custom resolution: -`wacaw --width {{width}} --height {{100}} {{filename}}` +`wacaw {{[-x|--width]}} {{width}} {{[-y|--height]}} {{100}} {{filename}}` - Copy image just taken to clipboard: @@ -21,4 +21,4 @@ - List the devices available: -`wacaw --list-devices` +`wacaw {{[-L|--list-devices]}}`