Re: Completion of links to man pages

2023-12-09 Thread Ihor Radchenko
n.el and woman.el from Emacs. > > (defun org-man-complete (&optional _arg) > "Helper for completion of links to man pages." >(concat > "man:" > (let ((completion-ignore-case t)) ; See `man' comments. > (funcall >

Re: Completion of links to man pages

2023-10-07 Thread Michael Albinus
Eli Zaretskii writes: Hi, >> > I don't think woman.el is being developed, or is it? >> >> Do you mean that woman.el will be obsoleted? > > AFAIU, it already is, de-facto. Unless someone steps forward and > volunteers to develop woman.el so as to add all the many missing > features that Groff ha

Re: Completion of links to man pages

2023-10-06 Thread Richard Stallman
[[[ To any NSA and FBI agents reading my email: please consider]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > It seems, I was not the only person who had an impression that `woman' > is th

Re: Completion of links to man pages

2023-10-05 Thread Max Nikulin
On 05/10/2023 23:15, Ihor Radchenko wrote: Max Nikulin writes: World has changed since woman.el was developed. Are there systems with man pages available, but no man command nowadays? Android with man pages copied by its user? MS-DOS, for example. Or old Windows versions. Emacs can work on man

Re: Completion of links to man pages

2023-10-05 Thread Max Nikulin
On 06/10/2023 00:11, Eli Zaretskii wrote: From where I stand, we have already a stable API tested by years of use. What is maybe missing is some documentation to allow its easier use, that's all. In some cases it is no API but just an interactive command. Sometimes it can be used from other

Re: Completion of links to man pages

2023-10-05 Thread Ihor Radchenko
Eli Zaretskii writes: >> Yes, but one cannot replicate the same completion dialogue >> programmatically in future-compatible way. > > What do you mean by that? "M-x man" does this: > > (interactive >(list (let* ((default-entry (Man-default-man-entry)) > ;; ignore case because

Re: Completion of links to man pages

2023-10-05 Thread Ihor Radchenko
Eli Zaretskii writes: >> Do you mean that woman.el will be obsoleted? > > AFAIU, it already is, de-facto. Unless someone steps forward and > volunteers to develop woman.el so as to add all the many missing > features that Groff has added during the last years, woman.el will > continue to bitrot.

Re: Completion of links to man pages

2023-10-05 Thread Eli Zaretskii
> From: Ihor Radchenko > Cc: maniku...@gmail.com, emacs-orgmode@gnu.org, emacs-de...@gnu.org > Date: Thu, 05 Oct 2023 16:53:57 + > > Eli Zaretskii writes: > > >> > How is it different from the "M-x man" completion we already have? > >> > >> M-x man will display the man page, while we just

Re: Completion of links to man pages

2023-10-05 Thread Ihor Radchenko
Eli Zaretskii writes: >> > How is it different from the "M-x man" completion we already have? >> >> M-x man will display the man page, while we just need `completing-read' >> from the same source M-x man or M-x woman use. > > Sorry, I don't understand: "M-x man" does provide completion. Yes, bu

Re: Completion of links to man pages

2023-10-05 Thread Eli Zaretskii
> From: Ihor Radchenko > Cc: maniku...@gmail.com, emacs-orgmode@gnu.org, emacs-de...@gnu.org > Date: Thu, 05 Oct 2023 16:05:02 + > > Eli Zaretskii writes: > > >> To emacs-devel: Would it be of interest to expose man/woman completion > >> API? > > > > How is it different from the "M-x man" c

Re: Completion of links to man pages

2023-10-05 Thread Ihor Radchenko
Max Nikulin writes: > On 05/10/2023 19:48, Ihor Radchenko wrote: >> Max Nikulin writes: >> >>> Frankly speaking, I am unsure if woman should be supported in Org at >>> all. My early experience with woman.el was not nice. I tried M-x woman >>> RET ssh RET (openssh). >> >> woman is not trying to

Re: Completion of links to man pages

2023-10-05 Thread Ihor Radchenko
Eli Zaretskii writes: >> To emacs-devel: Would it be of interest to expose man/woman completion >> API? > > How is it different from the "M-x man" completion we already have? M-x man will display the man page, while we just need `completing-read' from the same source M-x man or M-x woman use. T

Re: Completion of links to man pages

2023-10-05 Thread Max Nikulin
On 05/10/2023 19:48, Ihor Radchenko wrote: Max Nikulin writes: Frankly speaking, I am unsure if woman should be supported in Org at all. My early experience with woman.el was not nice. I tried M-x woman RET ssh RET (openssh). woman is not trying to be complete. See [[info:woman#Introduction]]

Re: Completion of links to man pages

2023-10-05 Thread Eli Zaretskii
> From: Ihor Radchenko > Cc: emacs-orgmode@gnu.org, emacs-de...@gnu.org > Date: Thu, 05 Oct 2023 11:40:44 + > > To emacs-devel: Would it be of interest to expose man/woman completion > API? How is it different from the "M-x man" completion we already have?

Re: Completion of links to man pages

2023-10-05 Thread Ihor Radchenko
Max Nikulin writes: >> To emacs-devel: Would it be of interest to expose man/woman completion >> API? > > Since Org mode supports a couple of previous Emacs versions, I would > avoid cross-posting. I just sent a draft to evaluate if code can be > added to Org. Previous Emacs versions are not a

Re: Completion of links to man pages

2023-10-05 Thread Max Nikulin
On 05/10/2023 18:40, Ihor Radchenko wrote: [ CCing emacs-devel ] To emacs-devel: Would it be of interest to expose man/woman completion API? Since Org mode supports a couple of previous Emacs versions, I would avoid cross-posting. I just sent a draft to evaluate if code can be added to Org.

Re: Completion of links to man pages

2023-10-05 Thread Ihor Radchenko
igh level functions in man.el and woman.el from Emacs. Without docstrings, we cannot rely even on single-dash functions. To emacs-devel: Would it be of interest to expose man/woman completion API? > (defun org-man-complete (&optional _arg) > "Helper for completion of links t

Completion of links to man pages

2023-10-04 Thread Max Nikulin
un org-man-complete (&optional _arg) "Helper for completion of links to man pages." (concat "man:" (let ((completion-ignore-case t)) ; See `man' comments. (funcall (if (eq org-man-command 'woman) #'org-man--complete-woman