From ca6c1b545cdef9f703c9495d36c2d6ad5d70c47b Mon Sep 17 00:00:00 2001
From: Adam Kruszewski <adam@kruszewski.name>
Date: Mon, 8 May 2023 16:40:56 +0200
Subject: [PATCH] Added readme and bumped version to 1.0

---
 corfu-candidate-overlay.el                    |   2 +-
 .../corfu-candidate-overlay-many.png          | Bin 0 -> 3485 bytes
 readme-images/corfu-candidate-overlay-one.png | Bin 0 -> 5290 bytes
 readme.org                                    |  79 ++++++++++++++++++
 4 files changed, 80 insertions(+), 1 deletion(-)
 create mode 100755 readme-images/corfu-candidate-overlay-many.png
 create mode 100755 readme-images/corfu-candidate-overlay-one.png
 create mode 100644 readme.org

diff --git a/corfu-candidate-overlay.el b/corfu-candidate-overlay.el
index d0d05b7..3516d78 100644
--- a/corfu-candidate-overlay.el
+++ b/corfu-candidate-overlay.el
@@ -5,7 +5,7 @@
 ;; Author: Adam Kruszewski <adam@kruszewski.name>
 ;; Maintainer: Adam Kruszewski <adam@kruszewski.name>
 ;; Created: 2023
-;; Version: 0.1
+;; Version: 1.0
 ;; Package-Requires: ((emacs "27.1") (corfu "0.36"))
 ;; Homepage: https://code.bsdgeek.org/adam/corfu-candidate-overlay/
 
diff --git a/readme-images/corfu-candidate-overlay-many.png b/readme-images/corfu-candidate-overlay-many.png
new file mode 100755
index 0000000000000000000000000000000000000000..d6b7040630b902535b114fc9306c0b9470eaebd3
GIT binary patch
literal 3485
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
LNkvXXu0mjf?V`8T

literal 0
HcmV?d00001

diff --git a/readme-images/corfu-candidate-overlay-one.png b/readme-images/corfu-candidate-overlay-one.png
new file mode 100755
index 0000000000000000000000000000000000000000..93d8d24cc4023c08b471ca29ab71d192a9f8c244
GIT binary patch
literal 5290
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

literal 0
HcmV?d00001

diff --git a/readme.org b/readme.org
new file mode 100644
index 0000000..c10b7a2
--- /dev/null
+++ b/readme.org
@@ -0,0 +1,79 @@
+#+TITLE: Corfu candidate overlay
+
+* Corfu candidate overlay package
+Simple [[https://github.com/minad/corfu][corfu]] as-you-type auto-suggestion candidate overlay with a visual indication of whether there are *many* or *exactly one* candidate available.
+** Picture is worth a thousand words
+Overlay during typing showing first auto-completion candidate when there are more than one (horizontal bar is the cursor):
+
+[[./readme-images/corfu-candidate-overlay-many.png]]
+
+Overlay showing auto-completion candidate when there is only one available (so invoking =completion-at-point= will complete without showing the completion menu):
+
+[[./readme-images/corfu-candidate-overlay-one.png]]
+
+It show the first auto-suggestion from [[https://github.com/minad/corfu][corfu]] and when there is only one it will show it underlined (face attributes can be configured). In case of many suggestions available, invoking =completion-at-point= will open the corfu popup menu to choose from, in case of single completion available (i.e. underlined) it will get auto-completed seeing the menu when invoked =completion-at-point=.
+** Motivation
+Similarly to Michell Hashimoto[fn:1] of HashiCorp fame, I like my editor to do less than more. I'm not as ascetic though ;-) From time to time I do use the auto-suggestion menu of [[https://github.com/minad/corfu][corfu]], especially when I forget the exact wording of a function. I do however trigger the auto-suggestion popup manually.
+
+My need was to see some kind of indication, that there are suggestion ready for what I type and also to discern there is exactly one, usually long, name that I could auto-complete quickly (i.e. without seeing the distracting popup menu). That's how this rather simple[fn:2] package was born.
+** Prior art
+As far as I'm aware [[http://company-mode.github.io/][company-mode]] provides similar, if not exactly the same, functionality out-of-the-box (company-mode is an alternative to corfu that preceded it).
+** Performance considerations
+When using slow or cpu-heavy corfu backends (e.g. [[https://github.com/minad/cape][cape's]] dict backend with a larger dictionary file[fn:3]) you may experience lagging when writing fast contrary to normal experience with standard corfu with auto-suggestions popup enabled. This is caused by querying completion candidates for each character insert or deletion contrary to a timer-based approach of corfu. Querying of the backends is done in an interruptible manner (this part is based on corfu's internals) but heavy operations while searching for suggestion candidates can cause micro-stutters still.
+* Installation instructions
+** Requirements
+[[https://github.com/minad/corfu][Corfu]] is required with the =corfu-auto= set to =nil= (i.e. auto popup of auto-suggestions disabled). It is recommended to bing =completion-at-point= to combination of keys that are easily reachable to you. I use =super + tab= (i.e. „windows key” and tab) but I do use a custom ergonomic keyboard, where those keys are not too far from the home row. You may want to bind it to =ctrl + tab=, for example:
+
+#+begin_src emacs-lisp
+  (global-set-key (kbd "C-<tab>") 'completion-at-point)
+#+end_src
+** Using straight.el
+#+begin_src emacs-lisp
+  (use-package corfu-candidate-overlay
+    :straight (:type git
+               :repo "https://code.bsdgeek.org/adam/corfu-candidate-overlay"
+               :files (:defaults "*.el"))
+    :after corfu
+    :config
+    ;; enable corfu-candidate-overlay mode globally
+    ;; this relies on having corfu-auto set to nil
+    (corfu-candidate-overlay-mode +1)
+    ;; bind Ctr + TAB to trigger the completion popup of corfu
+    (global-set-key (kbd "C-<tab>") 'completion-at-point))
+#+end_src
+** Customization
+Faces available for customization:
+
+- =corfu-candidate-overlay-face=
+
+  Defines the overlay text colour when there are more than one auto-suggestions available.
+  Defaults to „@@html:<span style="color:#8b7d7b; background:#ffffff;font-weight: bold;">@@MistyRose4@@html:</span>@@” for light themes and „@@html:<span style="color:#f5deb3; background:#000000;font-weight: bold;">@@wheat@@html:</span>@@” for dark themes.
+
+- =corfu-candidate-overlay-face-exact-match=
+
+  Defines the overlay's text colour when there is only one auto-suggestion present. By default inherits the =corfu-candidate-overlay-face= but adds =:underline t=.
+
+Custom variables available:
+
+- =corfu-overlay-auto-commands=
+
+  Additional commands apart from corfu's built-in =corfu-auto-commands= which initiate completion candidate overlay.
+  Default value: ~("delete-backward-char\\'" "backward-delete-char-untabify")~
+
+  Which tracks also character deletions and allows to see the overlay when you delete previously typed characters (i.e. when you made a typo and just need to track back, but still would like to see the completions overlay).
+* How to contribute
+
+The latest source code is available at https://code.bsdgeek.org/adam/corfu-candidate-overlay
+
+Issue reports, questions, comments and code patches are welcome -- you can send them to me over e-mail at adam /at/ kruszewski /dot/ name (please be patient as I'm not checking this account on a daily basis).
+
+If you haven't sent code patches via e-mail yet and would like to learn how to work with an e-mail based workflow, you can read more at [[https://git-scm.com/docs/git-format-patch][git format-patch]] man page or at [[https://git-send-email.io/][git-send-email.io]].
+
+* Footnotes
+
+[fn:1] See video cast:
+  [[https://www.youtube.com/watch?v=rysgxl35EGc][Worst Practices in Software Development: Mitchell Hashimoto uses a simple code editor]].
+
+[fn:2] As of version 1.0 there are ~200 lines of code with additional ~100 lines of comments.
+
+[fn:3] Cape's dict backend calls „grep” executable on the dictionary file when looking for completion candidates (it does cache the results, but still that's far from being free).