From: Stefan Monnier <monnier@iro.umontreal.ca>
To: Lars Ingebrigtsen <larsi@gnus.org>
Cc: bug#36478 <36478@debbugs.gnu.org>
Subject: bug#36478: Perhaps rearrange *Help* buffer a bit?
Date: Mon, 08 Jul 2019 17:14:05 -0400 [thread overview]
Message-ID: <jwvlfx8ck2j.fsf-monnier+emacs__21718.9490374707$1562620907$gmane$org@gnu.org> (raw)
In-Reply-To: <m3lfx81dql.fsf@gnus.org> (Lars Ingebrigtsen's message of "Mon, 08 Jul 2019 22:18:58 +0200")
> I think Drew (or somebody?) mentioned this in a bug report the other
> day: The way the automated stuff is arranged in the *Help* buffer is
> perhaps not optimal.
> This function has a compiler macro ‘internal--compiler-macro-cXXr’.
> Probably introduced at or before Emacs version 20.
[...]
> Probably introduced at or before Emacs version 1.2.
> This function does not change global state, including the match data.
[...]
> So the thought here is that those indented lines isn't what's most
> interesting to the user.
I recently reworked the generation of this text specifically to try and
make it easier to tweak it.
> Anyway, what about rearranging this a bit so that the stuff the users
> are interested in comes first?
[...]
> Let the bike-shedding commence!
Here's my favorite color:
- don't move it to the end, because it's much too far.
- hide it by default, with some obvious-enough button-like thingy to
expand it on demand.
- maybe the first line could also be moved into this "metadata" block.
- These *Help* buffers would benefit from a bit of face-lift (e.g. put
a different face on the metadata part, yet another on the
calling-convention example, ...).
Stefan
next prev parent reply other threads:[~2019-07-08 21:14 UTC|newest]
Thread overview: 19+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-07-08 20:18 Perhaps rearrange *Help* buffer a bit? Lars Ingebrigtsen
2019-07-08 20:29 ` Drew Adams
2019-07-08 20:31 ` Drew Adams
2019-07-08 21:14 ` Stefan Monnier [this message]
2019-07-08 21:14 ` Stefan Monnier
2019-07-08 22:26 ` bug#36478: " Lars Ingebrigtsen
2019-07-08 23:21 ` Drew Adams
2019-07-08 23:30 ` Stefan Monnier
2019-07-09 13:58 ` Lars Ingebrigtsen
2019-07-09 14:18 ` Stefan Monnier
2019-07-10 3:58 ` Howard Melman
2019-07-10 11:27 ` Lars Ingebrigtsen
2019-07-10 12:59 ` Howard Melman
2019-07-10 14:06 ` Drew Adams
2019-07-08 21:24 ` Basil L. Contovounesios
2019-07-08 22:38 ` Lars Ingebrigtsen
2019-07-09 0:02 ` Eric Abrahamsen
2019-07-09 0:59 ` Basil L. Contovounesios
2019-07-09 3:26 ` Eric Abrahamsen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='jwvlfx8ck2j.fsf-monnier+emacs__21718.9490374707$1562620907$gmane$org@gnu.org' \
--to=monnier@iro.umontreal.ca \
--cc=36478@debbugs.gnu.org \
--cc=larsi@gnus.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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.