From 85e336526daef520bbbe82c38fc05bab1feb3e28 Mon Sep 17 00:00:00 2001 From: vilmibm Date: Tue, 8 Nov 2022 12:31:33 -0800 Subject: [PATCH] tweak usage --- pkg/cmd/extension/command.go | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/pkg/cmd/extension/command.go b/pkg/cmd/extension/command.go index 98ab4876c..54d57c778 100644 --- a/pkg/cmd/extension/command.go +++ b/pkg/cmd/extension/command.go @@ -59,18 +59,18 @@ func NewCmdExtension(f *cmdutil.Factory) *cobra.Command { cmd := &cobra.Command{ Use: "search []", - Short: "Search through available gh extensions", + Short: "Search through extensions to the GitHub CLI", Long: heredoc.Doc(` Search for gh extensions. - With no arguments, this command prints out the first 30 available - extensions sorted by number of stars. More extensions can be fetched - by specifying a higher limit with the --limit flag. + With no arguments, this command prints out the first 30 extensions + available to install sorted by number of stars. More extensions can + be fetched by specifying a higher limit with the --limit flag. When connected to a terminal, this command prints out three columns. - The first has a ✓ if the extension is installed locally. The second - is the full name of the extension repository in NAME/OWNER format. - The third is the extension's description. + The first has a ✓ if the extension is already installed locally. The + second is the full name of the extension repository in NAME/OWNER + format. The third is the extension's description. When not connected to a terminal, the ✓ character is rendered as the word "installed" but otherwise the order and content of the columns @@ -84,6 +84,11 @@ func NewCmdExtension(f *cmdutil.Factory) *cobra.Command { and adding qualifiers as needed. See 'gh help search repos' to learn more about repository search. + + For listing just the extensions that are already installed locally, + see: + + gh ext list `), Example: heredoc.Doc(` # List the first 30 extensions sorted by star count, descending