Revert "README: Recommend pcomplete-from-help instead of pcmpl-args"

This reverts commit 677933a8cd259a166d8a24d84876bbcdb18923b5.

1 files changed, 15 insertions, 5 deletions

diff --git a/README.org b/README.org
index eefdef2..42680dd 100644
--- a/README.org
+++ b/README.org
@@ -296,11 +296,16 @@ 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 the [[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 takes advantage of ~--help~ to dynamically
-generate completions.
+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!
+(Since Emacs 29, Pcomplete offers the =pcomplete-from-help= function which parses
+the ~--help~ output of a command and produces completions. This Emacs 29
+functionality is still unfinished and for example doesn't work properly in
+Eshell.)
 
 Unfortunately Pcomplete had a few technical issues on Emacs 28 and older. We can
 work around the issues with the [[https://github.com/minad/cape][Cape]] library (Completion at point extensions).
@@ -503,6 +508,11 @@ enhance your setup.
   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.