From: Stefan Sperling <stsp@stsp.name>
Subject: Re: Always list aliases before full command
To: gameoftrees@openbsd.org
Date: Mon, 4 Oct 2021 15:21:14 +0200

On Mon, Oct 04, 2021 at 01:11:16PM +0000, Klemens Nanni wrote:
> On Mon, Oct 04, 2021 at 02:54:11PM +0200, Stefan Sperling wrote:
> > 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
> 
> This won't produce a tag, i.e. ":tim" will not jump here after your
> diff.
> 
> We could do the following which preserves tags and is shorter but also
> more terse -- not sure of people like it.  I have no preference.

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?