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: Tweaking the output of `C-h b' Date: Sun, 31 Oct 2021 21:55:56 -0700 Message-ID: References: <87lf29xdkf.fsf@gnus.org> <87h7cxx9bh.fsf@gnus.org> <87zgqpvtky.fsf@gnus.org> <87v91dvt6y.fsf@gnus.org> <87o874vhp2.fsf@gnus.org> <87k0hsvgvv.fsf@gnus.org> <874k8wvcie.fsf@gnus.org> 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="24623"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Lars Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Nov 01 05:56:37 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 1mhPN6-0006Ck-R9 for ged-emacs-devel@m.gmane-mx.org; Mon, 01 Nov 2021 05:56:36 +0100 Original-Received: from localhost ([::1]:41238 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mhPN4-0005iy-T1 for ged-emacs-devel@m.gmane-mx.org; Mon, 01 Nov 2021 00:56:34 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49940) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mhPMW-0004wg-Ag for emacs-devel@gnu.org; Mon, 01 Nov 2021 00:56:00 -0400 Original-Received: from mail-pj1-x1030.google.com ([2607:f8b0:4864:20::1030]:52028) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mhPMU-000392-Qh for emacs-devel@gnu.org; Mon, 01 Nov 2021 00:56:00 -0400 Original-Received: by mail-pj1-x1030.google.com with SMTP id gt5so3059295pjb.1 for ; Sun, 31 Oct 2021 21:55:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:in-reply-to:references:mime-version:date:message-id:subject:to :cc; bh=Dew3x/tq5Q0KsgFoJZAG9b1I1Twbt7+bfHFyJWoWW5A=; b=lmGFjOhSqPKJz7qZEVDux/QSAlCcnHrlT3x8n7ciG/J3nQz4w/Bjyc84aHPnjnWTk1 Em4vWFPRAXjG3j6kuQ4ptWn3VHLdnsiPFSBIsxx3vTK8x/2vciJ7UG8BJoXnzufKZPeY N6iPwfIyKwIYa6JTAT7cgMDsJMKqgPgdALfOe8pSXEAuVOAbpd9NqBz8powqgtilX3zv mQ5jgNxyWQkn4fhxNalxs3PGdlHVcetM+jzLakC3nRTABg+Im3JIaxXgvW3FIbfCMNhN QQZ/W67lxlA5eRJkSFdXPXTSZoLHL/CqKsqBNy0qgwSa+EvpzbwRfLV6wrTRh9jcTP+D XyjA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to:cc; bh=Dew3x/tq5Q0KsgFoJZAG9b1I1Twbt7+bfHFyJWoWW5A=; b=8N/AYonnkZp6CreD3+1gYO+hzKEXQ5uLxGvXdNd1xwhKg1VBJCTS2d+X8qpN8L8ah2 Efz7AuIIPtXX7r5Ic1C0BYq0qu9ihXNyjPNKqGZkmniZaeN0yay0M8NySG+Mih5o1dhD yQHX6IzZ1mJRpC+XskUhj49XDxB661NSLPVirKkMedJ/CrXEgCBSg68vGGoEkqeLGsEl TK/Q19jYOvjC4yWfucv3mnCyLzAsBHaV8HWVFNeZAaQnZFfDOQYevs2zHu2d+W98rnt6 VeWdVOrya0nJTqxaMjNCXIXbMUzzIJJ7x5Dj3lTtEwh53NVA49EnVL8S6ZU6HPtX0Jp1 lR+w== X-Gm-Message-State: AOAM533LDVuTYzq71Z27v0GSpEWxcbYk3bUoFZ94xj7jjCe/W/J8p9Y7 l02WipiTj1jwVbhEoTwQoI+99lLMYfwKFhdNYsM= X-Google-Smtp-Source: ABdhPJwqNsCkWYFx9E/MH7AEwXfErg/5gS9Dx9Gc7COpfb0WSANiGe734vrHdwGkGpq0eWmUdr7SGBh22bzeiOoJZSs= X-Received: by 2002:a17:90b:17d2:: with SMTP id me18mr35428033pjb.132.1635742557347; Sun, 31 Oct 2021 21:55:57 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 31 Oct 2021 21:55:56 -0700 In-Reply-To: <874k8wvcie.fsf@gnus.org> Received-SPF: pass client-ip=2607:f8b0:4864:20::1030; envelope-from=stefankangas@gmail.com; helo=mail-pj1-x1030.google.com X-Spam_score_int: -6 X-Spam_score: -0.7 X-Spam_bar: / X-Spam_report: (-0.7 / 5.0 requ) BAYES_05=-0.5, 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.29 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:278360 Archived-At: Lars Ingebrigtsen writes: > Have a look at the trunk now and see what you think. What you have so far looks really good. Thanks for bringing `C-h b' into this century! I'll think about it some more and I might propose some tweaks later. For now: - Why not show the first line of the docstring of the command in a new third column? - The ":" after each section is name more distracting than helpful. How about removing it? - We would be able to avoid some weird indentation if we changed it from 16/32 to 20/40. See how it indents around "C-M-". We might even want to consider 22/44 (or something odd like 22/40), see the indentation around "". - Would the structure become more clear if there was one or two spaces of indentation for the text under each section?