all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* 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 external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.