GNU bug report logs - #46089
26.3; Doc string of `read-regexp-suggestions'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 46089 in the body.
You can then email your comments to 46089 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: "bug-gnu-emacs <at> gnu.org" <bug-gnu-emacs <at> gnu.org>
Subject: 26.3; Doc string of `read-regexp-suggestions'
Date: Sun, 24 Jan 2021 23:36:48 +0000

  Return a list of standard suggestions for `read-regexp'.
  By default, the list includes the tag at point, the last isearch regexp,
  the last isearch string, and the last replacement regexp.  `read-regexp'
  appends the list returned by this function to the end of values available
  via M-n.

What's "the tag at point"?  What does "tag" mean here?  I have no idea.

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.18362
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 46089 <at> debbugs.gnu.org
Subject: Re: bug#46089: 26.3; Doc string of `read-regexp-suggestions'
Date: Wed, 27 Jan 2021 03:47:22 +0100

Drew Adams <drew.adams <at> oracle.com> writes:

>   Return a list of standard suggestions for `read-regexp'.
>   By default, the list includes the tag at point, the last isearch regexp,
>   the last isearch string, and the last replacement regexp.  `read-regexp'
>   appends the list returned by this function to the end of values available
>   via M-n.
>
> What's "the tag at point"?  What does "tag" mean here?  I have no idea.

I've now added a link to the tags section in the manual.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: "46089 <at> debbugs.gnu.org" <46089 <at> debbugs.gnu.org>
Subject: RE: [External] : Re: bug#46089: 26.3; Doc string of
 `read-regexp-suggestions'
Date: Wed, 27 Jan 2021 03:10:06 +0000

> >   Return a list of standard suggestions for `read-regexp'.
> >   By default, the list includes the tag at point, the last isearch
> regexp,
> >   the last isearch string, and the last replacement regexp.  `read-
> regexp'
> >   appends the list returned by this function to the end of values
> available
> >   via M-n.
> >
> > What's "the tag at point"?  What does "tag" mean here?  I have no
> idea.
> 
> I've now added a link to the tags section in the manual.

I suppose I need to take your word for it.

What manual section is that - what node?

`i tag' doesn't find anything except these index entries:

  tag on run time stack  
  qqtag, customization keyword

I can't imagine what either of those has to do with
suggestions for `read-regexp'.

Node `Text from Minibuffer' says this:

 − The word or symbol at point.
 − The last regexp used in an incremental search.
 − The last string used in an incremental search.
 − The last string or pattern used in query-replace commands.

Is the first of those, "word or symbol", what the
doc string means by "tag"?

There are these meanings of "tag" in Emacs, AFAIK:

* Org mode tags (user-supplied labels/categories).
* TAGS file tags (places where something is defined).

I can't imagine either of those being something
that's "at point".

A wild, completely naive guess is that the doc
string is misworded, and that "word or symbol"
is what's meant.  Or perhaps what's meant is a
word or symbol at point that's got an entry in
the current (or some) TAGS table.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: "46089 <at> debbugs.gnu.org" <46089 <at> debbugs.gnu.org>
Subject: RE: [External] : Re: bug#46089: 26.3; Doc string of
 `read-regexp-suggestions'
Date: Wed, 27 Jan 2021 03:12:52 +0000

>   tag on run time stack
>   qqtag, customization keyword
      ^
     tag  (typo)

Previous Next

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