whatcanGOwrong

go/pkg/mod/github.com/go-delve/delve@v1.23.0/_scripts/gen-usage-docs.go

@@ -0,0 +1,45 @@
+//go:build ignore
+
+package main
+
+import (
+	"fmt"
+	"log"
+	"os"
+	"path/filepath"
+
+	"github.com/go-delve/delve/cmd/dlv/cmds"
+	"github.com/go-delve/delve/cmd/dlv/cmds/helphelpers"
+	"github.com/spf13/cobra/doc"
+)
+
+const defaultUsageDir = "./Documentation/usage"
+
+func main() {
+	usageDir := defaultUsageDir
+	if len(os.Args) > 1 {
+		usageDir = os.Args[1]
+	}
+	root := cmds.New(true)
+
+	cmdnames := []string{}
+	for _, subcmd := range root.Commands() {
+		cmdnames = append(cmdnames, subcmd.Name())
+	}
+	helphelpers.Prepare(root)
+	doc.GenMarkdownTree(root, usageDir)
+	root = nil
+	// GenMarkdownTree ignores additional help topic commands, so we have to do this manually
+	for _, cmdname := range cmdnames {
+		cmd, _, _ := cmds.New(true).Find([]string{cmdname})
+		helphelpers.Prepare(cmd)
+		doc.GenMarkdownTree(cmd, usageDir)
+	}
+	fh, err := os.OpenFile(filepath.Join(usageDir, "dlv.md"), os.O_APPEND|os.O_WRONLY, 0)
+	if err != nil {
+		log.Fatalf("appending to dlv.md: %v", err)
+	}
+	defer fh.Close()
+	fmt.Fprintln(fh, "* [dlv log](dlv_log.md)\t - Help about logging flags")
+	fmt.Fprintln(fh, "* [dlv backend](dlv_backend.md)\t - Help about the `--backend` flag")
+}