bug#54963: 28.1; bindings for widget-describe and button-describe

bug#54963: 28.1; bindings for widget-describe and button-describe

[Howard Melman]

Maybe I'm missing something but I see that Emacs 28.1 added
functions widget-describe and button-describe that offer
help when point is on one of these things,  but there's no
binding for them.

I think that some key, perhaps C-h or ? or something should
invoke these when point is on them.  Maybe it should be
integrated with display-local-help on `C-h .' ?

Howard


In GNU Emacs 28.1 (build 1, x86_64-apple-darwin20.6.0, Carbon Version 164 AppKit 2022.6)
of 2022-04-09 built on Mac-1649520554451.local
Repository revision: ee79b048bbb2fd4a962dfb2204cc7a2f0d5237d8
Repository branch: 28.1-mac-9.0-CI
Windowing system distributor 'Apple Inc.', version 11.6.5
System Description:  macOS 11.6.5

Configured using:
'configure --with-mac
--enable-locallisppath=/usr/local/share/emacs/site-lisp:/opt/homebrew/share/emacs/site-lisp
--enable-mac-app=/Users/runner/work/homebrew-emacsmacport/homebrew-emacsmacport/build-scripts/emacs-source/tmproot
--prefix=/Users/runner/work/homebrew-emacsmacport/homebrew-emacsmacport/build-scripts/emacs-source/tmproot
--enable-mac-self-contained --with-modules'

Configured features:
ACL GMP GNUTLS JSON LIBXML2 MODULES NOTIFY KQUEUE PDUMPER
THREADS TOOLKIT_SCROLL_BARS XIM ZLIB

Important settings:
  value of $LANG: en_US.UTF-8
  locale-coding-system: utf-8-unix

Major mode: ELisp/l

Minor modes in effect:
  magit-todos-mode: t
  global-git-commit-mode: t
  magit-auto-revert-mode: t
  highlight-changes-visible-mode: t
  pyvenv-mode: t
  bug-reference-prog-mode: t
  outline-minor-mode: t
  marginalia-mode: t
  vertico-multiform-mode: t
  vertico-mode: t
  shell-dirtrack-mode: t
  diff-hl-flydiff-mode: t
  global-diff-hl-mode: t
  diff-hl-mode: t
  wrap-region-global-mode: t
  wrap-region-mode: t
  beacon-mode: t
  savehist-mode: t
  global-hl-todo-mode: t
  hl-todo-mode: t
  which-key-mode: t
  global-page-break-lines-mode: t
  page-break-lines-mode: t
  global-hl-line-mode: t
  which-function-mode: t
  recentf-mode: t
  diredfl-global-mode: t
  tooltip-mode: t
  global-eldoc-mode: t
  eldoc-mode: t
  show-paren-mode: t
  electric-indent-mode: t
  mac-mouse-wheel-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  context-menu-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  size-indication-mode: t
  column-number-mode: t
  line-number-mode: t
  transient-mark-mode: t

Load-path shadows:
/Users/hmelman/.emacs.d/elpa/transient-20220412.1523/transient hides /Applications/Emacs.app/Contents/Resources/lisp/transient

Features:
(help-at-pt xwidget wid-browse cus-theme diff-hl-show-hunk
diff-hl-inline-popup dabbrev shortdoc mule-diag apropos
mailalias mailclient eudcb-macos-contacts executable eudc
eudc-options-file eudc-vars hippie-exp shadow sort mail-extr
emacsbug sendmail markdown-mode edit-indirect ediff
ediff-merg ediff-mult ediff-wind ediff-diff ediff-help
ediff-init ediff-util dired-aux dired-x diff-hl-dired
magit-extras ol-eww eww xdg url-queue mm-url ol-rmail ol-mhe
ol-irc ol-info ol-gnus nnselect gnus-search eieio-opt
speedbar ezimage dframe gnus-art mm-uu mml2015 mm-view
mml-smime smime dig gnus-sum shr kinsoku svg dom gnus-group
gnus-undo gnus-start gnus-dbus dbus xml gnus-cloud nnimap
nnmail mail-source utf7 netrc nnoo gnus-spec gnus-int
gnus-range gnus-win ol-docview doc-view image-mode exif
ol-bibtex ol-bbdb ol-w3m ol-doi org-link-doi magit-todos
pcre2el rxt re-builder async the-org-mode-expansions
org-element avl-tree org-location-google-maps org-agenda
org-refile google-maps google-maps-static
google-maps-geocode google-maps-base org org-macro
org-footnote org-pcomplete org-list org-faces org-entities
org-version ob-R ob ob-tangle org-src ob-ref ob-lob ob-table
ob-exp ob-comint ob-emacs-lisp ob-core ob-eval org-table
oc-basic bibtex ol org-keys oc org-compat org-macs
org-loaddefs cal-menu calendar cal-loaddefs magit-bookmark
magit-submodule magit-obsolete magit-blame magit-stash
magit-reflog magit-bisect magit-push magit-pull magit-fetch
magit-clone magit-remote magit-commit magit-sequence
magit-notes magit-worktree magit-tag magit-merge
magit-branch magit-reset magit-files magit-refs magit-status
magit magit-repos magit-apply magit-wip magit-log magit-diff
smerge-mode git-commit log-edit message rmc puny rfc822 mml
mml-sec epa epg rfc6068 epg-config mm-decode mm-bodies
mm-encode mailabbrev gmm-utils mailheader magit-core
magit-autorevert magit-margin magit-transient magit-process
with-editor magit-mode magit-git magit-base magit-section
crm company-oddmuse company-keywords company-etags
company-gtags company-dabbrev-code company-dabbrev
company-files company-clang company-template company-cmake
company-bbdb misearch multi-isearch cl-print debug cus-start
autorevert filenotify tab-line elec-pair flyspell ispell
view delsel rect subword-mode-expansions cap-words superword
subword so-long rainbow-mode whitespace
display-fill-column-indicator git-gutter
display-line-numbers highlight-indent-guides color hilit-chg
info-colors face-remap facemenu mule-util helpful trace
edebug backtrace info-look f elisp-refs python-black
reformatter yasnippet flymake-proc flymake warnings
company-capf company help-fns radix-tree elpy elpy-rpc
pyvenv eshell esh-cmd esh-ext esh-opt esh-proc esh-io
esh-arg esh-module esh-groups esh-util elpy-shell
elpy-profile elpy-django s elpy-refactor
python-el-fgallina-expansions python tramp-sh ido hideshow
etags fileloop generator xref project add-log jka-compr
disp-table vc-mtn vc-hg vc-git vc-bzr vc-src vc-sccs vc-svn
vc-cvs vc-rcs bug-reference pcase noutline outline server
derived notes3 embark-consult embark ffap consult-vertico
consult bookmark marginalia orderless vertico-multiform
vertico package-commits hrm-tabs tramp tramp-loaddefs
trampver tramp-integration tramp-compat shell pcomplete
parse-time iso8601 diff-hl-flydiff diff diff-hl log-view
pcvs-util vc-dir ewoc diff-mode ace-link avy wrap-region
dash rg-isearch rg files-x vc vc-dispatcher rg-info-hack
rg-menu rg-ibuffer rg-result wgrep-rg wgrep rg-history
rg-header cus-edit pp expand-region text-mode-expansions
er-basic-expansions expand-region-core expand-region-custom
symbol-overlay beacon dired-quick-sort hydra lv savehist
ls-lisp find-func hl-todo which-key dim page-break-lines
hl-line transient cl-extra help-mode format-spec
exec-path-from-shell saveplace which-func imenu recentf
tree-widget projectile lisp-mnt mail-parse rfc2231 grep
compile comint ansi-color ring ibuf-ext ibuffer
ibuffer-loaddefs thingatpt gnus nnheader gnus-util rmail
rmail-loaddefs rfc2047 rfc2045 ietf-drums
text-property-search time-date mail-utils mm-util mail-prsvr
wid-edit diredfl dired dired-loaddefs cus-load edmacro
kmacro rx easy-mmode advice info package browse-url url
url-proxy url-privacy url-expand url-methods url-history
url-cookie url-domsuf url-util mailcap url-handlers
url-parse auth-source cl-seq eieio eieio-core cl-macs
eieio-loaddefs password-cache json subr-x map url-vars seq
byte-opt gv bytecomp byte-compile cconv cl-loaddefs cl-lib
iso-transl tooltip eldoc paren electric uniquify ediff-hook
vc-hooks lisp-float-type elisp-mode mwheel term/mac-win
mac-win term/common-win tool-bar dnd fontset image
regexp-opt fringe tabulated-list replace newcomment
text-mode lisp-mode prog-mode register page tab-bar menu-bar
rfn-eshadow isearch easymenu timer select scroll-bar mouse
jit-lock font-lock syntax font-core term/tty-colors frame
minibuffer cl-generic cham georgian utf-8-lang misc-lang
vietnamese tibetan thai tai-viet lao korean japanese
eucjp-ms cp51932 hebrew greek romanian slovak czech european
ethiopic indian cyrillic chinese composite emoji-zwj
charscript charprop case-table epa-hook jka-cmpr-hook help
simple abbrev obarray cl-preloaded nadvice button loaddefs
faces cus-face macroexp files window text-properties overlay
sha1 md5 base64 format env code-pages mule custom widget
hashtable-print-readable backquote threads kqueue mac
multi-tty make-network-process emacs)

Memory information:
((conses 16 710957 115309)
(symbols 48 46267 75)
(strings 32 209252 17730)
(string-bytes 1 7296932)
(vectors 16 102989)
(vector-slots 8 1797304 147819)
(floats 8 687 1379)
(intervals 56 44590 572)
(buffers 992 48))

bug#54963: 28.1; bindings for widget-describe and button-describe

[Lars Ingebrigtsen]

Howard Melman <hmelman@gmail.com> writes:

> Maybe I'm missing something but I see that Emacs 28.1 added
> functions widget-describe and button-describe that offer
> help when point is on one of these things,  but there's no
> binding for them.
>
> I think that some key, perhaps C-h or ? or something should
> invoke these when point is on them.  Maybe it should be
> integrated with display-local-help on `C-h .' ?

`C-u C-x =' does mention the presence of a button:

Here is a ‘help-character-set’ button labeled ‘ascii’, but doesn't
actually link to `button-describe', which should be fixed, at least.

Integrating with `C-h .' might be possible -- for instance, `C-u C-h .'
might run button/widget-describe?  I think having plain `C-h .' do so
would be confusing, since buttons commonly have a help text, and that's
what `C-h .' shows.

Or put this somewhere else.  Anybody got any opinions?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#54963: 28.1; bindings for widget-describe and button-describe

[Lars Ingebrigtsen]

Lars Ingebrigtsen <larsi@gnus.org> writes:

> Integrating with `C-h .' might be possible -- for instance, `C-u C-h .'
> might run button/widget-describe?  I think having plain `C-h .' do so
> would be confusing, since buttons commonly have a help text, and that's
> what `C-h .' shows.
>
> Or put this somewhere else.  Anybody got any opinions?

Nobody has suggestions, so I went ahead and did this in Emacs 29.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no