Minor manpage clean up; add some examples

bwrap.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm bwrap
-.Nd Wrap input text as a unit
+.Nd wrap input text as a unit
 .Sh SYNOPSIS
 .Nm
 .Sh DESCRIPTION

hppt.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm hppt
-.Nd Reformat stdin as a horizontal paper tape
+.Nd reformat stdin as a horizontal paper tape
 .Sh SYNOPSIS
 .Nm
 .Sh DESCRIPTION

mkgmap.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm mkgmap
-.Nd Create a simple Gophermap for the current directory
+.Nd create a simple Gophermap for the current directory
 .Sh SYNOPSIS
 .Nm
 .Sh DESCRIPTION

newp.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm newp
-.Nd Create a new phlog post
+.Nd create a new phlog post
 .Sh SYNOPSIS
 .Nm
 .Ar word ...

osc.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm osc
-.Nd Print OSC escape sequences
+.Nd print OSC escape sequences
 .Sh SYNOPSIS
 .Nm
 .Cm pwd
@@ -19,12 +19,12 @@ prints an OSC escape sequence to stdout if connected to a tty.
 If stdout is not a TTY, prints nothing.
 .Pp
 Three escape sequences are supported:
-.Bl -tag
-.It pwd
+.Bl -tag -width Ds
+.It Cm pwd
 ESC 7, set current working directory.
-.It link
+.It Cm link
 ESC 8, display an URI.
-.It title
+.It Cm title
 ESC 2, set a title for the current window.
 .El
 .Pp

p.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm p
-.Nd Paginate
+.Nd paginate
 .Sh SYNOPSIS
 .Nm
 .Op Fl number

pick.1

@@ -1,18 +1,20 @@
-.Dd Sep 13, 2023
+.Dd December 15, 2025
 .Dt PICK 1
 .Os
 .Sh NAME
 .Nm pick
-.Nd Choose interactively from the set of arguments and input lines
+.Nd choose interactively from a set of arguments and input lines
 .Sh SYNOPSIS
 .Nm
 .Ar arg ...
 .Sh DESCRIPTION
 .Nm
-will display a Korn shell style selection menu with stdin contents and
-arguments as options.
+will display a Korn shell style selection menu with any arguments as options.
+The special argument
+.Ar --
+will read stdin and present each line as a choice.
 .Pp
-When a selection is made, the command will print its value to stdout.
+When a selection is made, the command will print its value to stdout;
 If the selection is aborted, nothing will be printed.
 .Sh ENVIRONMENT
 .Bl -tag -width PS3
@@ -21,5 +23,22 @@ Prompt string displayed to the user (default: #?).
 .El
 .Sh EXIT STATUS
 .Ex -std
+.Sh EXAMPLES
+.Bd -literal -offset indent
+$ pick 1 2 -- 3 4 <<.
+> a
+> b
+> c
+> .
+1) 1
+2) 2
+3) a
+4) b
+5) c
+6) 3
+7) 4
+#? 4
+b
+.Ed
 .Sh AUTHORS
 .An Adolfo Perez Alvarez Aq Mt adolfopa@sdf.org

rot.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm rot
-.Nd Rotate stdin 90 degrees
+.Nd rotate stdin 90 degrees
 .Sh SYNOPSIS
 .Nm
 .Sh DESCRIPTION

scmfmt.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm scmfmt
-.Nd Format a commit message
+.Nd format a commit message
 .Sh SYNOPSIS
 .Nm
 .Sh DESCRIPTION

ts.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm ts
-.Nd Run shell tests 
+.Nd run shell tests 
 .Sh SYNOPSIS
 .Nm
 .Op Fl b

unpage.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm unpage
-.Nd Remove page headers and footers from text documents
+.Nd remove page headers and footers from text documents
 .Sh SYNOPSIS
 .Nm
 .Sh DESCRIPTION

upcasetl.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm upcasetl
-.Nd Upcase titles and section headers in an ms troff document
+.Nd upcase titles and section headers in an ms troff document
 .Sh SYNOPSIS
 .Nm
 .Sh DESCRIPTION