* bug#56251: Make obsoletion info more prominent in *Help* buffer
@ 2022-06-27 10:14 Stefan Kangas
2022-06-27 10:51 ` Lars Ingebrigtsen
2022-06-29 19:24 ` Rudolf Adamkovič via Bug reports for GNU Emacs, the Swiss army knife of text editors
0 siblings, 2 replies; 6+ messages in thread
From: Stefan Kangas @ 2022-06-27 10:14 UTC (permalink / raw)
To: 56251
Severity: wishlist
We have moved all the extra information in the *Help* buffer to the end.
For example, see `org-agenda-ignore-drawer-properties':
This variable is an alias for ‘org-agenda-ignore-properties’.
This variable is obsolete since 9.0;
use ‘org-agenda-ignore-properties’ instead.
You can customize this variable.
This is very welcome. However, I find that the obsoletion warning is
easy to miss. Presumably, this is very important information before
even considering using the variable. We want to strongly discourage
that, right?
So how about making that particular part more prominent, for example by
moving it back up to the top again, or by giving it some color?
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#56251: Make obsoletion info more prominent in *Help* buffer
2022-06-27 10:14 bug#56251: Make obsoletion info more prominent in *Help* buffer Stefan Kangas
@ 2022-06-27 10:51 ` Lars Ingebrigtsen
2022-06-27 14:48 ` Drew Adams
2022-06-28 13:22 ` Lars Ingebrigtsen
2022-06-29 19:24 ` Rudolf Adamkovič via Bug reports for GNU Emacs, the Swiss army knife of text editors
1 sibling, 2 replies; 6+ messages in thread
From: Lars Ingebrigtsen @ 2022-06-27 10:51 UTC (permalink / raw)
To: Stefan Kangas; +Cc: 56251
Stefan Kangas <stefan@marxist.se> writes:
> However, I find that the obsoletion warning is
> easy to miss. Presumably, this is very important information before
> even considering using the variable. We want to strongly discourage
> that, right?
>
> So how about making that particular part more prominent, for example by
> moving it back up to the top again, or by giving it some color?
I think moving it back to the top makes sense -- it's very important
information.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#56251: Make obsoletion info more prominent in *Help* buffer
2022-06-27 10:51 ` Lars Ingebrigtsen
@ 2022-06-27 14:48 ` Drew Adams
2022-06-28 13:22 ` Lars Ingebrigtsen
1 sibling, 0 replies; 6+ messages in thread
From: Drew Adams @ 2022-06-27 14:48 UTC (permalink / raw)
To: Lars Ingebrigtsen, Stefan Kangas; +Cc: 56251@debbugs.gnu.org
> > However, I find that the obsoletion warning is
> > easy to miss. Presumably, this is very important information before
> > even considering using the variable. We want to strongly discourage
> > that, right?
> >
> > So how about making that particular part more prominent, for example
> > by moving it back up to the top again, or by giving it some color?
>
> I think moving it back to the top makes sense -- it's very important
> information.
No, it's not more important than the other
meta-information that you've moved to the end.
It's a footnote - should be, anyway.
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#56251: Make obsoletion info more prominent in *Help* buffer
2022-06-27 10:51 ` Lars Ingebrigtsen
2022-06-27 14:48 ` Drew Adams
@ 2022-06-28 13:22 ` Lars Ingebrigtsen
1 sibling, 0 replies; 6+ messages in thread
From: Lars Ingebrigtsen @ 2022-06-28 13:22 UTC (permalink / raw)
To: Stefan Kangas; +Cc: 56251
Lars Ingebrigtsen <larsi@gnus.org> writes:
> I think moving it back to the top makes sense -- it's very important
> information.
I've now done so in Emacs 29.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#56251: Make obsoletion info more prominent in *Help* buffer
2022-06-27 10:14 bug#56251: Make obsoletion info more prominent in *Help* buffer Stefan Kangas
2022-06-27 10:51 ` Lars Ingebrigtsen
@ 2022-06-29 19:24 ` Rudolf Adamkovič via Bug reports for GNU Emacs, the Swiss army knife of text editors
2022-07-01 3:32 ` Richard Stallman
1 sibling, 1 reply; 6+ messages in thread
From: Rudolf Adamkovič via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2022-06-29 19:24 UTC (permalink / raw)
To: Stefan Kangas, 56251
Stefan Kangas <stefan@marxist.se> writes:
> However, I find that the obsoletion warning is easy to miss.
+1 As a user, I missed it multiple times. I would expect deprecation
warnings to show first. Otherwise, the user might spend their time
learning about something just to discover, at the very end, that they
should learn about and use something else. That does not make much
sense.
P.S. The *Help* buffer could use more typography and color affordances.
In this case, I would expect strike-through on the symbol name, or the
word "deprecated" displayed in red, or something else.
R+
--
"Be especially critical of any statement following the word
'obviously.'"
-- Anna Pell Wheeler, 1883-1966
Rudolf Adamkovič <salutis@me.com> [he/him]
Studenohorská 25
84103 Bratislava
Slovakia
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2022-07-01 3:32 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-06-27 10:14 bug#56251: Make obsoletion info more prominent in *Help* buffer Stefan Kangas
2022-06-27 10:51 ` Lars Ingebrigtsen
2022-06-27 14:48 ` Drew Adams
2022-06-28 13:22 ` Lars Ingebrigtsen
2022-06-29 19:24 ` Rudolf Adamkovič via Bug reports for GNU Emacs, the Swiss army knife of text editors
2022-07-01 3:32 ` Richard Stallman
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).