bug#54543: Unclear explanation in the "Select Tags Table" part of the manual

bug#54543: Unclear explanation in the "Select Tags Table" part of the manual

[Daniel Martín via Bug reports for GNU Emacs, the Swiss army knife of text editors]

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.

bug#54543: Unclear explanation in the "Select Tags Table" part of the manual

[Eli Zaretskii]

> 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@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...

bug#54543: Unclear explanation in the "Select Tags Table" part of the manual

[Eli Zaretskii]

> Date: Thu, 24 Mar 2022 16:37:51 +0200
> From: Eli Zaretskii <eliz@gnu.org>
> Cc: 54543@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.

bug#54543: Unclear explanation in the "Select Tags Table" part of the manual

[Daniel Martín via Bug reports for GNU Emacs, the Swiss army knife of text editors]

Eli Zaretskii <eliz@gnu.org> writes:

>> Date: Thu, 24 Mar 2022 16:37:51 +0200
>> From: Eli Zaretskii <eliz@gnu.org>
>> Cc: 54543@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.

bug#54543: Unclear explanation in the "Select Tags Table" part of the manual

[Eli Zaretskii]

> From: Daniel Martín <mardani29@yahoo.es>
> Cc: 54543@debbugs.gnu.org
> Date: Thu, 24 Mar 2022 17:34:44 +0100
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> >> Date: Thu, 24 Mar 2022 16:37:51 +0200
> >> From: Eli Zaretskii <eliz@gnu.org>
> >> Cc: 54543@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.