From edb33e6128a02115a954ac3e27866849ad12c13c Mon Sep 17 00:00:00 2001
From: Meinard Francisco <44516102+znarfm@users.noreply.github.com>
Date: Sat, 11 Oct 2025 15:01:41 +0800
Subject: [PATCH] komac: add shorthands (#18655)

* komac: add shorthands

* komac: limit up to 2 versions

* remove 'merge-upstream' option from sync command in komac documentation
---
 pages/common/komac.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/pages/common/komac.md b/pages/common/komac.md
index 43b017d64c..bbfab6ed34 100644
--- a/pages/common/komac.md
+++ b/pages/common/komac.md
@@ -5,32 +5,32 @@
 
 - Create a new package from scratch:
 
-`komac new {{Package.Identifier}} --version {{1.2.3}} --urls {{https://example.com/app.exe}}`
+`komac new {{Package.Identifier}} {{[-v|--version]}} {{1.2.3}} {{[-u|--urls]}} {{https://example.com/app.exe}}`
 
 - Update an existing package with a new version:
 
-`komac update {{Package.Identifier}} --version {{1.2.3}} --urls {{https://example.com/app.exe}}`
+`komac update {{Package.Identifier}} {{[-v|--version]}} {{1.2.3}} {{[-u|--urls]}} {{https://example.com/app.exe}}`
 
 - Update a package with multiple URLs and automatically submit:
 
-`komac update {{Package.Identifier}} --version {{1.2.3}} --urls {{https://example.com/app.exe https://example.com/app.msi ...}} --submit`
+`komac update {{Package.Identifier}} {{[-v|--version]}} {{1.2.3}} {{[-u|--urls]}} {{https://example.com/app.exe https://example.com/app.msi ...}} {{[-s|--submit]}}`
 
 - Remove a version from winget-pkgs:
 
-`komac remove {{Package.Identifier}} --version {{1.2.3}}`
+`komac remove {{Package.Identifier}} {{[-v|--version]}} {{1.2.3}}`
 
 - List all versions for a package:
 
-`komac list-versions {{Package.Identifier}}`
+`komac {{[list|list-versions]}} {{Package.Identifier}}`
 
 - Sync your fork of winget-pkgs with the upstream repository:
 
-`komac sync-fork`
+`komac {{[sync|sync-fork]}}`
 
 - Update the stored GitHub token:
 
-`komac token update --token {{your_github_token}}`
+`komac token {{[add|update]}} {{[-t|--token]}} {{your_github_token}}`
 
 - Generate shell autocompletion script:
 
-`komac complete {{bash|zsh|fish|powershell}}`
+`komac {{[complete|autocomplete]}} {{bash|elvish|fish|powershell|zsh}}`