GNU bug report logs - #54543
Unclear explanation in the "Select Tags Table" part of the manual

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 54543 in the body.
You can then email your comments to 54543 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: Daniel Martín <mardani29 <at> yahoo.es>
To: bug-gnu-emacs <at> gnu.org
Subject: Unclear explanation in the "Select Tags Table" part of the manual
Date: Thu, 24 Mar 2022 14:12:48 +0100

Steps to reproduce the problem:

emacs -Q
Eval (info "(emacs) Select Tags Table")

The manual says at the beginning:

"Emacs has at any time at most one “selected” tags table.  All the
commands for working with tags tables use the selected one."

But then, later on, it says:

"The tags commands use all the tags tables
in the current list.  If you start a new list, the new tags table is
used _instead_ of others.  If you add the new table to the current list,
it is used _as well as_ the others."

Doesn't this sound like a contradiction?  I think the first sentence
should say there's at most one selected "tags table _list_", right?

Thanks.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Daniel Martín <mardani29 <at> yahoo.es>
Cc: 54543 <at> debbugs.gnu.org
Subject: Re: bug#54543: Unclear explanation in the "Select Tags Table" part of
 the manual
Date: Thu, 24 Mar 2022 16:37:51 +0200

> Date: Thu, 24 Mar 2022 14:12:48 +0100
> From:  Daniel Martín via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs <at> gnu.org>
> 
> 
> Steps to reproduce the problem:
> 
> emacs -Q
> Eval (info "(emacs) Select Tags Table")
> 
> The manual says at the beginning:
> 
> "Emacs has at any time at most one “selected” tags table.  All the
> commands for working with tags tables use the selected one."
> 
> But then, later on, it says:
> 
> "The tags commands use all the tags tables
> in the current list.  If you start a new list, the new tags table is
> used _instead_ of others.  If you add the new table to the current list,
> it is used _as well as_ the others."
> 
> Doesn't this sound like a contradiction?  I think the first sentence
> should say there's at most one selected "tags table _list_", right?

No.  There's both the "selected" tags table and the "current set of
tags table" (what you call "tags table list").

The text is indeed a bit confusing, because it leads to this
interpretation, but the way to fix it is different from what you
thought.  Hmm...

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: mardani29 <at> yahoo.es
Cc: 54543 <at> debbugs.gnu.org
Subject: Re: bug#54543: Unclear explanation in the "Select Tags Table" part of
 the manual
Date: Thu, 24 Mar 2022 17:24:27 +0200

> Date: Thu, 24 Mar 2022 16:37:51 +0200
> From: Eli Zaretskii <eliz <at> gnu.org>
> Cc: 54543 <at> debbugs.gnu.org
> 
> The text is indeed a bit confusing, because it leads to this
> interpretation, but the way to fix it is different from what you
> thought.  Hmm...

I've now tried to fix this on the emacs-28 branch, please take a look.

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

From: Daniel Martín <mardani29 <at> yahoo.es>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 54543 <at> debbugs.gnu.org
Subject: Re: bug#54543: Unclear explanation in the "Select Tags Table" part
 of the manual
Date: Thu, 24 Mar 2022 17:34:44 +0100

Eli Zaretskii <eliz <at> gnu.org> writes:

>> Date: Thu, 24 Mar 2022 16:37:51 +0200
>> From: Eli Zaretskii <eliz <at> gnu.org>
>> Cc: 54543 <at> debbugs.gnu.org
>> 
>> The text is indeed a bit confusing, because it leads to this
>> interpretation, but the way to fix it is different from what you
>> thought.  Hmm...
>
> I've now tried to fix this on the emacs-28 branch, please take a look.

Thanks, the text is much more understandable now.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Daniel Martín <mardani29 <at> yahoo.es>
Cc: 54543-done <at> debbugs.gnu.org
Subject: Re: bug#54543: Unclear explanation in the "Select Tags Table" part
 of the manual
Date: Thu, 24 Mar 2022 19:00:34 +0200

> From: Daniel Martín <mardani29 <at> yahoo.es>
> Cc: 54543 <at> debbugs.gnu.org
> Date: Thu, 24 Mar 2022 17:34:44 +0100
> 
> Eli Zaretskii <eliz <at> gnu.org> writes:
> 
> >> Date: Thu, 24 Mar 2022 16:37:51 +0200
> >> From: Eli Zaretskii <eliz <at> gnu.org>
> >> Cc: 54543 <at> debbugs.gnu.org
> >> 
> >> The text is indeed a bit confusing, because it leads to this
> >> interpretation, but the way to fix it is different from what you
> >> thought.  Hmm...
> >
> > I've now tried to fix this on the emacs-28 branch, please take a look.
> 
> Thanks, the text is much more understandable now.

Ok, so I'm closing this bug.

Thanks.

Previous Next

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