Recommend M-x man in woman.el docs

* lisp/woman.el (Commentary, woman): Recommend using 'M-x man' where
available.  The added sentence is copied from the emacs manual.
Ref: https://lists.gnu.org/r/emacs-devel/2023-10/msg00090.html
This commit is contained in:
Stefan Kangas 2023-10-07 18:29:07 +02:00
parent 809da7fc9a
commit 0590e3e69a

View file

@ -34,6 +34,10 @@
;; the emulation is modified to include the reformatting done by the
;; Emacs `man' command. No hyphenation is performed.
;; Note that `M-x woman' doesnt yet support the latest features of
;; modern man pages, so we recommend using `M-x man' if that is
;; available on your system.
;; Advantages
;; Much more direct, does not require any external programs.
@ -1149,7 +1153,11 @@ speed. With a prefix argument, force the caches to be
updated (e.g. to re-interpret the current directory).
Used non-interactively, arguments are optional: if given then TOPIC
should be a topic string and non-nil RE-CACHE forces re-caching."
should be a topic string and non-nil RE-CACHE forces re-caching.
Note that `M-x woman' doesnt yet support the latest features of
modern man pages, so we recommend using `M-x man' if that is
available on your system."
(interactive (list nil current-prefix-arg))
;; The following test is for non-interactive calls via emacsclient, etc.
(if (or (not (stringp topic)) (string-match-p "\\S " topic))