From 6b5ccdf15ac799bc190084d69ded8e38f1e79cb9 Mon Sep 17 00:00:00 2001 From: Eugene Triguba Date: Sat, 27 Dec 2025 05:38:06 -0500 Subject: Add ManHelpCommand to delegate 'help' to opening man pages --- subcmd.go | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) (limited to 'subcmd.go') diff --git a/subcmd.go b/subcmd.go index a8ed787..56f778b 100644 --- a/subcmd.go +++ b/subcmd.go @@ -8,6 +8,7 @@ import ( "fmt" "io" "os" + "os/exec" "sort" "strings" ) @@ -231,6 +232,49 @@ func (h *helpCommand) Execute(ctx context.Context, f *flag.FlagSet, args ...any) return ExitSuccess } +// manHelpCommand implements a help command that opens man pages. +type manHelpCommand struct { + prefix string +} + +// ManHelpCommand returns a help command that opens man pages. +// +// The prefix is used to construct man page names: "prefix" for +// the main page, "prefix-subcommand" for subcommand pages. This +// is a common convention e.g. git(1), git-commit(1), ... +func ManHelpCommand(prefix string) Command { + return &manHelpCommand{prefix: prefix} +} + +func (m *manHelpCommand) Name() string { return "help" } +func (m *manHelpCommand) Synopsis() string { return "show manual page" } +func (m *manHelpCommand) Usage() string { + return "help []\n\nOpen the manual page for a subcommand.\n" +} +func (m *manHelpCommand) SetFlags(f *flag.FlagSet) {} +func (m *manHelpCommand) Execute(ctx context.Context, f *flag.FlagSet, args ...any) ExitStatus { + page := m.prefix + if f.NArg() > 0 { + for _, arg := range f.Args() { + page = page + "-" + arg + } + } + + cmd := execCommand("man", page) + cmd.Stdin = os.Stdin + cmd.Stdout = os.Stdout + cmd.Stderr = os.Stderr + if err := cmd.Run(); err != nil { + return ExitFailure + } + return ExitSuccess +} + +// execCommand is a thin wrapper around exec.Command to ease testing. +var execCommand = func(name string, args ...string) *exec.Cmd { + return exec.Command(name, args...) +} + // commandsCommand implements the built-in commands listing command. type commandsCommand struct { registry *Registry -- cgit v1.2.3