* bug#22448: 24.5; `M-x customize' link "See als Manual"
@ 2016-01-23 21:56 Drew Adams
2016-01-24 1:00 ` Xue Fuqiao
0 siblings, 1 reply; 6+ messages in thread
From: Drew Adams @ 2016-01-23 21:56 UTC (permalink / raw)
To: 22448
emacs -Q
M-x customize RET
The link near the top of the buffer says See also Manual.
Clicking that link should take you to the part of the Emacs
manual that presents Customize. Instead, it takes you to
the top of the manual. That's not helpful at all.
In GNU Emacs 24.5.1 (i686-pc-mingw32)
of 2015-04-11 on LEG570
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --prefix=/c/usr --host=i686-pc-mingw32'
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#22448: 24.5; `M-x customize' link "See als Manual"
2016-01-23 21:56 bug#22448: 24.5; `M-x customize' link "See als Manual" Drew Adams
@ 2016-01-24 1:00 ` Xue Fuqiao
2016-01-24 1:10 ` Drew Adams
0 siblings, 1 reply; 6+ messages in thread
From: Xue Fuqiao @ 2016-01-24 1:00 UTC (permalink / raw)
To: Drew Adams; +Cc: 22448
[-- Attachment #1: Type: text/plain, Size: 485 bytes --]
On Sun, Jan 24, 2016 at 5:56 AM, Drew Adams <drew.adams@oracle.com> wrote:
> emacs -Q
> M-x customize RET
>
> The link near the top of the buffer says See also Manual.
> Clicking that link should take you to the part of the Emacs
> manual that presents Customize. Instead, it takes you to
> the top of the manual. That's not helpful at all.
There are three links to the manual, actually. Please see the attached
screenshot. The "See also" link is for the top-level `Emacs' group.
[-- Attachment #2: customize.png --]
[-- Type: image/png, Size: 285776 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#22448: 24.5; `M-x customize' link "See als Manual"
2016-01-24 1:00 ` Xue Fuqiao
@ 2016-01-24 1:10 ` Drew Adams
2019-11-06 1:08 ` Stefan Kangas
0 siblings, 1 reply; 6+ messages in thread
From: Drew Adams @ 2016-01-24 1:10 UTC (permalink / raw)
To: Xue Fuqiao; +Cc: 22448
> > The link near the top of the buffer says See also Manual.
> > Clicking that link should take you to the part of the Emacs
> > manual that presents Customize. Instead, it takes you to
> > the top of the manual. That's not helpful at all.
>
> There are three links to the manual, actually. Please see the attached
> screenshot. The "See also" link is for the top-level `Emacs' group.
The other two links are fine. The link I reported is wrong.
Even if it is intended to be relevant to group `Emacs', it is
wrong. Group `Emacs' is a Customize group. The link does not
take you anywhere that provides information about Customize
groups in general or any Customize group in particular, let
alone the `Emacs' group.
In addition, there already is an "Emacs manual" link to the
top of the manual. There is no need for another.
The problematic link should just be removed, if there is no
doc specific for group `Emacs' to which it could be linked.
It does not help, but confuses, as it is now.
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#22448: 24.5; `M-x customize' link "See als Manual"
2016-01-24 1:10 ` Drew Adams
@ 2019-11-06 1:08 ` Stefan Kangas
2019-12-15 20:14 ` Stefan Kangas
0 siblings, 1 reply; 6+ messages in thread
From: Stefan Kangas @ 2019-11-06 1:08 UTC (permalink / raw)
To: Drew Adams; +Cc: Xue Fuqiao, 22448
Drew Adams <drew.adams@oracle.com> writes:
>> > The link near the top of the buffer says See also Manual.
>> > Clicking that link should take you to the part of the Emacs
>> > manual that presents Customize. Instead, it takes you to
>> > the top of the manual. That's not helpful at all.
>>
>> There are three links to the manual, actually. Please see the attached
>> screenshot. The "See also" link is for the top-level `Emacs' group.
>
> The other two links are fine. The link I reported is wrong.
> Even if it is intended to be relevant to group `Emacs', it is
> wrong. Group `Emacs' is a Customize group. The link does not
> take you anywhere that provides information about Customize
> groups in general or any Customize group in particular, let
> alone the `Emacs' group.
>
> In addition, there already is an "Emacs manual" link to the
> top of the manual. There is no need for another.
>
> The problematic link should just be removed, if there is no
> doc specific for group `Emacs' to which it could be linked.
> It does not help, but confuses, as it is now.
Thank you Drew for your attention to detail. Please find some of my
observations below.
I don't think this link causes any confusion. On the contrary, it is
a clear indication to users that they should read the Emacs manual if
they want help with customizing Emacs.
This adds more information than the blanket "For help using this
buffer, see Easy Customization in the Emacs manual." which is already
at the top of every Custom buffer. It is therefore fully suitable,
and indeed directly helpful, for the first entry in the M-x customize
interface (the emacs group).
So I would suggest to keep the link as is, and consequently close this
bug as wontfix. But perhaps others will have an opinion here, too.
Best regards,
Stefan Kangas
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#22448: 24.5; `M-x customize' link "See als Manual"
2019-11-06 1:08 ` Stefan Kangas
@ 2019-12-15 20:14 ` Stefan Kangas
2019-12-15 21:59 ` Drew Adams
0 siblings, 1 reply; 6+ messages in thread
From: Stefan Kangas @ 2019-12-15 20:14 UTC (permalink / raw)
To: Drew Adams; +Cc: Xue Fuqiao, 22448
tags 22448 + wontfix notabug
close 22448
thanks
Stefan Kangas <stefan@marxist.se> writes:
> So I would suggest to keep the link as is, and consequently close this
> bug as wontfix.
No other opinions within 5 weeks, so I'm closing this bug. If anyone
disagrees, feel free to reopen it.
Best regards,
Stefan Kangas
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#22448: 24.5; `M-x customize' link "See als Manual"
2019-12-15 20:14 ` Stefan Kangas
@ 2019-12-15 21:59 ` Drew Adams
0 siblings, 0 replies; 6+ messages in thread
From: Drew Adams @ 2019-12-15 21:59 UTC (permalink / raw)
To: Stefan Kangas; +Cc: Xue Fuqiao, 22448
> If anyone disagrees, feel free to reopen it.
I disagree, clearly.
But just as clearly, if you won't fix it there's
no point in asking you to reopen it.
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2019-12-15 21:59 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-01-23 21:56 bug#22448: 24.5; `M-x customize' link "See als Manual" Drew Adams
2016-01-24 1:00 ` Xue Fuqiao
2016-01-24 1:10 ` Drew Adams
2019-11-06 1:08 ` Stefan Kangas
2019-12-15 20:14 ` Stefan Kangas
2019-12-15 21:59 ` Drew Adams
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).