https-github-com-bit
diff --git a/‎internal/docs/utils_test.go‎ ‎internal/docs/docs_test.go‎internal/docs/utils_test.go renamed to internal/docs/docs_test.go b/‎internal/docs/utils_test.go‎ ‎internal/docs/docs_test.go‎internal/docs/utils_test.go renamed to internal/docs/docs_test.go
diff --git a/‎internal/docs/man.go‎
Lines changed: 22 additions & 0 deletions b/‎internal/docs/man.go‎
Lines changed: 22 additions & 0 deletions
diff --git a/‎internal/docs/man_test.go‎
Lines changed: 1 addition & 1 deletion b/‎internal/docs/man_test.go‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎internal/docs/markdown_test.go‎
Lines changed: 4 additions & 0 deletions b/‎internal/docs/markdown_test.go‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎internal/docs/utils.go‎
Lines changed: 0 additions & 38 deletions b/‎internal/docs/utils.go‎
Lines changed: 0 additions & 38 deletions
@@ -218,3 +218,25 @@ func genMan(cmd *cobra.Command, header *GenManHeader) []byte {
 	}
 	return buf.Bytes()
 }
+
+// Test to see if we have a reason to print See Also information in docs
+// Basically this is a test for a parent command or a subcommand which is
+// both not deprecated and not the autogenerated help command.
+func hasSeeAlso(cmd *cobra.Command) bool {
+	if cmd.HasParent() {
+		return true
+	}
+	for _, c := range cmd.Commands() {
+		if !c.IsAvailableCommand() || c.IsAdditionalHelpTopicCommand() {
+			continue
+		}
+		return true
+	}
+	return false
+}
+
+type byName []*cobra.Command
+
+func (s byName) Len() int           { return len(s) }
+func (s byName) Swap(i, j int)      { s[i], s[j] = s[j], s[i] }
+func (s byName) Less(i, j int) bool { return s[i].Name() < s[j].Name() }
@@ -109,7 +109,7 @@ func TestGenManSeeAlso(t *testing.T) {
 func TestManPrintFlagsHidesShortDeperecated(t *testing.T) {
 	c := &cobra.Command{}
 	c.Flags().StringP("foo", "f", "default", "Foo flag")
-	c.Flags().MarkShorthandDeprecated("foo", "don't use it no more")
+	_ = c.Flags().MarkShorthandDeprecated("foo", "don't use it no more")
 
 	buf := new(bytes.Buffer)
 	manPrintFlags(buf, c.Flags())
 
@@ -22,6 +22,8 @@ func TestGenMdDoc(t *testing.T) {
 	checkStringContains(t, output, echoCmd.Example)
 	checkStringContains(t, output, "boolone")
 	checkStringContains(t, output, "rootflag")
+	checkStringOmits(t, output, rootCmd.Short)
+	checkStringOmits(t, output, echoSubCmd.Short)
 	checkStringOmits(t, output, deprecatedCmd.Short)
 	checkStringContains(t, output, "Options inherited from parent commands")
 }
@@ -57,6 +59,8 @@ func TestGenMdNoHiddenParents(t *testing.T) {
 	checkStringContains(t, output, echoCmd.Example)
 	checkStringContains(t, output, "boolone")
 	checkStringOmits(t, output, "rootflag")
+	checkStringOmits(t, output, rootCmd.Short)
+	checkStringOmits(t, output, echoSubCmd.Short)
 	checkStringOmits(t, output, deprecatedCmd.Short)
 	checkStringOmits(t, output, "Options inherited from parent commands")
 }