From: Thomas Adam <thomas@xteddy.org>
Subject: Re: Always list aliases before full command
To: gameoftrees@openbsd.org
Date: Mon, 4 Oct 2021 15:38:49 +0100

On Mon, Oct 04, 2021 at 03:21:14PM +0200, Stefan Sperling wrote:

Hi,

> I don't know. It feels a bit like this tagging feature is lacking
> something when it requires us to reformat our pages like this to work.
> 
> I guess we could ask Ingo what to do about this?

Indeed.  In tmux, we do something like this:

--- a/got/got.1
+++ b/got/got.1
@@ -132,10 +132,8 @@ The
 follows the globbing rules documented in
 .Xr glob 7 .
 .El
-.It Cm im
-Short alias for
-.Cm import .
 .It Cm clone Oo Fl a Oc Oo Fl b Ar branch Oc Oo Fl l Oc Oo Fl m Oc Oo Fl q Oc Oo Fl v Oc Oo Fl R Ar reference Oc Ar repository-URL Op Ar directory
+.Dl (alias: Ic cl )

Which is not really any different to what we have in Got's man page now, it
just keeps the alias closer with the command synopsis.

Kindly,
Thomas