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: Proposal for an improved `help-for-help' Date: Sun, 21 Feb 2021 14:04:51 -0600 Message-ID: References: <838s7hxqkr.fsf@gnu.org> <83v9alw7nu.fsf@gnu.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="37557"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Feb 21 21:14: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 1lDv85-0009f0-SV for ged-emacs-devel@m.gmane-mx.org; Sun, 21 Feb 2021 21:14:57 +0100 Original-Received: from localhost ([::1]:46518 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lDv84-0006IG-Mk for ged-emacs-devel@m.gmane-mx.org; Sun, 21 Feb 2021 15:14:56 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35606) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lDuyN-00068K-TT for emacs-devel@gnu.org; Sun, 21 Feb 2021 15:04:55 -0500 Original-Received: from mail-pf1-f180.google.com ([209.85.210.180]:43536) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lDuyM-0000De-6z; Sun, 21 Feb 2021 15:04:55 -0500 Original-Received: by mail-pf1-f180.google.com with SMTP id c11so5246343pfp.10; Sun, 21 Feb 2021 12:04:53 -0800 (PST) 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:cc; bh=im1Gg6feXzrbGOFyb4dqaGWfeEmK6e5+qO5BSYeJbYg=; b=t+V88odVWno7Yb1NCI+bDuJrpobExwmehHCFER3T/TviNUtUNn7GNpxEDM66HCIsvi 2x37DXLbKDIsX2ewmqPBgXuS5k82QNPFOUg3WrHKNDaR4jxcX/h15sG75Oz8Edwuk2RF HMiFts3Po8WHfzitrxnle2l2pVB1JjejP0hdweXnbIL1Astp6WC9OXQq60JJACoNED61 VyB4wmobbAdQ9NGJc5JoTHeeDOAugqW1VeJqR07D8z5Vss5W5WKVqUtq8tnzWvFUssuQ 9YAIesxX5ENCAmZitdp0bZYceN0No6w7ZEX+WzlyIAUiAjIic53vyTlr7PqPi1FWsj+v gc9w== X-Gm-Message-State: AOAM531VWeluRVUR9s5lh7q1bwG62Or55b0hieaR9R5i4UblmmNSF5Z9 IZyEb+MfHUbUzfXvCMhgSurv5Om8mvmUzp47tQpSZkJf X-Google-Smtp-Source: ABdhPJzRAziHts+nP2BBJWqU/wAmAPdE8wTSKT1ArxzrAIm/rxCCBsaRRlTal0u17Li/BwHDiqEXLSfty9vCtSL3sIA= X-Received: by 2002:aa7:90d3:0:b029:1ed:7eec:b031 with SMTP id k19-20020aa790d30000b02901ed7eecb031mr5435956pfk.58.1613937892273; Sun, 21 Feb 2021 12:04:52 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 21 Feb 2021 14:04:51 -0600 In-Reply-To: <83v9alw7nu.fsf@gnu.org> Received-SPF: pass client-ip=209.85.210.180; envelope-from=stefankangas@gmail.com; helo=mail-pf1-f180.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no 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:265437 Archived-At: Eli Zaretskii writes: > Ah, okay. You said you didn't care for the current order, so I > thought the order you suggested was based on some principles yhou > could describe. > > If the order is not the aspect you wanted us to consider, then which > aspects are? I admit that I didn't give a thought to any other > aspects yet. Well, it is roughly, but only very roughly here, based on an idea to put more important things higher up. (The thing that makes it "rough" is that I didn't think through carefully the exact ordering that makes sense.) This goes for both the sections and the commands themselves. Today we just have them in alphabetical order. In the final section (currently named "Other") I'm not sure we can find an "order of importance". Whereas `describe-function' clearly is more important `describe-local-help'. I think it would be useful also to get feedback on introducing titled sections, and the overall visual appearance (including coloring the keybindings).