go.mod

@@ -7,13 +7,13 @@ require (
 	github.com/pkg/sftp v1.13.6
 	github.com/rs/zerolog v1.33.0
 	github.com/stretchr/testify v1.9.0
-	github.com/urfave/cli/v2 v2.27.5
+	github.com/urfave/cli/v2 v2.27.4
 	golang.org/x/crypto v0.27.0
 	gopkg.in/yaml.v3 v3.0.1
 )
 
 require (
-	github.com/cpuguy83/go-md2man/v2 v2.0.5 // indirect
+	github.com/cpuguy83/go-md2man/v2 v2.0.4 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/jmespath/go-jmespath v0.4.0 // indirect
 	github.com/kr/fs v0.1.0 // indirect

go.sum

@@ -7,8 +7,6 @@ github.com/cpuguy83/go-md2man/v2 v2.0.2 h1:p1EgwI/C7NhT0JmVkwCD2ZBK8j4aeHQX2pMHH
 github.com/cpuguy83/go-md2man/v2 v2.0.2/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
 github.com/cpuguy83/go-md2man/v2 v2.0.4 h1:wfIWP927BUkWJb2NmU/kNDYIBTh/ziUX91+lVfRxZq4=
 github.com/cpuguy83/go-md2man/v2 v2.0.4/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
-github.com/cpuguy83/go-md2man/v2 v2.0.5 h1:ZtcqGrnekaHpVLArFSe4HK5DoKx1T0rq2DwVB0alcyc=
-github.com/cpuguy83/go-md2man/v2 v2.0.5/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
@@ -48,8 +46,6 @@ github.com/urfave/cli/v2 v2.25.7 h1:VAzn5oq403l5pHjc4OhD54+XGO9cdKVL/7lDjF+iKUs=
 github.com/urfave/cli/v2 v2.25.7/go.mod h1:8qnjx1vcq5s2/wpsqoZFndg2CE5tNFyrTvS6SinrnYQ=
 github.com/urfave/cli/v2 v2.27.4 h1:o1owoI+02Eb+K107p27wEX9Bb8eqIoZCfLXloLUSWJ8=
 github.com/urfave/cli/v2 v2.27.4/go.mod h1:m4QzxcD2qpra4z7WhzEGn74WZLViBnMpb1ToCAKdGRQ=
-github.com/urfave/cli/v2 v2.27.5 h1:WoHEJLdsXr6dDWoJgMq/CboDmyY/8HMMH1fTECbih+w=
-github.com/urfave/cli/v2 v2.27.5/go.mod h1:3Sevf16NykTbInEnD0yKkjDAeZDS0A6bzhBH5hrMvTQ=
 github.com/xrash/smetrics v0.0.0-20201216005158-039620a65673 h1:bAn7/zixMGCfxrRTfdpNzjtPYqr8smhKouy9mxVdGPU=
 github.com/xrash/smetrics v0.0.0-20201216005158-039620a65673/go.mod h1:N3UwUGtsrSj3ccvlPHLoLsHnpR27oXr4ZE984MbSER8=
 github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1 h1:gEOO8jv9F4OT7lGCjxCBTO/36wtF6j2nSip77qHd4x4=

vendor/github.com/cpuguy83/go-md2man/v2/md2man/debug.go

@@ -1,62 +0,0 @@
-package md2man
-
-import (
-	"fmt"
-	"io"
-	"os"
-	"strings"
-
-	"github.com/russross/blackfriday/v2"
-)
-
-func fmtListFlags(flags blackfriday.ListType) string {
-	knownFlags := []struct {
-		name string
-		flag blackfriday.ListType
-	}{
-		{"ListTypeOrdered", blackfriday.ListTypeOrdered},
-		{"ListTypeDefinition", blackfriday.ListTypeDefinition},
-		{"ListTypeTerm", blackfriday.ListTypeTerm},
-		{"ListItemContainsBlock", blackfriday.ListItemContainsBlock},
-		{"ListItemBeginningOfList", blackfriday.ListItemBeginningOfList},
-		{"ListItemEndOfList", blackfriday.ListItemEndOfList},
-	}
-
-	var f []string
-	for _, kf := range knownFlags {
-		if flags&kf.flag != 0 {
-			f = append(f, kf.name)
-			flags &^= kf.flag
-		}
-	}
-	if flags != 0 {
-		f = append(f, fmt.Sprintf("Unknown(%#x)", flags))
-	}
-	return strings.Join(f, "|")
-}
-
-type debugDecorator struct {
-	blackfriday.Renderer
-}
-
-func depth(node *blackfriday.Node) int {
-	d := 0
-	for n := node.Parent; n != nil; n = n.Parent {
-		d++
-	}
-	return d
-}
-
-func (d *debugDecorator) RenderNode(w io.Writer, node *blackfriday.Node, entering bool) blackfriday.WalkStatus {
-	fmt.Fprintf(os.Stderr, "%s%s %v %v\n",
-		strings.Repeat("  ", depth(node)),
-		map[bool]string{true: "+", false: "-"}[entering],
-		node,
-		fmtListFlags(node.ListFlags))
-	var b strings.Builder
-	status := d.Renderer.RenderNode(io.MultiWriter(&b, w), node, entering)
-	if b.Len() > 0 {
-		fmt.Fprintf(os.Stderr, ">> %q\n", b.String())
-	}
-	return status
-}

vendor/github.com/cpuguy83/go-md2man/v2/md2man/md2man.go

@@ -1,23 +1,16 @@
 package md2man
 
 import (
-	"os"
-	"strconv"
-
 	"github.com/russross/blackfriday/v2"
 )
 
 // Render converts a markdown document into a roff formatted document.
 func Render(doc []byte) []byte {
 	renderer := NewRoffRenderer()
-	var r blackfriday.Renderer = renderer
-	if v, _ := strconv.ParseBool(os.Getenv("MD2MAN_DEBUG")); v {
-		r = &debugDecorator{Renderer: r}
-	}
 
 	return blackfriday.Run(doc,
 		[]blackfriday.Option{
-			blackfriday.WithRenderer(r),
+			blackfriday.WithRenderer(renderer),
 			blackfriday.WithExtensions(renderer.GetExtensions()),
 		}...)
 }

vendor/github.com/cpuguy83/go-md2man/v2/md2man/roff.go

@@ -14,8 +14,10 @@ import (
 // roffRenderer implements the blackfriday.Renderer interface for creating
 // roff format (manpages) from markdown text
 type roffRenderer struct {
+	extensions   blackfriday.Extensions
 	listCounters []int
 	firstHeader  bool
+	firstDD      bool
 	listDepth    int
 }
 
@@ -41,7 +43,7 @@ const (
 	quoteTag          = "\n.PP\n.RS\n"
 	quoteCloseTag     = "\n.RE\n"
 	listTag           = "\n.RS\n"
-	listCloseTag      = ".RE\n"
+	listCloseTag      = "\n.RE\n"
 	dtTag             = "\n.TP\n"
 	dd2Tag            = "\n"
 	tableStart        = "\n.TS\nallbox;\n"
@@ -54,18 +56,23 @@ const (
 // NewRoffRenderer creates a new blackfriday Renderer for generating roff documents
 // from markdown
 func NewRoffRenderer() *roffRenderer { // nolint: golint
-	return &roffRenderer{}
+	var extensions blackfriday.Extensions
+
+	extensions |= blackfriday.NoIntraEmphasis
+	extensions |= blackfriday.Tables
+	extensions |= blackfriday.FencedCode
+	extensions |= blackfriday.SpaceHeadings
+	extensions |= blackfriday.Footnotes
+	extensions |= blackfriday.Titleblock
+	extensions |= blackfriday.DefinitionLists
+	return &roffRenderer{
+		extensions: extensions,
+	}
 }
 
 // GetExtensions returns the list of extensions used by this renderer implementation
-func (*roffRenderer) GetExtensions() blackfriday.Extensions {
+func (r *roffRenderer) GetExtensions() blackfriday.Extensions {
-	return blackfriday.NoIntraEmphasis |
+	return r.extensions
-		blackfriday.Tables |
-		blackfriday.FencedCode |
-		blackfriday.SpaceHeadings |
-		blackfriday.Footnotes |
-		blackfriday.Titleblock |
-		blackfriday.DefinitionLists
 }
 
 // RenderHeader handles outputting the header at document start
@@ -96,23 +103,7 @@ func (r *roffRenderer) RenderNode(w io.Writer, node *blackfriday.Node, entering
 
 	switch node.Type {
 	case blackfriday.Text:
-		// Special case: format the NAME section as required for proper whatis parsing.
+		escapeSpecialChars(w, node.Literal)
-		// Refer to the lexgrog(1) and groff_man(7) manual pages for details.
-		if node.Parent != nil &&
-			node.Parent.Type == blackfriday.Paragraph &&
-			node.Parent.Prev != nil &&
-			node.Parent.Prev.Type == blackfriday.Heading &&
-			node.Parent.Prev.FirstChild != nil &&
-			bytes.EqualFold(node.Parent.Prev.FirstChild.Literal, []byte("NAME")) {
-			before, after, found := bytes.Cut(node.Literal, []byte(" - "))
-			escapeSpecialChars(w, before)
-			if found {
-				out(w, ` \- `)
-				escapeSpecialChars(w, after)
-			}
-		} else {
-			escapeSpecialChars(w, node.Literal)
-		}
 	case blackfriday.Softbreak:
 		out(w, crTag)
 	case blackfriday.Hardbreak:
@@ -150,25 +141,14 @@ func (r *roffRenderer) RenderNode(w io.Writer, node *blackfriday.Node, entering
 	case blackfriday.Document:
 		break
 	case blackfriday.Paragraph:
+		// roff .PP markers break lists
+		if r.listDepth > 0 {
+			return blackfriday.GoToNext
+		}
 		if entering {
-			if r.listDepth > 0 {
+			out(w, paraTag)
-				// roff .PP markers break lists
-				if node.Prev != nil { // continued paragraph
-					if node.Prev.Type == blackfriday.List && node.Prev.ListFlags&blackfriday.ListTypeDefinition == 0 {
-						out(w, ".IP\n")
-					} else {
-						out(w, crTag)
-					}
-				}
-			} else if node.Prev != nil && node.Prev.Type == blackfriday.Heading {
-				out(w, crTag)
-			} else {
-				out(w, paraTag)
-			}
 		} else {
-			if node.Next == nil || node.Next.Type != blackfriday.List {
+			out(w, crTag)
-				out(w, crTag)
-			}
 		}
 	case blackfriday.BlockQuote:
 		if entering {
@@ -231,10 +211,6 @@ func (r *roffRenderer) handleHeading(w io.Writer, node *blackfriday.Node, enteri
 func (r *roffRenderer) handleList(w io.Writer, node *blackfriday.Node, entering bool) {
 	openTag := listTag
 	closeTag := listCloseTag
-	if (entering && r.listDepth == 0) || (!entering && r.listDepth == 1) {
-		openTag = crTag
-		closeTag = ""
-	}
 	if node.ListFlags&blackfriday.ListTypeDefinition != 0 {
 		// tags for definition lists handled within Item node
 		openTag = ""
@@ -263,25 +239,23 @@ func (r *roffRenderer) handleItem(w io.Writer, node *blackfriday.Node, entering
 		} else if node.ListFlags&blackfriday.ListTypeTerm != 0 {
 			// DT (definition term): line just before DD (see below).
 			out(w, dtTag)
+			r.firstDD = true
 		} else if node.ListFlags&blackfriday.ListTypeDefinition != 0 {
 			// DD (definition description): line that starts with ": ".
 			//
 			// We have to distinguish between the first DD and the
 			// subsequent ones, as there should be no vertical
 			// whitespace between the DT and the first DD.
-			if node.Prev != nil && node.Prev.ListFlags&(blackfriday.ListTypeTerm|blackfriday.ListTypeDefinition) == blackfriday.ListTypeDefinition {
+			if r.firstDD {
-				if node.Prev.Type == blackfriday.Item &&
+				r.firstDD = false
-					node.Prev.LastChild != nil &&
+			} else {
-					node.Prev.LastChild.Type == blackfriday.List &&
+				out(w, dd2Tag)
-					node.Prev.LastChild.ListFlags&blackfriday.ListTypeDefinition == 0 {
-					out(w, ".IP\n")
-				} else {
-					out(w, dd2Tag)
-				}
 			}
 		} else {
 			out(w, ".IP \\(bu 2\n")
 		}
+	} else {
+		out(w, "\n")
 	}
 }
 

vendor/github.com/urfave/cli/v2/help.go

@@ -150,7 +150,7 @@ func printCommandSuggestions(commands []*Command, writer io.Writer) {
 		if command.Hidden {
 			continue
 		}
-		if strings.HasSuffix(os.Getenv("0"), "zsh") {
+		if strings.HasSuffix(os.Getenv("SHELL"), "zsh") {
 			for _, name := range command.Names() {
 				_, _ = fmt.Fprintf(writer, "%s:%s\n", name, command.Usage)
 			}

vendor/modules.txt

@@ -51,7 +51,7 @@ github.com/aws/aws-sdk-go/service/sso/ssoiface
 github.com/aws/aws-sdk-go/service/ssooidc
 github.com/aws/aws-sdk-go/service/sts
 github.com/aws/aws-sdk-go/service/sts/stsiface
-# github.com/cpuguy83/go-md2man/v2 v2.0.5
+# github.com/cpuguy83/go-md2man/v2 v2.0.4
 ## explicit; go 1.11
 github.com/cpuguy83/go-md2man/v2/md2man
 # github.com/davecgh/go-spew v1.1.1
@@ -88,7 +88,7 @@ github.com/russross/blackfriday/v2
 # github.com/stretchr/testify v1.9.0
 ## explicit; go 1.17
 github.com/stretchr/testify/assert
-# github.com/urfave/cli/v2 v2.27.5
+# github.com/urfave/cli/v2 v2.27.4
 ## explicit; go 1.18
 github.com/urfave/cli/v2
 # github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1