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

* bug#56251: Make obsoletion info more prominent in *Help* buffer
  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
  0 siblings, 0 replies; 6+ messages in thread
From: Richard Stallman @ 2022-07-01  3:32 UTC (permalink / raw)
  To: Rudolf Adamkovič; +Cc: 56251, stefan

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > +1 As a user, I missed it multiple times.  I would expect deprecation
  > warnings to show first.

I think that makes sense.

Could we also put them in a different color, for emphasis?

-- 
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)







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