*: use imperative mood (#20324)

Co-authored-by: znarfm <44516102+znarfm@users.noreply.github.com>
2026-08-28 20:11:19 +08:00 · 2025-12-29 11:09:00 +02:00
parent bfa9afd974
commit 65485698b1
46 changed files with 49 additions and 48 deletions
@@ -1,6 +1,6 @@
 # az version

-> Shows the current version of Azure CLI modules and extensions.
+> Show the current version of Azure CLI modules and extensions.
 > Part of `azure-cli` (also known as `az`).
 > More information: <https://learn.microsoft.com/cli/azure/reference-index?view=azure-cli-latest#az-version>.

@@ -1,6 +1,6 @@
 # bun feedback

-> Sends feedback to `Bun`.
+> Send feedback to `Bun`.
 > More information: <https://bun.com/docs/feedback#use-bun-feedback>.

 - Send text as feedback:
@@ -1,6 +1,6 @@
 # cmatrix

-> Shows a scrolling Matrix like screen in the terminal.
+> Show a scrolling Matrix like screen in the terminal.
 > See also: `cbonsai`, `asciiquarium`, `pipes.sh`.
 > More information: <https://manned.org/cmatrix>.

@@ -1,6 +1,6 @@
 # elasticsearch-croneval

-> Validates and evaluates a `cron` expression. This command helps verify that `cron` expressions are valid for use with Elasticsearch and produce the expected results.
+> Validate and evaluate a `cron` expression. This command helps verify that `cron` expressions are valid for use with Elasticsearch and produce the expected results.
 > More information: <https://www.elastic.co/docs/reference/elasticsearch/command-line-tools/elasticsearch-croneval>.

 - Evaluate a `cron` expression and display the next 10 trigger times (default behavior):
@@ -1,6 +1,6 @@
 # fc-pattern

-> Shows information about a font matching a pattern.
+> Show information about a font matching a pattern.
 > More information: <https://manned.org/fc-pattern>.

 - Display default information about a font:
@@ -1,6 +1,6 @@
 # gendesk

-> Specifies the command to generate a `.desktop` file and a download icon with minimal information.
+> Specify the command to generate a `.desktop` file and a download icon with minimal information.
 > More information: <https://manned.org/gendesk>.

 - Create a `.desktop` file named `app`:
@@ -1,6 +1,6 @@
 # git bugreport

-> Captures debug information from the system and user, generating a text file to aid in the reporting of a bug in Git.
+> Capture debug information from the system and user, generating a text file to aid in the reporting of a bug in Git.
 > More information: <https://git-scm.com/docs/git-bugreport>.

 - Create a new bug report file in the current directory:
@@ -1,6 +1,6 @@
 # go test

-> Tests Go packages (files have to end with `_test.go`).
+> Test Go packages (files have to end with `_test.go`).
 > More information: <https://pkg.go.dev/cmd/go#hdr-Testing_flags>.

 - Test the package found in the current directory:
@@ -1,6 +1,6 @@
 # highlight

-> Outputs syntax-highlighted source code to a variety of formats.
+> Output syntax-highlighted source code to a variety of formats.
 > More information: <http://andre-simon.de/doku/highlight/en/highlight.php>.

 - Produce a complete HTML document from a source code file:
@@ -1,6 +1,7 @@
 # hugo

-> Template-based static site generator. Uses modules, components, and themes.
+> Template-based static site generator.
+> Uses modules, components, and themes.
 > Some subcommands such as `server` have their own usage documentation.
 > More information: <https://gohugo.io/commands/>.

@@ -1,6 +1,6 @@
 # if

-> Performs conditional processing in shell scripts.
+> Perform conditional processing in shell scripts.
 > See also: `test`, `[`.
 > More information: <https://www.gnu.org/software/bash/manual/bash.html#Conditional-Constructs>.

@@ -1,6 +1,6 @@
 # kill

-> Sends a signal to a process, usually related to stopping the process.
+> Send a signal to a process, usually related to stopping the process.
 > All signals except for SIGKILL and SIGSTOP can be intercepted by the process to perform a clean exit.
 > More information: <https://manned.org/kill.1posix>.

@@ -1,6 +1,7 @@
 # kubectl run

-> Run pods in Kubernetes. Specifies pod generator to avoid deprecation error in some K8S versions.
+> Run pods in Kubernetes.
+> Specifies pod generator to avoid deprecation error in some K8S versions.
 > More information: <https://kubernetes.io/docs/reference/kubectl/generated/kubectl_run/>.

 - Run an nginx pod and expose port 80:
@@ -1,6 +1,6 @@
 # logname

-> Shows the user's login name.
+> Show the user's login name.
 > See also: `id`.
 > More information: <https://www.gnu.org/software/coreutils/manual/html_node/logname-invocation.html>.

@@ -1,7 +1,6 @@
 # npm audit

-> Scan for known vulnerabilities in project dependencies.
-> Reports vulnerabilities and suggests remediation.
+> Scan project dependencies for known security vulnerabilities.
 > More information: <https://docs.npmjs.com/cli/npm-audit/>.

 - Scan the project's dependencies for known vulnerabilities:
@@ -1,6 +1,6 @@
 # pkl

-> Manages, evaluates, and tests Pkl configuration modules.
+> Manage, evaluate, and test Pkl configuration modules.
 > More information: <https://pkl-lang.org/main/current/pkl-cli/>.

 - Evaluate the given Pkl modules and produce their rendering results:
@@ -1,6 +1,6 @@
 # poetry publish

-> Publishes a package to a remote repository.
+> Publish a package to a remote repository.
 > More information: <https://python-poetry.org/docs/cli/#publish>.

 - Publish the current package to PyPI:
@@ -1,6 +1,6 @@
 # print

-> Z Shell (`zsh`) builtin. Prints arguments, similar to `echo`.
+> Z Shell (`zsh`) builtin. Print arguments, similar to `echo`.
 > See also: `echo`, `printf`, `zsh`.
 > More information: <https://zsh.sourceforge.io/Doc/Release/Shell-Builtin-Commands.html>.

@@ -1,6 +1,6 @@
 # pueue switch

-> Switches the queue position of two enqueued or stashed commands.
+> Switch the queue position of two enqueued or stashed commands.
 > More information: <https://github.com/Nukesor/pueue#how-to-use-it>.

 - Switch the priority of two tasks:
@@ -1,6 +1,6 @@
 # pyflakes

-> Checks Python source code files for errors.
+> Check Python source code files for errors.
 > More information: <https://pypi.org/project/pyflakes>.

 - Check a single Python file:
@@ -1,6 +1,6 @@
 # streamlink

-> Extracts streams from various services and pipes them into a video player of choice.
+> Extract streams from various services and pipes them into a video player of choice.
 > More information: <https://streamlink.github.io/cli.html#command-line-usage>.

 - Attempt to extract streams from the URL specified, and if it's successful, print out a list of available streams to choose from:
@@ -1,6 +1,6 @@
 # where

-> Reports all known instances of a command.
+> Report all known instances of a command.
 > It could be an executable in the `$PATH` environment variable, an alias, or a shell builtin.
 > More information: <https://zsh.sourceforge.io/Doc/Release/Shell-Builtin-Commands.html>.

@@ -1,6 +1,6 @@
 # acpi

-> Shows battery status or thermal information.
+> Show battery status or thermal information.
 > More information: <https://manned.org/acpi>.

 - Show battery information:
@@ -1,7 +1,7 @@
 # bootc

 > Boot and upgrade via container images.
-> Manages transactional, in-place operating system updates using OCI/Docker container images.
+> Manage transactional, in-place operating system updates using OCI/Docker container images.
 > More information: <https://manned.org/bootc>.

 - Show deployments in the order they will appear in the bootloader:
@@ -1,6 +1,6 @@
 # kill

-> Sends a signal to a process, usually related to stopping the process.
+> Send a signal to a process, usually related to stopping the process.
 > All signals except for SIGKILL and SIGSTOP can be intercepted by the process to perform a clean exit.
 > More information: <https://manned.org/kill>.

@@ -1,6 +1,6 @@
 # nixos-container

-> Starts NixOS containers using Linux containers.
+> Start NixOS containers using Linux containers.
 > More information: <https://nixos.org/manual/nixos/stable/#ch-containers>.

 - List running containers:
@@ -1,6 +1,6 @@
 # qm suspend

-> Suspends a virtual machine (VM) in the Proxmox Virtual Environment (PVE).
+> Suspend a virtual machine (VM) in the Proxmox Virtual Environment (PVE).
 > Use `--skiplock` and `--skiplockstorage` flags with caution, as they may lead to data corruption in certain situations.
 > More information: <https://pve.proxmox.com/pve-docs/qm.1.html#cli_qm_suspend>.

@@ -1,7 +1,7 @@
 # speedread

-> A simple terminal-based open source Spritz-alike.
-> Shows input text as a per-word RSVP (rapid serial visual presentation) aligned on optimal reading points, which allows reading text at a much more rapid pace than usual as the eye can stay fixed on a single place.
+> A Spritz-alike speed reader.
+> Show text using per-word Rapid Serial Visual Presentation (RSVP).
 > More information: <https://github.com/pasky/speedread>.

 - Read a text file at a specific speed:
@@ -1,6 +1,6 @@
 # contactsd

-> Manages the information in your contacts database.
+> Manage the information in your contacts database.
 > It provides functionality to apps using the Contacts API and performs various background maintenance tasks.
 > It should not be invoked manually.
 > More information: <https://keith.github.io/xcode-man-pages/contactsd.8.html>.
@@ -1,6 +1,6 @@
 # launchd

-> Manages processes, both for the system and users.
+> Manage processes, both for the system and users.
 > You cannot invoke launchd manually, use launchctl to interact with it.
 > More information: <https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/Introduction.html>.

@@ -1,6 +1,6 @@
 # secd

-> Controls access to and modification of keychain items.
+> Control access to and modification of keychain items.
 > It should not be invoked manually.
 > More information: <https://keith.github.io/xcode-man-pages/secd.8.html>.

@@ -1,6 +1,6 @@
 # translationd

-> Enables Translation features.
+> Enable Translation features.
 > It should not be invoked manually.

 - Start the daemon:
@@ -1,6 +1,6 @@
 # warmd

-> Controls caches used during startup and login.
+> Control caches used during startup and login.
 > It should not be invoked manually.
 > More information: <https://keith.github.io/xcode-man-pages/warmd.8.html>.

@@ -1,6 +1,6 @@
 # if

-> Performs conditional processing in batch scripts.
+> Perform conditional processing in batch scripts.
 > More information: <https://learn.microsoft.com/windows-server/administration/windows-commands/if>.

 - Execute the specified commands if the condition is true:
@@ -1,6 +1,6 @@
 # Invoke-WebRequest

-> Performs a HTTP/HTTPS request to the Web.
+> Perform a HTTP/HTTPS request to the Web.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/microsoft.powershell.utility/invoke-webrequest>.

@@ -1,6 +1,6 @@
 # Measure-Object

-> Calculates the numeric properties of objects, and the characters, words, and lines in string objects, such as files of text.
+> Calculate the numeric properties of objects, and the characters, words, and lines in string objects, such as files of text.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/microsoft.powershell.utility/measure-object>.

@@ -1,6 +1,6 @@
 # Out-String

-> Outputs input objects as a string.
+> Output input objects as a string.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/microsoft.powershell.utility/out-string>.

@@ -1,6 +1,6 @@
 # popd

-> Changes the current directory to the directory stored by the `pushd` command.
+> Change the current directory to the directory stored by the `pushd` command.
 > More information: <https://learn.microsoft.com/windows-server/administration/windows-commands/popd>.

 - Switch to directory at the top of the stack:
@@ -1,6 +1,6 @@
 # Set-Acl

-> Changes the security descriptor of a specified item, such as a file or a registry key.
+> Change the security descriptor of a specified item, such as a file or a registry key.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/microsoft.powershell.security/set-acl>.

@@ -1,6 +1,6 @@
 # Set-Date

-> Changes the system time on the computer to a time that you specify.
+> Change the system time on the computer to a time that you specify.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/microsoft.powershell.utility/set-date>.

@@ -1,6 +1,6 @@
 # Set-Service

-> Starts, stops, and suspends a service, and changes its properties.
+> Start, stop, and suspend a service, and changes its properties.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/microsoft.powershell.management/set-service>.

@@ -1,6 +1,6 @@
 # Set-Volume

-> Sets or changes the file system label of an existing volume.
+> Set or change the file system label of an existing volume.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/storage/set-volume>.

@@ -1,6 +1,6 @@
 # sfc

-> Scans the integrity of Windows system files.
+> Scan the integrity of Windows system files.
 > More information: <https://learn.microsoft.com/windows-server/administration/windows-commands/sfc>.

 - Display information about the usage of the command:
@@ -1,6 +1,6 @@
 # Show-Markdown

-> Shows a Markdown file or string in the console in a friendly way using VT100 escape sequences or in a browser using HTML.
+> Show a Markdown file or string in the console in a friendly way using VT100 escape sequences or in a browser using HTML.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/microsoft.powershell.utility/show-markdown>.

@@ -1,6 +1,6 @@
 # Start-Service

-> Starts stopped services.
+> Start stopped services.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/microsoft.powershell.management/start-service>.

@@ -1,6 +1,6 @@
 # Stop-Service

-> Stops running services.
+> Stop running services.
 > Note: This command can only be used through PowerShell.
 > More information: <https://learn.microsoft.com/powershell/module/microsoft.powershell.management/stop-service>.