On Mon, Oct 04, 2021 at 12:42:37PM +0000, Klemens Nanni wrote:
> Sorry for the noise, here's without mangled headers and with a commit
> message this time...
>  
>  Always list aliases before full command
>  
>  Break the alphanumerical sort order for cases like `co` and `checkout`
>  such that searching for tags of aliases (i.e. typing ":tco<Enter>" in
>  less(1)) jumps to `co` immediately followed by `checkout` which has
>  all relevant information.
>  
>  Otherwise navigating to aliases requires further annoying navigation.

Would it be worth integrating aliases into the command synopsis, or
into the text block that describes a command?

For example:

diff 136be4cc66ac0ccf41b481e5a22587681c050365 /home/stsp/src/got
blob - 450e4baab5541257e9c371762a5fe893fa1c19bb
file + got/got.1
--- got/got.1
+++ got/got.1
@@ -74,6 +74,9 @@ command must be used to populate the empty repository 
 .Cm got checkout
 can be used.
 .It Cm import Oo Fl b Ar branch Oc Oo Fl m Ar message Oc Oo Fl r Ar repository-path Oc Oo Fl I Ar pattern Oc Ar directory
+Short alias:
+.Cm im
+.Pp
 Create an initial commit in a repository from the file hierarchy
 within the specified
 .Ar directory .
@@ -132,9 +135,6 @@ 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
 Clone a Git repository at the specified
 .Ar repository-URL