From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Gregory Heytings Newsgroups: gmane.emacs.devel Subject: Re: Proposal for an improved `help-for-help' Date: Thu, 08 Apr 2021 18:48:42 +0000 Message-ID: <9ff81b52fa31936e9783@heytings.org> References: <838s7hxqkr.fsf@gnu.org> <83mtua9isw.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; format=flowed; charset=us-ascii Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="22044"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Apr 08 20:49:55 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 1lUZj1-0005ec-DX for ged-emacs-devel@m.gmane-mx.org; Thu, 08 Apr 2021 20:49:55 +0200 Original-Received: from localhost ([::1]:35158 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lUZj0-0006lq-Ca for ged-emacs-devel@m.gmane-mx.org; Thu, 08 Apr 2021 14:49:54 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56014) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lUZhv-0006HX-F2 for emacs-devel@gnu.org; Thu, 08 Apr 2021 14:48:47 -0400 Original-Received: from heytings.org ([95.142.160.155]:34342) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lUZht-0002gg-02 for emacs-devel@gnu.org; Thu, 08 Apr 2021 14:48:46 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=heytings.org; s=20210101; t=1617907722; bh=NndExf+q/c8sl60hkQcH+dzu38S7r5OCumqMNFoZs8s=; h=Date:From:To:cc:Subject:In-Reply-To:Message-ID:References:From; b=ouyptiOtWIj2aaYqcO07wfudHfegUBBkyvtwVTAergjHLQHyLe7Y1qLZySH3GaVBq DiPJvPgvrYyTIMvrHQ4cF+Y0zSukTo+Xfvx0IHu3vRnxYNhzMSzsjB8uKN3To/W/dM Xm1O5O1WVHrbPsLXWG4GTPFWA9fISuvvEg3zEAjcWdknFNOy0y8nAFQIq5NeU7sbU5 rAgZhjum6WicjldeNZRjSp9XNxXAskXWJnVNrYh+UYVUgxH8jfhXYgTRW+M0tlvuup c7lzYpndq9i//mcw1NhadJSPfs6MxYfSvQ63XwBtKA/Coyfas1E3Y5bh3FyvSgv57U dACPxpQWAA0Aw== In-Reply-To: Received-SPF: pass client-ip=95.142.160.155; envelope-from=gregory@heytings.org; helo=heytings.org 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, SPF_HELO_PASS=-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:267651 Archived-At: Some more comments on your last screenshot: A nitpick: I would add a comma after "to search" on the first line. About the "language" section, on a second thought I'm not quite sure anymore that "language" is the most appropriate word here. It is about character sets and how encoding and decoding happens: how Emacs encodes and decodes text files, and how users can use various coding systems to input characters that are not present on their keyboard (mathematical symbols, phonetic alphabet, foreign language characters, ...). So I would suggest something like "Help about Character Codings". Sure, that sounds very technical, but these help commands are indeed very technical. I would put "Describe input method" as the first entry there, it's the one users will most likely want/need to use. And I would perhaps move the "Show current syntax table" in that section, above the "Display the HELLO file".