On Wed, Nov 03, 2021 at 06:30:55PM -0400, Josh Rickmar wrote:
> I'm not familiar enough with mdoc to determine if this is a manpage
> bug or a rendering bug, but mandoc -Thtml doesn't nicely render the
> command aliases in tmux, but instead moves the terminating ) outside
> of the div so it appears on the next paragraph.
>
> https://man.openbsd.org/tmux#attach-session
>
> This mdoc:
>
> .D1 (alias: Ic attach )
> If run from outside
>
> is being converted to this HTML:
>
> <dd>
> <div class="Bd Bd-indent">(alias: <code class="Ic">attach</code></div>
> ) If run from outside <code class="Nm">tmux</code>, create a new client in
>
Fixed by using the proper mdoc(7) macro. I'll apply the same to got(1)
which recently got this tmux-like alias lines.
lass="Bd Bd-indent">(alias: <code class="Ic">attach</code>)</div>
Index: tmux.1
===================================================================
RCS file: /cvs/src/usr.bin/tmux/tmux.1,v
retrieving revision 1.869
diff -u -p -U0 -r1.869 tmux.1
--- tmux.1 3 Nov 2021 13:37:17 -0000 1.869
+++ tmux.1 4 Nov 2021 13:00:19 -0000
@@ -1037 +1037 @@ The following commands are available to
-.D1 (alias: Ic attach )
+.D1 Pq alias: Ic attach
@@ -1124 +1124 @@ option will not be applied.
-.D1 (alias: Ic detach )
+.D1 Pq alias: Ic detach
@@ -1146 +1146 @@ to replace the client.
-.D1 (alias: Ic has )
+.D1 Pq alias: Ic has
@@ -1171 +1171 @@ session.
-.D1 (alias: Ic lsc )
+.D1 Pq alias: Ic lsc
@@ -1186 +1186 @@ is specified, list only clients connecte
-.D1 (alias: Ic lscm )
+.D1 Pq alias: Ic lscm
@@ -1196 +1196 @@ or - if omitted - of all commands suppor
-.D1 (alias: Ic ls )
+.D1 Pq alias: Ic ls
@@ -1208 +1208 @@ section.
-.D1 (alias: Ic lockc )
+.D1 Pq alias: Ic lockc
@@ -1216 +1216 @@ command.
-.D1 (alias: Ic locks )
+.D1 Pq alias: Ic locks
@@ -1233 +1233 @@ Lock all clients attached to
-.D1 (alias: Ic new )
+.D1 Pq alias: Ic new
@@ -1349 +1349 @@ specified multiple times.
-.D1 (alias: Ic refresh )
+.D1 Pq alias: Ic refresh
@@ -1480 +1480 @@ option.
-.D1 (alias: Ic rename )
+.D1 Pq alias: Ic rename
@@ -1488 +1488 @@ Rename the session to
-.D1 (alias: Ic showmsgs )
+.D1 Pq alias: Ic showmsgs
@@ -1503 +1503 @@ show debugging information about jobs an
-.D1 (alias: Ic source )
+.D1 Pq alias: Ic source
@@ -1526 +1526 @@ shows the parsed commands and line numbe
-.D1 (alias: Ic start )
+.D1 Pq alias: Ic start
@@ -1545 +1545 @@ $ tmux start \\; show -g
-.D1 (alias: Ic suspendc )
+.D1 Pq alias: Ic suspendc
@@ -1556 +1556 @@ Suspend a client by sending
-.D1 (alias: Ic switchc )
+.D1 Pq alias: Ic switchc
@@ -1948 +1948 @@ Commands related to windows and panes ar
-.D1 (alias: Ic breakp )
+.D1 Pq alias: Ic breakp
@@ -1977 +1977 @@ but a different format may be specified
-.D1 (alias: Ic capturep )
+.D1 Pq alias: Ic capturep
@@ -2229 +2229 @@ This command works only if at least one
-.D1 (alias: Ic displayp )
+.D1 Pq alias: Ic displayp
@@ -2269 +2269 @@ other commands are not blocked from runn
-.D1 (alias: Ic findw )
+.D1 Pq alias: Ic findw
@@ -2299 +2299 @@ This command works only if at least one
-.D1 (alias: Ic joinp )
+.D1 Pq alias: Ic joinp
@@ -2327 +2327 @@ the marked pane is used rather than the
-.D1 (alias: Ic killp )
+.D1 Pq alias: Ic killp
@@ -2339 +2339 @@ option kills all but the pane given with
-.D1 (alias: Ic killw )
+.D1 Pq alias: Ic killw
@@ -2352 +2352 @@ option kills all but the window given wi
-.D1 (alias: Ic lastp )
+.D1 Pq alias: Ic lastp
@@ -2362 +2362 @@ disables input to the pane.
-.D1 (alias: Ic last )
+.D1 Pq alias: Ic last
@@ -2373 +2373 @@ is specified, select the last window of
-.D1 (alias: Ic linkw )
+.D1 Pq alias: Ic linkw
@@ -2405 +2405 @@ is given, the newly linked window is not
-.D1 (alias: Ic lsp )
+.D1 Pq alias: Ic lsp
@@ -2434 +2434 @@ section.
-.D1 (alias: Ic lsw )
+.D1 Pq alias: Ic lsw
@@ -2455 +2455 @@ section.
-.D1 (alias: Ic movep )
+.D1 Pq alias: Ic movep
@@ -2464 +2464 @@ Does the same as
-.D1 (alias: Ic movew )
+.D1 Pq alias: Ic movew
@@ -2487 +2487 @@ option.
-.D1 (alias: Ic neww )
+.D1 Pq alias: Ic neww
@@ -2562 +2562 @@ but a different format may be specified
-.D1 (alias: Ic nextl )
+.D1 Pq alias: Ic nextl
@@ -2569 +2569 @@ Move a window to the next layout and rea
-.D1 (alias: Ic next )
+.D1 Pq alias: Ic next
@@ -2580 +2580 @@ is used, move to the next window with an
-.D1 (alias: Ic pipep )
+.D1 Pq alias: Ic pipep
@@ -2627 +2627 @@ bind-key C-p pipe-pane -o 'cat >>~/outpu
-.D1 (alias: Ic prevl )
+.D1 Pq alias: Ic prevl
@@ -2634 +2634 @@ Move to the previous layout in the sessi
-.D1 (alias: Ic prev )
+.D1 Pq alias: Ic prev
@@ -2644 +2644 @@ move to the previous window with an aler
-.D1 (alias: Ic renamew )
+.D1 Pq alias: Ic renamew
@@ -2657 +2657 @@ if specified, to
-.D1 (alias: Ic resizep )
+.D1 Pq alias: Ic resizep
@@ -2702 +2702 @@ history to replace them.
-.D1 (alias: Ic resizew )
+.D1 Pq alias: Ic resizew
@@ -2735 +2735 @@ to manual in the window options.
-.D1 (alias: Ic respawnp )
+.D1 Pq alias: Ic respawnp
@@ -2761 +2761 @@ command.
-.D1 (alias: Ic respawnw )
+.D1 Pq alias: Ic respawnw
@@ -2784 +2784 @@ command.
-.D1 (alias: Ic rotatew )
+.D1 Pq alias: Ic rotatew
@@ -2797 +2797 @@ keeps the window zoomed if it was zoomed
-.D1 (alias: Ic selectl )
+.D1 Pq alias: Ic selectl
@@ -2820 +2820 @@ spreads the current pane and any panes n
-.D1 (alias: Ic selectp )
+.D1 Pq alias: Ic selectp
@@ -2864 +2864 @@ and
-.D1 (alias: Ic selectw )
+.D1 Pq alias: Ic selectw
@@ -2892 +2892 @@ the command behaves like
-.D1 (alias: Ic splitw )
+.D1 Pq alias: Ic splitw
@@ -2949 +2949 @@ command.
-.D1 (alias: Ic swapp )
+.D1 Pq alias: Ic swapp
@@ -2978 +2978 @@ the marked pane is used rather than the
-.D1 (alias: Ic swapw )
+.D1 Pq alias: Ic swapw
@@ -2999 +2999 @@ the window containing the marked pane is
-.D1 (alias: Ic unlinkw )
+.D1 Pq alias: Ic unlinkw
@@ -3072 +3072 @@ Commands related to key bindings are as
-.D1 (alias: Ic bind )
+.D1 Pq alias: Ic bind
@@ -3130 +3130 @@ command.
-.D1 (alias: Ic lsk )
+.D1 Pq alias: Ic lsk
@@ -3167 +3167 @@ lists the command for keys that do not h
-.D1 (alias: Ic send )
+.D1 Pq alias: Ic send
@@ -3218 +3218 @@ the secondary prefix key, to a window as
-.D1 (alias: Ic unbind )
+.D1 Pq alias: Ic unbind
@@ -3314 +3314 @@ Commands which set options are as follow
-.D1 (alias: Ic set )
+.D1 Pq alias: Ic set
@@ -3389 +3389 @@ the result would be the default backgrou
-.D1 (alias: Ic show )
+.D1 Pq alias: Ic show
@@ -5428 +5428 @@ Commands to alter and view the environme
-.D1 (alias: Ic setenv )
+.D1 Pq alias: Ic setenv
@@ -5454 +5454 @@ marks the variable as hidden.
-.D1 (alias: Ic showenv )
+.D1 Pq alias: Ic showenv
@@ -5537 +5537 @@ Commands related to the status line are
-.D1 (alias: Ic clrphist )
+.D1 Pq alias: Ic clrphist
@@ -5663 +5663 @@ until it is dismissed.
-.D1 (alias: Ic confirm )
+.D1 Pq alias: Ic confirm
@@ -5692 +5692 @@ until it is dismissed.
-.D1 (alias: Ic menu )
+.D1 Pq alias: Ic menu
@@ -5779 +5779 @@ The following keys are also available:
-.D1 (alias: Ic display )
+.D1 Pq alias: Ic display
@@ -5830 +5830 @@ forwards any input read from stdin to th
-.D1 (alias: Ic popup )
+.D1 Pq alias: Ic popup
@@ -5903 +5903 @@ flag closes any popup on the client.
-.D1 (alias: Ic showphist )
+.D1 Pq alias: Ic showphist
@@ -6031 +6031 @@ This command works only if at least one
-.D1 (alias: Ic clearhist )
+.D1 Pq alias: Ic clearhist
@@ -6035 +6035 @@ Remove and free the history for the spec
-.D1 (alias: Ic deleteb )
+.D1 Pq alias: Ic deleteb
@@ -6044 +6044 @@ or the most recently added automatically
-.D1 (alias: Ic lsb )
+.D1 Pq alias: Ic lsb
@@ -6061 +6061 @@ section.
-.D1 (alias: Ic loadb )
+.D1 Pq alias: Ic loadb
@@ -6078 +6078 @@ escape sequence, if possible.
-.D1 (alias: Ic pasteb )
+.D1 Pq alias: Ic pasteb
@@ -6102 +6102 @@ buffer if the application has requested
-.D1 (alias: Ic saveb )
+.D1 Pq alias: Ic saveb
@@ -6116 +6116 @@ option appends to rather than overwritin
-.D1 (alias: Ic setb )
+.D1 Pq alias: Ic setb
@@ -6137 +6137 @@ option renames the buffer to
-.D1 (alias: Ic showb )
+.D1 Pq alias: Ic showb
@@ -6152 +6152 @@ Display a large clock.
-.D1 (alias: Ic if )
+.D1 Pq alias: Ic if
@@ -6179 +6179 @@ are expanded).
-.D1 (alias: Ic lock )
+.D1 Pq alias: Ic lock
@@ -6190 +6190 @@ option.
-.D1 (alias: Ic run )
+.D1 Pq alias: Ic run
@@ -6222 +6222 @@ If the command fails, the exit status is
-.D1 (alias: Ic wait )
+.D1 Pq alias: Ic wait
