* Manual does not mention dictionary.el
@ 2024-10-11 20:13 Petteri Hintsanen
2024-10-11 21:35 ` Divya
2024-10-12 7:21 ` Eli Zaretskii
0 siblings, 2 replies; 25+ messages in thread
From: Petteri Hintsanen @ 2024-10-11 20:13 UTC (permalink / raw)
To: emacs-devel
I was wondering if Emacs could do dictionary look-ups.
After failed search through the manual (for "dictionary") I resorted to
a web search. It quickly showed that Emacs has included dictionary.el
since version 28 or so.
Why this extremely useful feature is not mentioned in the manual at all?
Or did I just miss it somehow?
--
Petteri
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-11 20:13 Manual does not mention dictionary.el Petteri Hintsanen
@ 2024-10-11 21:35 ` Divya
2024-10-11 22:39 ` Juergen Fenn
2024-10-12 7:21 ` Eli Zaretskii
1 sibling, 1 reply; 25+ messages in thread
From: Divya @ 2024-10-11 21:35 UTC (permalink / raw)
To: emacs-devel
[-- Attachment #1: Type: text/plain, Size: 815 bytes --]
On 11 October 2024 20:13:44 GMT, Petteri Hintsanen <petterih@iki.fi> wrote:
>I was wondering if Emacs could do dictionary look-ups.
>
>After failed search through the manual (for "dictionary") I resorted to
>a web search. It quickly showed that Emacs has included dictionary.el
>since version 28 or so.
>
>Why this extremely useful feature is not mentioned in the manual at all?
>Or did I just miss it somehow?
>
>--
>Petteri
>
Hello Petteri,
Now that I realize I've been using dictionary in Emacs for years and thinking that I learnt about it from the manual when I actually got it from one of the blogposts I think.
I agree. It is crucial to include documentation about dictionary, I'd be willing to be of help if needed.
Regards,
Divya Ranjan
Mathematics, Philosophy, Libre Software
[-- Attachment #2: Type: text/html, Size: 1147 bytes --]
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-11 21:35 ` Divya
@ 2024-10-11 22:39 ` Juergen Fenn
0 siblings, 0 replies; 25+ messages in thread
From: Juergen Fenn @ 2024-10-11 22:39 UTC (permalink / raw)
To: Divya, emacs-devel, petterih
Am 11.10.24 um 23:35 Uhr schrieb Divya:
> Now that I realize I've been using dictionary in Emacs for years and
> thinking that I learnt about it from the manual when I actually got it
> from one of the blogposts I think.
>
> I agree. It is crucial to include documentation about dictionary, I'd be
> willing to be of help if needed.
All I've learned about dictionary.el came from Mickey Peterson's blog
(please note that the certificate for his website expired two days ago).
We could invite him to write the section for the manual! But I'd also be
happy to help out.
BTW, there also is an extension I've found rather helpful on macOS, viz.
https://github.com/xuchunyang/osx-dictionary.el
which enables the built-in dictionaries and thesauri in macOS (from
Oxford, Webster, Larousse, Duden, etc.).
Best regards,
Jürgen.
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-11 20:13 Manual does not mention dictionary.el Petteri Hintsanen
2024-10-11 21:35 ` Divya
@ 2024-10-12 7:21 ` Eli Zaretskii
2024-10-12 9:39 ` Petteri Hintsanen
2024-12-06 19:19 ` Jean Louis
1 sibling, 2 replies; 25+ messages in thread
From: Eli Zaretskii @ 2024-10-12 7:21 UTC (permalink / raw)
To: Petteri Hintsanen; +Cc: emacs-devel
> From: Petteri Hintsanen <petterih@iki.fi>
> Date: Fri, 11 Oct 2024 23:13:44 +0300
>
> I was wondering if Emacs could do dictionary look-ups.
>
> After failed search through the manual (for "dictionary") I resorted to
> a web search. It quickly showed that Emacs has included dictionary.el
> since version 28 or so.
>
> Why this extremely useful feature is not mentioned in the manual at all?
> Or did I just miss it somehow?
We don't describe in the manual every feature we add to Emacs; we
describe that in NEWS instead. The Emacs manual is already very
large, so we add new features to it only of they are very important.
I've now added to the manual a short description of the dictionary
search facility.
Thanks.
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-12 7:21 ` Eli Zaretskii
@ 2024-10-12 9:39 ` Petteri Hintsanen
2024-10-12 18:23 ` chad
2024-12-06 19:19 ` Jean Louis
1 sibling, 1 reply; 25+ messages in thread
From: Petteri Hintsanen @ 2024-10-12 9:39 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
> We don't describe in the manual every feature we add to Emacs; we
> describe that in NEWS instead. The Emacs manual is already very
> large, so we add new features to it only of they are very important.
Fair enough. I'll try to remember check NEWS next time.
> I've now added to the manual a short description of the dictionary
> search facility.
Thanks.
--
Petteri
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-12 9:39 ` Petteri Hintsanen
@ 2024-10-12 18:23 ` chad
2024-10-12 18:32 ` Eli Zaretskii
2024-11-23 13:13 ` Petteri Hintsanen
0 siblings, 2 replies; 25+ messages in thread
From: chad @ 2024-10-12 18:23 UTC (permalink / raw)
To: Petteri Hintsanen; +Cc: Eli Zaretskii, emacs-devel
[-- Attachment #1: Type: text/plain, Size: 666 bytes --]
On Sat, Oct 12, 2024 at 5:40 AM Petteri Hintsanen <petterih@iki.fi> wrote:
> Fair enough. I'll try to remember check NEWS next time.
>
FWIW, when I saw your initial post I immediately checked "C-h P dict"
and found it. This UI could probably use some help, and it has been
discussed in the past, but discovery is a non-trivial problem for
roughly everyone (examples: elpa/melpa, Doom, VS Code, both Apple and
Google's app stores, roughly every version of Windows since NT,
etc.). I didn't post this earlier because your OP seemed reasonably
clearly directed at the manual, but I do find it helpful in similar
situations.
Hope that helps,
~Chad
[-- Attachment #2: Type: text/html, Size: 1064 bytes --]
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-12 18:23 ` chad
@ 2024-10-12 18:32 ` Eli Zaretskii
2024-10-12 21:59 ` Joost Kremers
2024-11-23 13:13 ` Petteri Hintsanen
1 sibling, 1 reply; 25+ messages in thread
From: Eli Zaretskii @ 2024-10-12 18:32 UTC (permalink / raw)
To: chad; +Cc: petterih, emacs-devel
> From: chad <yandros@gmail.com>
> Date: Sat, 12 Oct 2024 14:23:01 -0400
> Cc: Eli Zaretskii <eliz@gnu.org>, emacs-devel@gnu.org
>
> On Sat, Oct 12, 2024 at 5:40 AM Petteri Hintsanen <petterih@iki.fi> wrote:
>
> Fair enough. I'll try to remember check NEWS next time.
>
> FWIW, when I saw your initial post I immediately checked "C-h P dict"
> and found it. This UI could probably use some help, and it has been
> discussed in the past, but discovery is a non-trivial problem for
> roughly everyone (examples: elpa/melpa, Doom, VS Code, both Apple and
> Google's app stores, roughly every version of Windows since NT,
> etc.). I didn't post this earlier because your OP seemed reasonably
> clearly directed at the manual, but I do find it helpful in similar
> situations.
Discovery is a hard problem in a package as large as Emacs. I very
much doubt that adding a passage to the user manual makes discovery
easier. In fact, I think NEWS is much more visible than addition of a
paragraph somewhere in the manual.
As for "C-h P": I don't know what you found there, since dictionary.el
is part of Emacs, so package.el doesn't know about it. "C-h P dict"
finds dict-tree for me, which is something different. I guess you
have "C-h P" bound to some other command than in "emacs -Q".
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-12 18:32 ` Eli Zaretskii
@ 2024-10-12 21:59 ` Joost Kremers
2024-10-13 5:12 ` Eli Zaretskii
0 siblings, 1 reply; 25+ messages in thread
From: Joost Kremers @ 2024-10-12 21:59 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: chad, petterih, emacs-devel
On Sat, Oct 12 2024, Eli Zaretskii wrote:
> As for "C-h P": I don't know what you found there, since dictionary.el
> is part of Emacs, so package.el doesn't know about it. "C-h P dict"
> finds dict-tree for me, which is something different. I guess you
> have "C-h P" bound to some other command than in "emacs -Q".
When I do `C-h P` and type "dict" followed BY TAB, I get:
==============================
Click on a completion to select it.
In this buffer, type RET to select the completion near point.
3 possible completions:
dict-tree
dictionary
dictionary-connection
==============================
That's with `emacs -Q`, v. 29.4. 🙂
--
Joost Kremers
Life has its moments
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-12 21:59 ` Joost Kremers
@ 2024-10-13 5:12 ` Eli Zaretskii
2024-10-14 1:39 ` chad
0 siblings, 1 reply; 25+ messages in thread
From: Eli Zaretskii @ 2024-10-13 5:12 UTC (permalink / raw)
To: Joost Kremers; +Cc: yandros, petterih, emacs-devel
> From: Joost Kremers <joostkremers@fastmail.fm>
> Cc: chad <yandros@gmail.com>, petterih@iki.fi, emacs-devel@gnu.org
> Date: Sat, 12 Oct 2024 23:59:11 +0200
>
> On Sat, Oct 12 2024, Eli Zaretskii wrote:
> > As for "C-h P": I don't know what you found there, since dictionary.el
> > is part of Emacs, so package.el doesn't know about it. "C-h P dict"
> > finds dict-tree for me, which is something different. I guess you
> > have "C-h P" bound to some other command than in "emacs -Q".
>
> When I do `C-h P` and type "dict" followed BY TAB, I get:
>
> ==============================
> Click on a completion to select it.
> In this buffer, type RET to select the completion near point.
>
> 3 possible completions:
> dict-tree
> dictionary
> dictionary-connection
> ==============================
Look under your ~/.emacs.d/elpa/ to find out why. Or point HOME to
some other directory and try again. Chrystal ball says you have this
cached from some MELPA access, because currently dictionary is neither
on GNU ELPA nor on NonGNU ELPA.
In a really pristine installation with an empty ~/.emacs.d/, if you
type "C-h P dict TAB", you should get "No match", I think. I got
dict-tree because that's the only one on GNU ELPA, and I have some
cache from the last time I did "M-x list-packages".
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-13 5:12 ` Eli Zaretskii
@ 2024-10-14 1:39 ` chad
2024-10-14 7:11 ` Joost Kremers
2024-10-14 13:50 ` Eli Zaretskii
0 siblings, 2 replies; 25+ messages in thread
From: chad @ 2024-10-14 1:39 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: Joost Kremers, petterih, emacs-devel
[-- Attachment #1.1: Type: text/plain, Size: 1419 bytes --]
On Sun, Oct 13, 2024 at 1:12 AM Eli Zaretskii <eliz@gnu.org> wrote:
> In a really pristine installation with an empty ~/.emacs.d/, if you
> type "C-h P dict TAB", you should get "No match", I think.
I did it in a clean installation, using emacs -Q with no .emacs{,.d}
present. It completes to "dictionary", and stops because it also
knows about "dictionary-connection". Afterwards, the only thing in
.emacs.d is the eln-cache directory created by emacs -Q.
If I repeat this with C-h P di TAB, I get:
[image: image.png]
FWIW, going back to "what it does", from that same emacs -Q,
I see:
>Package dictionary is built-in.
>
> Status: Built-In.
> Summary: Client for rfc2229 dictionary servers
>
>dictionary allows you to interact with dictionary servers.
>
>Use `M-x customize-group RET dictionary RET' to modify user settings.
>
>Main commands for interaction are:
>`M-x dictionary' - open a new dictionary buffer
>`M-x dictionary-search' - search for the definition of a word
>
>You can find more information in the README file of the GitHub
>repository https://github.com/myrkr/dictionary-el
>
>[back]
..which is the (expected) Commentary section of lisp/net/dictionary.el
This is from a recent HEAD build, but I get the same with a prebuilt
binary of 30.0.90 under win11 (although it's harder for me to be sure
that I passed '-Q' correctly).
~Chad
[-- Attachment #1.2: Type: text/html, Size: 2232 bytes --]
[-- Attachment #2: image.png --]
[-- Type: image/png, Size: 29472 bytes --]
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-14 1:39 ` chad
@ 2024-10-14 7:11 ` Joost Kremers
2024-10-14 14:07 ` Eli Zaretskii
2024-10-14 13:50 ` Eli Zaretskii
1 sibling, 1 reply; 25+ messages in thread
From: Joost Kremers @ 2024-10-14 7:11 UTC (permalink / raw)
To: chad; +Cc: Eli Zaretskii, petterih, emacs-devel
On Sun, Oct 13 2024, chad wrote:
> On Sun, Oct 13, 2024 at 1:12 AM Eli Zaretskii <eliz@gnu.org> wrote:
>
>> In a really pristine installation with an empty ~/.emacs.d/, if you
>> type "C-h P dict TAB", you should get "No match", I think.
>
>
> I did it in a clean installation, using emacs -Q with no .emacs{,.d}
> present. It completes to "dictionary", and stops because it also
> knows about "dictionary-connection".
Yes, I did something similar: move my .emacs.d out of the way, start with
emacs -Q, type C-h P followed by "dict" and return. I get a window with two
options: dictionary and dictionary-connection.
I mean, it makes sense that package.el knows about built-in packages,
because they are included in the list when you do 'M-x list-packages'.
It's interesting to know, though, that there is still some interaction with
.emacs.d, even when you start Emacs with the -Q switch. I didn't know that.
--
Joost Kremers
Life has its moments
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-14 1:39 ` chad
2024-10-14 7:11 ` Joost Kremers
@ 2024-10-14 13:50 ` Eli Zaretskii
2024-10-14 18:23 ` chad
1 sibling, 1 reply; 25+ messages in thread
From: Eli Zaretskii @ 2024-10-14 13:50 UTC (permalink / raw)
To: chad; +Cc: joostkremers, petterih, emacs-devel
> From: chad <yandros@gmail.com>
> Date: Sun, 13 Oct 2024 21:39:31 -0400
> Cc: Joost Kremers <joostkremers@fastmail.fm>, petterih@iki.fi, emacs-devel@gnu.org
>
> ..which is the (expected) Commentary section of lisp/net/dictionary.el
>
> This is from a recent HEAD build, but I get the same with a prebuilt
> binary of 30.0.90 under win11 (although it's harder for me to be sure
> that I passed '-Q' correctly).
Not sure what happens here, but I get different results on GNU/Linux
and on Windows, so I will be looking into this. On Windows, without
~/.emacs.d/elpa/ I get [No match]. Sounds like a bug.
Also, list-packages doesn't show 'dictionary', neither on MS-Windows
nor on GNU/Linux, at least in "emacs -Q". If it does for you, I'm
guessing you have stuff under ~/.emacs.d/elpa/.
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-14 7:11 ` Joost Kremers
@ 2024-10-14 14:07 ` Eli Zaretskii
0 siblings, 0 replies; 25+ messages in thread
From: Eli Zaretskii @ 2024-10-14 14:07 UTC (permalink / raw)
To: Joost Kremers; +Cc: yandros, petterih, emacs-devel
> From: Joost Kremers <joostkremers@fastmail.fm>
> Cc: Eli Zaretskii <eliz@gnu.org>, petterih@iki.fi, emacs-devel@gnu.org
> Date: Mon, 14 Oct 2024 09:11:57 +0200
>
> I mean, it makes sense that package.el knows about built-in packages,
> because they are included in the list when you do 'M-x list-packages'.
Not here, they don't. And that's neither on GNU/Linux nor on
MS-Windows.
> It's interesting to know, though, that there is still some interaction with
> .emacs.d, even when you start Emacs with the -Q switch. I didn't know that.
The -Q switch doesn't block access to your home directory. Its
purpose is something else.
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-14 13:50 ` Eli Zaretskii
@ 2024-10-14 18:23 ` chad
2024-10-15 0:46 ` Michael Heerdegen via Emacs development discussions.
0 siblings, 1 reply; 25+ messages in thread
From: chad @ 2024-10-14 18:23 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: joostkremers, petterih, emacs-devel
[-- Attachment #1: Type: text/plain, Size: 1554 bytes --]
On Mon, Oct 14, 2024 at 9:50 AM Eli Zaretskii <eliz@gnu.org> wrote:
> > From: chad <yandros@gmail.com>
> > Date: Sun, 13 Oct 2024 21:39:31 -0400
> > Cc: Joost Kremers <joostkremers@fastmail.fm>, petterih@iki.fi,
> emacs-devel@gnu.org
> >
> > ..which is the (expected) Commentary section of lisp/net/dictionary.el
> >
> > This is from a recent HEAD build, but I get the same with a prebuilt
> > binary of 30.0.90 under win11 (although it's harder for me to be sure
> > that I passed '-Q' correctly).
>
> Also, list-packages doesn't show 'dictionary', neither on MS-Windows
> nor on GNU/Linux, at least in "emacs -Q". If it does for you, I'm
> guessing you have stuff under ~/.emacs.d/elpa/.
>
We are seeing different behavior.
I get completions for both dictionary and dictionary-connection with
literally no
.emacs, .emacs.d. I also get it with a newly created user with nothing
related
to emacs in $HOME or env. I also get the same result under win11, although
my confidence that the environment there is "poisoned" is much lower.
I just repeated this again with a blank user/environment and the invocation:
$ /opt/emacs/bin/emacs-31.0.50 -q --no-site-file --no-site-lisp
In the resulting emacs, there is no elpa directory of .emacs.d either before
or after 'C-h P dict TAB RET' brings up the *Help* buffer with the package
commentary from the built-in lisp/net/dictionary.el, and after that emacs is
closed, there is still only an eln-cache directory in it's just-created
.emacs.d.
Hope this helps,
~Chad
[-- Attachment #2: Type: text/html, Size: 2381 bytes --]
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-14 18:23 ` chad
@ 2024-10-15 0:46 ` Michael Heerdegen via Emacs development discussions.
2024-10-15 5:30 ` chad
2024-10-15 13:14 ` Eli Zaretskii
0 siblings, 2 replies; 25+ messages in thread
From: Michael Heerdegen via Emacs development discussions. @ 2024-10-15 0:46 UTC (permalink / raw)
To: emacs-devel
chad <yandros@gmail.com> writes:
> > Also, list-packages doesn't show 'dictionary', neither on MS-Windows
> > nor on GNU/Linux, at least in "emacs -Q". If it does for you, I'm
> > guessing you have stuff under ~/.emacs.d/elpa/.
>
> We are seeing different behavior.
I see that lisp/finder-inf.el defines 'dictionary' as a built-in package
in my Emacs installation. This file is loaded when doing C-h P. It
directly sets `package--builtins'.
Maybe that file's contents differ for you and Eli?
Michael.
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-15 0:46 ` Michael Heerdegen via Emacs development discussions.
@ 2024-10-15 5:30 ` chad
2024-10-15 12:20 ` Eli Zaretskii
2024-10-15 13:14 ` Eli Zaretskii
1 sibling, 1 reply; 25+ messages in thread
From: chad @ 2024-10-15 5:30 UTC (permalink / raw)
To: Michael Heerdegen; +Cc: emacs-devel
[-- Attachment #1: Type: text/plain, Size: 755 bytes --]
On Mon, Oct 14, 2024 at 8:46 PM Michael Heerdegen via Emacs development
discussions.
> > We are seeing different behavior.
>
> I see that lisp/finder-inf.el defines 'dictionary' as a built-in package
> in my Emacs installation. This file is loaded when doing C-h P. It
> directly sets `package--builtins'.
>
> Maybe that file's contents differ for you and Eli?
>
Yep, good spot!
On both my regular linux laptop (with frequently rebuilt head) and on
a borrowed win11 install of emacs 30, I see lines in finder-inf.el for
both dictionary and dictionary-connection. Tracing through the
function finder-compile-keywords in finder.el, I suspect that *maybe*
this is an artifact of Eli running directly out of the build tree?
~Chad
[-- Attachment #2: Type: text/html, Size: 1133 bytes --]
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-15 5:30 ` chad
@ 2024-10-15 12:20 ` Eli Zaretskii
0 siblings, 0 replies; 25+ messages in thread
From: Eli Zaretskii @ 2024-10-15 12:20 UTC (permalink / raw)
To: chad; +Cc: michael_heerdegen, emacs-devel
> From: chad <yandros@gmail.com>
> Date: Tue, 15 Oct 2024 01:30:19 -0400
> Cc: emacs-devel@gnu.org
>
> I see that lisp/finder-inf.el defines 'dictionary' as a built-in package
> in my Emacs installation. This file is loaded when doing C-h P. It
> directly sets `package--builtins'.
>
> Maybe that file's contents differ for you and Eli?
>
> Yep, good spot!
>
> On both my regular linux laptop (with frequently rebuilt head) and on
> a borrowed win11 install of emacs 30, I see lines in finder-inf.el for
> both dictionary and dictionary-connection. Tracing through the
> function finder-compile-keywords in finder.el, I suspect that *maybe*
> this is an artifact of Eli running directly out of the build tree?
No, I almost never build out of the tree.
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-15 0:46 ` Michael Heerdegen via Emacs development discussions.
2024-10-15 5:30 ` chad
@ 2024-10-15 13:14 ` Eli Zaretskii
1 sibling, 0 replies; 25+ messages in thread
From: Eli Zaretskii @ 2024-10-15 13:14 UTC (permalink / raw)
To: Michael Heerdegen; +Cc: emacs-devel
> Date: Tue, 15 Oct 2024 02:46:28 +0200
> From: Michael Heerdegen via "Emacs development discussions." <emacs-devel@gnu.org>
>
> chad <yandros@gmail.com> writes:
>
> > > Also, list-packages doesn't show 'dictionary', neither on MS-Windows
> > > nor on GNU/Linux, at least in "emacs -Q". If it does for you, I'm
> > > guessing you have stuff under ~/.emacs.d/elpa/.
> >
> > We are seeing different behavior.
>
> I see that lisp/finder-inf.el defines 'dictionary' as a built-in package
> in my Emacs installation. This file is loaded when doing C-h P. It
> directly sets `package--builtins'.
>
> Maybe that file's contents differ for you and Eli?
Indeed, my finder-inf.el was very old. It doesn't get rebuilt unless
you explicitly request that or bootstrap (and I _never_ bootstrap).
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-12 18:23 ` chad
2024-10-12 18:32 ` Eli Zaretskii
@ 2024-11-23 13:13 ` Petteri Hintsanen
2024-11-23 13:51 ` Eli Zaretskii
1 sibling, 1 reply; 25+ messages in thread
From: Petteri Hintsanen @ 2024-11-23 13:13 UTC (permalink / raw)
To: chad; +Cc: Eli Zaretskii, emacs-devel
On 12.10.2024 21.23, chad wrote:
> On Sat, Oct 12, 2024 at 5:40 AM Petteri Hintsanen <petterih@iki.fi
> <mailto:petterih@iki.fi>> wrote:
>
> Fair enough. I'll try to remember check NEWS next time.
>
>
> FWIW, when I saw your initial post I immediately checked "C-h P dict"
> and found it.
C-h P is news for me, thanks.
> but discovery is a non-trivial problem for roughly everyone
It is, like data management in general.
For me, manuals (texinfo, man pages) are "the" definitive source for
information about the installed features. Occasionally I use C-h a too,
as it often catches things that are not mentioned in manuals.
In this case M-x apropos RET dict RET gives meaningful results, so maybe
I forgot to try it or did something equivalently stupid.
Anyway, I'll keep NEWS and C-h P in my mind.
Thanks.
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-11-23 13:13 ` Petteri Hintsanen
@ 2024-11-23 13:51 ` Eli Zaretskii
2024-12-06 19:14 ` Jean Louis
0 siblings, 1 reply; 25+ messages in thread
From: Eli Zaretskii @ 2024-11-23 13:51 UTC (permalink / raw)
To: Petteri Hintsanen; +Cc: yandros, emacs-devel
> Date: Sat, 23 Nov 2024 15:13:43 +0200
> Cc: Eli Zaretskii <eliz@gnu.org>, emacs-devel@gnu.org
> From: Petteri Hintsanen <petterih@iki.fi>
>
> C-h P is news for me, thanks.
>
> > but discovery is a non-trivial problem for roughly everyone
>
> It is, like data management in general.
>
> For me, manuals (texinfo, man pages) are "the" definitive source for
> information about the installed features. Occasionally I use C-h a too,
> as it often catches things that are not mentioned in manuals.
This is not the best practice for Emacs. The Emacs manuals don't
mention all the features, simply because there are too many of them,
and mentioning them all will make the manuals impractically large.
By contrast, the built-in Help commands will return information about
all the features that are either already loaded or auto-loaded.
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-11-23 13:51 ` Eli Zaretskii
@ 2024-12-06 19:14 ` Jean Louis
2024-12-07 7:27 ` Eli Zaretskii
0 siblings, 1 reply; 25+ messages in thread
From: Jean Louis @ 2024-12-06 19:14 UTC (permalink / raw)
To: emacs-devel, Eli Zaretskii, Petteri Hintsanen; +Cc: yandros
On November 23, 2024 4:51:03 PM GMT+03:00, Eli Zaretskii <eliz@gnu.org> wrote:
>> Date: Sat, 23 Nov 2024 15:13:43 +0200
>> Cc: Eli Zaretskii <eliz@gnu.org>, emacs-devel@gnu.org
>> From: Petteri Hintsanen <petterih@iki.fi>
>>
>> C-h P is news for me, thanks.
>>
>> > but discovery is a non-trivial problem for roughly everyone
>>
>> It is, like data management in general.
>>
>> For me, manuals (texinfo, man pages) are "the" definitive source for
>> information about the installed features. Occasionally I use C-h a too,
>> as it often catches things that are not mentioned in manuals.
>
>This is not the best practice for Emacs. The Emacs manuals don't
>mention all the features, simply because there are too many of them,
>and mentioning them all will make the manuals impractically large.
>
>By contrast, the built-in Help commands will return information about
>all the features that are either already loaded or auto-loaded.
>
As an advocate for clarity and completeness, I believe the Emacs manual should encompass all features of Emacs. By definition, a manual is meant to provide comprehensive guidance, and leaving features undocumented goes against its purpose. Emacs is a vast and powerful tool, and its users deserve a reference that covers every aspect of its functionality to truly harness its potential.
We shall not look for size of manual to be "practical" while avoiding inclusion of useful features.
But what do you mean, practical for what situation?
Is it for printing maybe?
Jean
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-10-12 7:21 ` Eli Zaretskii
2024-10-12 9:39 ` Petteri Hintsanen
@ 2024-12-06 19:19 ` Jean Louis
2024-12-07 7:29 ` Eli Zaretskii
1 sibling, 1 reply; 25+ messages in thread
From: Jean Louis @ 2024-12-06 19:19 UTC (permalink / raw)
To: emacs-devel, Eli Zaretskii, Petteri Hintsanen
On October 12, 2024 10:21:27 AM GMT+03:00, Eli Zaretskii <eliz@gnu.org> wrote:
>> From: Petteri Hintsanen <petterih@iki.fi>
>> Date: Fri, 11 Oct 2024 23:13:44 +0300
>>
>> I was wondering if Emacs could do dictionary look-ups.
>>
>> After failed search through the manual (for "dictionary") I resorted to
>> a web search. It quickly showed that Emacs has included dictionary.el
>> since version 28 or so.
>>
>> Why this extremely useful feature is not mentioned in the manual at all?
>> Or did I just miss it somehow?
>
>We don't describe in the manual every feature we add to Emacs; we
>describe that in NEWS instead. The Emacs manual is already very
>large, so we add new features to it only of they are very important.
>
>I've now added to the manual a short description of the dictionary
>search facility.
>
>Thanks.
>
The dictionary feature in Emacs is undeniably important, as it enhances productivity and provides immediate access to word definitions this enhancing educational facility within Emacs.
While we may not currently agree on its inclusion or prominence in the Emacs manual, the feature's utility cannot be understated.
If people bring attention to its significance and share their perspectives, perhaps someone could take the initiative to write and contribute that part to the manual, ensuring its value is properly
documented for all users. Best if author could do that.
I am defining words every single day through Emacs.
Jean
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-12-06 19:14 ` Jean Louis
@ 2024-12-07 7:27 ` Eli Zaretskii
0 siblings, 0 replies; 25+ messages in thread
From: Eli Zaretskii @ 2024-12-07 7:27 UTC (permalink / raw)
To: Jean Louis; +Cc: emacs-devel, petterih, yandros
> Date: Fri, 06 Dec 2024 22:14:26 +0300
> From: Jean Louis <bugs@gnu.support>
> CC: yandros@gmail.com
>
> >> For me, manuals (texinfo, man pages) are "the" definitive source for
> >> information about the installed features. Occasionally I use C-h a too,
> >> as it often catches things that are not mentioned in manuals.
> >
> >This is not the best practice for Emacs. The Emacs manuals don't
> >mention all the features, simply because there are too many of them,
> >and mentioning them all will make the manuals impractically large.
> >
> >By contrast, the built-in Help commands will return information about
> >all the features that are either already loaded or auto-loaded.
> >
>
> As an advocate for clarity and completeness, I believe the Emacs manual should encompass all features of Emacs.
This was never the practice in Emacs, and is basically infeasible.
The Emacs manuals are also printed and sold by the FSF shop, so they
must be of reasonable size. The ELisp manuals already prints in 2
volumes. (There are also manuals in doc/misc/, which document large
stand-alone features.)
> By definition, a manual is meant to provide comprehensive guidance, and leaving features undocumented goes against its purpose.
That some variable or command are not in the manual doesn't mean they
are "undocumented", because Emacs includes built-in documentation in
the form of doc strings.
> Emacs is a vast and powerful tool, and its users deserve a reference that covers every aspect of its functionality to truly harness its potential.
>
> We shall not look for size of manual to be "practical" while avoiding inclusion of useful features.
Again, this is not our policy here, and never has been.
And if you want to preach for fuller documentation, how about if you
start by volunteering to improve its coverage, by making sure every
new variable and function that are added to Emacs get properly
documented in the corresponding manuals? Because that particular
battlefield in the Emacs development is in sore need of dedicated
volunteers, and the maintainers alone cannot be expected to fill all
that void.
> But what do you mean, practical for what situation?
>
> Is it for printing maybe?
Yes.
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-12-06 19:19 ` Jean Louis
@ 2024-12-07 7:29 ` Eli Zaretskii
2024-12-07 7:35 ` Jean Louis
0 siblings, 1 reply; 25+ messages in thread
From: Eli Zaretskii @ 2024-12-07 7:29 UTC (permalink / raw)
To: Jean Louis; +Cc: emacs-devel, petterih
> Date: Fri, 06 Dec 2024 22:19:00 +0300
> From: Jean Louis <bugs@gnu.support>
>
> On October 12, 2024 10:21:27 AM GMT+03:00, Eli Zaretskii <eliz@gnu.org> wrote:
> >> From: Petteri Hintsanen <petterih@iki.fi>
> >> Date: Fri, 11 Oct 2024 23:13:44 +0300
> >>
> >> I was wondering if Emacs could do dictionary look-ups.
> >>
> >> After failed search through the manual (for "dictionary") I resorted to
> >> a web search. It quickly showed that Emacs has included dictionary.el
> >> since version 28 or so.
> >>
> >> Why this extremely useful feature is not mentioned in the manual at all?
> >> Or did I just miss it somehow?
> >
> >We don't describe in the manual every feature we add to Emacs; we
> >describe that in NEWS instead. The Emacs manual is already very
> >large, so we add new features to it only of they are very important.
> >
> >I've now added to the manual a short description of the dictionary
> >search facility.
> >
> >Thanks.
> >
>
> The dictionary feature in Emacs is undeniably important, as it enhances productivity and provides immediate access to word definitions this enhancing educational facility within Emacs.
>
> While we may not currently agree on its inclusion or prominence in the Emacs manual, the feature's utility cannot be understated.
??? Are you sure you've read what I wrote above, about adding the
description to the manual?
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Manual does not mention dictionary.el
2024-12-07 7:29 ` Eli Zaretskii
@ 2024-12-07 7:35 ` Jean Louis
0 siblings, 0 replies; 25+ messages in thread
From: Jean Louis @ 2024-12-07 7:35 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: emacs-devel, petterih
* Eli Zaretskii <eliz@gnu.org> [2024-12-07 10:30]:
> Are you sure you've read what I wrote above, about adding the
> description to the manual?
Thanks.
Jean
^ permalink raw reply [flat|nested] 25+ messages in thread
end of thread, other threads:[~2024-12-07 7:35 UTC | newest]
Thread overview: 25+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-10-11 20:13 Manual does not mention dictionary.el Petteri Hintsanen
2024-10-11 21:35 ` Divya
2024-10-11 22:39 ` Juergen Fenn
2024-10-12 7:21 ` Eli Zaretskii
2024-10-12 9:39 ` Petteri Hintsanen
2024-10-12 18:23 ` chad
2024-10-12 18:32 ` Eli Zaretskii
2024-10-12 21:59 ` Joost Kremers
2024-10-13 5:12 ` Eli Zaretskii
2024-10-14 1:39 ` chad
2024-10-14 7:11 ` Joost Kremers
2024-10-14 14:07 ` Eli Zaretskii
2024-10-14 13:50 ` Eli Zaretskii
2024-10-14 18:23 ` chad
2024-10-15 0:46 ` Michael Heerdegen via Emacs development discussions.
2024-10-15 5:30 ` chad
2024-10-15 12:20 ` Eli Zaretskii
2024-10-15 13:14 ` Eli Zaretskii
2024-11-23 13:13 ` Petteri Hintsanen
2024-11-23 13:51 ` Eli Zaretskii
2024-12-06 19:14 ` Jean Louis
2024-12-07 7:27 ` Eli Zaretskii
2024-12-06 19:19 ` Jean Louis
2024-12-07 7:29 ` Eli Zaretskii
2024-12-07 7:35 ` Jean Louis
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).