GNU bug report logs - #76941
[PATCH] completion-preview.el: Provide an API.

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Eshel Yaron <me <at> eshelyaron.com>
Cc: 76941 <at> debbugs.gnu.org
Subject: bug#76941: [PATCH] completion-preview.el: Provide an API.
Date: Wed, 12 Mar 2025 17:25:48 +0200

> From: Eshel Yaron <me <at> eshelyaron.com>
> Cc: 76941 <at> debbugs.gnu.org
> Date: Wed, 12 Mar 2025 14:55:20 +0100
> 
> Eli Zaretskii <eliz <at> gnu.org> writes:
> 
> >> +  Emacs can also @emph{suggest} possible in-buffer completions by means
> >> +of a @dfn{completion preview}.  The preview appears after a given
> >> +stretch of buffer text, usually ending at point, and suggest a possible
> >> +completion of that text.  Users can interact with the preview to accept
> >> +the completion suggestion or cycle among multiple suggestions.  Use the
> >> +following functions to create or dismiss a completion preview:
> >
> > The ELisp manual is written for Lisp programmers, not for Emacs
> > users.  So please use "Lisp programs" instead of "users"
> 
> We are telling Lisp programmers what their users can do with the
> completion preview, so this is about users, not other programs.  
> Does that makes sense?

Yes,  But then I'd say something like "Users can then interact with
this preview to ..."

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.