* 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).
![[-- Attachment #2: customize.png --] [-- Type: image/png, Size: 285776 bytes --]](../../CAAF+z6E6cPfJRH5MVp-JxnvoP17fnM+WX05HVSqu_pKRVEfXmA@mail.gmail.com/2-customize.png){kind=link}