branch: externals/corfu
commit 677933a8cd259a166d8a24d84876bbcdb18923b5
Author: Daniel Mendler <m...@daniel-mendler.de>
Commit: Daniel Mendler <m...@daniel-mendler.de>
README: Recommend pcomplete-from-help instead of pcmpl-args
---
README.org | 15 +++++----------
1 file changed, 5 insertions(+), 10 deletions(-)
diff --git a/README.org b/README.org
index 7dd6feb234..3970fb6e36 100644
--- a/README.org
+++ b/README.org
@@ -292,11 +292,11 @@ define the advice ~corfu-send-shell~ which sends the
candidate after insertion.
Shell completion uses the flexible ~Pcomplete~ mechanism internally, which
allows
you to program the completions per shell command. If you want to know more,
look
-into this
[[https://www.masteringemacs.org/article/pcomplete-context-sensitive-completion-emacs][blog
post]], which shows how to configure Pcomplete for git commands. I
-recommend the [[https://github.com/JonWaltman/pcmpl-args.el][pcmpl-args]]
package which extends Pcomplete with completion support
-and helpful annotation support for more commands. Similar to the Fish shell,
-pcmpl-args uses man page parsing and --help output parsing to dynamically
-generate completions. This package brings Eshell completion to another level!
+into this
[[https://www.masteringemacs.org/article/pcomplete-context-sensitive-completion-emacs][blog
post]], which shows how to configure Pcomplete for git commands.
+Since Emacs 29 Pcomplete offers the =pcomplete-from-help= function which parses
+the --help output of a command and produces completions. This functionality is
+similar to the Fish shell, which also uses --help output parsing to dynamically
+generate completions.
Unfortunately Pcomplete has a few technical issues, which we can work around
with the [[https://github.com/minad/cape][Cape]] library (Completion at point
extensions). Cape provides wrappers,
@@ -493,11 +493,6 @@ enhance your setup.
the [[https://github.com/jdtsmith/kind-icon][kind-icon]] package provides
beautifully styled SVG icons based on
monochromatic icon sets like material design.
-- [[https://github.com/JonWaltman/pcmpl-args.el][pcmpl-args]]: Extend the
Eshell/Shell Pcomplete mechanism with support for many
- more commands. Similar to the Fish shell, Pcomplete uses man page parsing to
- dynamically retrieve the completions and helpful annotations. This package
- brings Eshell completions to another level!
-
- [[https://github.com/minad/tempel][Tempel]]: Tiny template/snippet package
with templates in Lisp syntax, which
can be used in conjunction with Corfu.
