From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: Would you say this information window is well designed? Date: Mon, 22 Feb 2021 15:19:40 -0600 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="8801"; mail-complaints-to="usenet@ciao.gmane.io" To: Peter Dean , "emacs-devel@gnu.org" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Feb 22 22:20:58 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lEIdV-0002B8-Ob for ged-emacs-devel@m.gmane-mx.org; Mon, 22 Feb 2021 22:20:57 +0100 Original-Received: from localhost ([::1]:34206 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lEIdU-0003EP-Qw for ged-emacs-devel@m.gmane-mx.org; Mon, 22 Feb 2021 16:20:56 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57012) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lEIcK-0002BK-7C for emacs-devel@gnu.org; Mon, 22 Feb 2021 16:19:45 -0500 Original-Received: from mail-pg1-x52d.google.com ([2607:f8b0:4864:20::52d]:36194) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lEIcH-0004Yp-Uf for emacs-devel@gnu.org; Mon, 22 Feb 2021 16:19:43 -0500 Original-Received: by mail-pg1-x52d.google.com with SMTP id t26so11039586pgv.3 for ; Mon, 22 Feb 2021 13:19:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:in-reply-to:references:mime-version:date:message-id:subject:to; bh=julQ8AQt0vDcqGFBI6ROqxQCnRjyuX4aZSAIlWXFOB0=; b=WYxikP77kobLG1AMcK8ikZ+Ln+NH9o/qUiYBawbsBnVIliBwMK/viBYsP44GyqU420 b7SMYI+nnEo8w/ZJH7zyox0SlhqH+ktENZJjdLwhTBCVdjH8s7p3mzNjnj/PoNEsQ8Qd bmsd6vsfPqFQTVrTv3g5239ca9rppbg4L2xuARoG2K+1X0FWJgEQTReulmaldL6Z3Yl9 JoEDa9UmQ4K0OopkXjh43zX2wg3z+oRqi/74gPXWCypQeXlWsawqwDJozg1J+rlHsTEm rA1v1JfO3Yt6x+AjgEes8a/ogD5Sh2d1TpItrEA0pIycpZULR+/eGElV2xsGq7K6SB2O 1VIQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to; bh=julQ8AQt0vDcqGFBI6ROqxQCnRjyuX4aZSAIlWXFOB0=; b=Rjvx/LqQgAnze7aNZB17hIzsMqtQukRxySrxKx8cHtl+N8ai7Qm6UggEpq+bHgGwRE YLqpFN3ySP7uw/JpgdkvJn7hkypTdnfn5gtGARZoGPDSDIEwCBiYOXfAluZScazt4xx4 BjSW1tCsIEUy/WMoty9VSxvIfoPEgONPUJalDTMLMc7Cl5QXW9y7ql7ZB0A+2MvuGXle ORSwF0RNdHzy4AZP65jyeXBTG0y/5FtDBUm8zhfEJr2CyhB59TGe1azzrMG6exJZABpl tS2FaLX9fLLHB96powcxcvaNiw4tLpHPZd0RNJPeVj1w1mnBeM3VxuS5B2Zwr+xvZTpA wANQ== X-Gm-Message-State: AOAM533nL9ysM+gAhhLpdPD65sLgyIC51Lq2zg6DGLwQQLcvs57tJTRG i8yhRnmWnZ+nEXtNQHGyDvQpAqkSFLGGBfXX6XA= X-Google-Smtp-Source: ABdhPJzFFLDEfR+nMA5T4pWl9BxUdktVB8llw0q/RRO4u1gyViYD0tieVlMvlfp0U3w1R7F1b3up2dtE78onn+sQpuY= X-Received: by 2002:a63:ed02:: with SMTP id d2mr21844430pgi.67.1614028780551; Mon, 22 Feb 2021 13:19:40 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Mon, 22 Feb 2021 15:19:40 -0600 In-Reply-To: Received-SPF: pass client-ip=2607:f8b0:4864:20::52d; envelope-from=stefankangas@gmail.com; helo=mail-pg1-x52d.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:265507 Archived-At: Peter Dean writes: > The package Helpful improves the default Help look. Some ideas > for coloring and formatting could be borrowed from it to make the > default mode more appealing, less spartan: > > https://raw.githubusercontent.com/Wilfred/helpful/master/screenshots/helpful.png I have tried it before and think there are definitely some good ideas there. However, with everything enabled by default it can be a little bit overpowering (and there are few customization options). Anyone can install it from MELPA and try it out to see it in action. Unfortunately it is not on GNU ELPA. :-/ Obviously this will have no font-locking but see below the full output of `M-x helpful-function RET describe-package RET': --- describe-package is an autoloaded, interactive and natively compiled function defined in package.el. Signature (describe-package PACKAGE) Documentation Display the full documentation of PACKAGE (a symbol). View in manual Key Bindings ehelp-map P global-map P global-map C-h P help-map P References References in package.el: (defun describe-package ...) 1 reference (defun describe-package-1 ...) 1 reference (defun package-install-button-action ...) 1 reference (defun package-delete-button-action ...) 1 reference (defun package-menu-describe-package ...) 1 reference Find all references Find callees Debugging Enable edebug Enable tracing Disassemble Forget Source Code ;; Defined in ~/wip/emacs-nativecomp/lisp/emacs-lisp/package.el ;;;; Package description buffer. ;;;###autoload (defun describe-package (package) "Display the full documentation of PACKAGE (a symbol)." (interactive (let* ((guess (or (function-called-at-point) (symbol-at-point)))) (require 'finder-inf nil t) ;; Load the package list if necessary (but don't activate them). (unless package--initialized (package-initialize t)) (let ((packages (append (mapcar #'car package-alist) (mapcar #'car package-archive-contents) (mapcar #'car package--builtins)))) (unless (memq guess packages) (setq guess nil)) (setq packages (mapcar #'symbol-name packages)) (let ((val (completing-read (format-prompt "Describe package" guess) packages nil t nil nil (when guess (symbol-name guess))))) (list (and (> (length val) 0) (intern val))))))) (if (not (or (package-desc-p package) (and package (symbolp package)))) (message "No package specified") (help-setup-xref (list #'describe-package package) (called-interactively-p 'interactive)) (with-help-window (help-buffer) (with-current-buffer standard-output (describe-package-1 package))))) Symbol Properties autoload ("package" 1474660 t nil) event-symbol-element-mask (describe-package 0) event-symbol-elements (describe-package) modifier-cache ((0 . describe-package))