summaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
authorDaniel Mendler <mail@daniel-mendler.de>2022-01-27 00:42:56 +0100
committerDaniel Mendler <mail@daniel-mendler.de>2022-01-27 00:42:56 +0100
commit3c790cc316dd17b58328cb18290c61980cdcedde (patch)
tree5a87d7311d03c6c27edae668f5f1cf69ae8e7727 /README.org
parenta921f7669e6f154fc8c0ecde9b94de0bf17cfbd0 (diff)
README: Recommend the pcmpl-args package!
Diffstat (limited to 'README.org')
-rw-r--r--README.org14
1 files changed, 12 insertions, 2 deletions
diff --git a/README.org b/README.org
index 51c3ee5..5e284df 100644
--- a/README.org
+++ b/README.org
@@ -184,8 +184,13 @@ completion, quitting at boundary and quitting if there is no match.
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.
-Unfortunately pcomplete has a few technical issues, which we can work around
+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
+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!
+
+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,
which sanitize the pcomplete function. Ideally the bugs in pcomplete should be
fixed upstream. *For now these two advices are strongly recommended to achieve a
@@ -270,6 +275,11 @@ moves to the next candidate and further input will then commit the selection.
=company-quickhelp=. /Note that the corfu-doc package is new and still work in
progress./
+ - [[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 completion candidates. This package brings Eshell
+ completions to another level!
+
- [[https://github.com/minad/tempel][Tempel]]: Tiny template/snippet package which can be used in conjunction with Corfu.
- [[https://github.com/minad/vertico][Vertico]]: You may also want to look into my [[https://github.com/minad/vertico][Vertico]] package. Vertico is the