GNU bug report logs - #50760
26.3; Add `symbol' to the Emacs manul glossary

Previous Next

Full log

Message #19 received at 50760 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: "larsi <at> gnus.org" <larsi <at> gnus.org>,
 "50760 <at> debbugs.gnu.org" <50760 <at> debbugs.gnu.org>
Subject: RE: bug#50760: [External] : Re: bug#50760: 26.3; Add `symbol' to the
 Emacs manul glossary
Date: Fri, 24 Sep 2021 18:53:17 +0000

> > There are (at least) two important meanings of "symbol" in Emacs:
> >
> > 1. The usual Lisp meaning, which is meaningful only in Lisp.
> >
> > 2. The Elisp meaning of characters with symbol-constituent syntax.
> And perhaps names composed of such chars, possibly combined with chars
> with other syntax, e.g., typically word-constituent.
> >
> > For example, in programming languages (not only Elisp), we have
> commands such as `forward-symbol'.  They move over or otherwise
> manipulate names composed of symbol-constituent chars and sometimes
> other kinds of chars.
> >
> > Emacs users deserve to know about these quite different meanings, I
> think. Each such meaning is important to using Emacs.
> 
> The meaning of "symbol" for searching is explained in "Symbol Search".

Great.  Add that meaning to the glossary entry, please.
(And it's also movement commands, not just search.)

A user seeing the doc string for `C-h S'
(`info-lookup-symbol') can well wonder what "symbol"
means.

My observation comes from someone having questioned
possibly using the word "symbol" in a help menu item
(for `info-lookup-symbol').  The term isn't obvious,
especially for new users.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.