Re: Select completions from the minibuffer

[Ergus <spacibba@aol.com>]

BTW Eli:

Some of the new and old completions customs have some name miss-matches:
some of them are called completion-something and some others are
completions-something in plural.

There are some of them with `:group 'completion` while others don't have
that... could you please check if the names could be standardized and
may be added to the right group??

Specially the options I added I am not sure if they are well named and
for sure they don't have a group name...



On Tue, Mar 22, 2022 at 04:49:59PM +0200, Eli Zaretskii wrote:
>> Date: Tue, 22 Mar 2022 15:18:15 +0100
>> From: Ergus <spacibba@aol.com>
>> Cc: Juri Linkov <juri@linkov.net>, larsi@gnus.org, emacs-devel@gnu.org
>>
>> >  +@code{t} the completions are hidden when some unique completion is
>> >  +executed.
>> >
>> >What do you mean by "unique completion is executed"?  Both the
>> >"unique" and the "executed" parts need clarification.
>> >
>> unique means that, there is a single candidate o prefix so the <tab>
>> "added" some letter. example: com<tab>pi<tab> -> compil
>>
>> The first tab shows completions but the second hides it... it is a bit
>> confusing compared to any other completion engine (bash, zsh,
>> fish)... that's why I started this changes...
>
>So we could simply say
>
>  when Emacs is able to complete some characters
>
>is that right?
>
>> > If @code{completion-auto-help} is set to @code{always}, the
>> >  +completion commands are always shown after a completion attempt, or
>> >
>> >"Commands"? didn't you mean "candidates" or "alternatives"?  (The same
>> >problem exists in the doc string of this variable, btw.)
>> >
>> Maybe candidates is better,
>
>If it's just "better", then please explain what you mean by
>"commands".  The text I quoted above says "the completion commands are
>always shown".  What are those "commands" that are shown after a
>completion attempt?
>
>> >  If the value is @code{visible}, Emacs displays completion the
>> >  completion alternatives when it is unable to complete for the first
>> >  time; thereafter the completion list buffer remains visible and is
>> >  updated as you type.
>> >
>> >Is this accurate and correct?
>> >
>> "and is updated as you type."
>>
>> I am not sure that last part is accurate. updates need <tab> to update
>> in all cases. "as you type" suggests more an icomplete-like behavior I
>> thinks.
>
>Ok, so "the completion list buffer remains visible for all the
>subsequent completion attempts".  Better?
>
>> >  +current completion candidate will be highlighted with that face.  The
>> >  +default value is @code{completions-highlight}.  When the value is
>> >  +@code{nil}, no highlighting is performed.  This feature sets the text
>> >  +property @code{cursor-face}.
>> >
>> >This should explain what is "the current completion candidate".  It
>> >isn't trivial: trying the current defaults with completion commands, I
>> >sometimes see a candidate highlighted, and sometimes don't.  I
>> >couldn't figure out why.
>> >
>>
>> when it is not highlighting? So far the only way to not have a candidate
>> highlighted is when there is not candidate effectively selected (like
>> when completions are just updated (with no completion-auto-select) and
>> the cursor is before the help line; I that case there is not "current
>> candidate"); a return in that moment won't execute anything because
>> there is nothing to select, so "current completion candidate" means
>> that... Maybe you have a better way to explain it?
>
>Wouldn't it make sense to move point to the first candidate, so that
>some candidate is always highlighted?
>
>Btw, when a candidate is highlighted, it is always the first one in
>the list, which kinda makes me wonder why this highlighting is useful,
>if it always shows the candidate in a fixed location on display?
>
>> Please if you have the time change it... Otherwise I will do in some
>> days.
>
>Will do.
>