From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: How to make Emacs popular again. Date: Sat, 26 Sep 2020 12:27:03 -0700 (PDT) Message-ID: <426d4d2b-9da2-47ce-8872-f138346779ca@default> References: <20200926163008.GS1349@protected.rcdrun.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14007"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Jean Louis , James Lu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Sep 26 21:28:01 2020 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 1kMFrV-0003Wj-A5 for ged-emacs-devel@m.gmane-mx.org; Sat, 26 Sep 2020 21:28:01 +0200 Original-Received: from localhost ([::1]:56208 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kMFrU-0005m5-Bo for ged-emacs-devel@m.gmane-mx.org; Sat, 26 Sep 2020 15:28:00 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44830) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kMFqg-00056U-Qi for emacs-devel@gnu.org; Sat, 26 Sep 2020 15:27:10 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:37246) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kMFqe-0003TE-GQ for emacs-devel@gnu.org; Sat, 26 Sep 2020 15:27:10 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 08QJPu79067983; Sat, 26 Sep 2020 19:27:06 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=iv7qZRXjvOgKcwsRErnHxs2JkWjYCvGZep/X9Y3BxkE=; b=vxZJ8OAGq0fCxeDMIWgVJY8iWYgiqO/08R3nTPuoZesE3F3ZZDreg7BS2webGThrKq8j dECzJ6Qmjb5Lgcv7MQaNC/ZItcnoUVXnhyac6mKHg03+HIjzCTxlCAvDGuHqEE+pt/xd 7K+XklC/6Un8ctKPMdZ5Obi9gaXKIQVZMhfqubyQkzzfzPBaLCxQdHRW/yPY7NNuyUYr R4QZHnGNSTZbn/oJuar6TzhTEJkpxhYQ+ZCyqGYVerZFyPl7hLmHaFtK7pVAB2HJ7PWv D+nhIZwoBzXmQXMZMUp+1TMFtzwefy713vqxJZl4DmgRtD4ZwpZNTMNFpcu67SHEqzRR DQ== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 33swkkh3ex-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sat, 26 Sep 2020 19:27:06 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 08QJOZqq037203; Sat, 26 Sep 2020 19:27:05 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userp3020.oracle.com with ESMTP id 33svygjvw2-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 26 Sep 2020 19:27:05 +0000 Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 08QJR4Mm016512; Sat, 26 Sep 2020 19:27:04 GMT In-Reply-To: <20200926163008.GS1349@protected.rcdrun.com> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5056.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9756 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 malwarescore=0 suspectscore=0 adultscore=0 mlxlogscore=999 spamscore=0 phishscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2009260176 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9756 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 mlxscore=0 phishscore=0 suspectscore=0 mlxlogscore=999 clxscore=1015 priorityscore=1501 impostorscore=0 lowpriorityscore=0 bulkscore=0 spamscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2009260176 Received-SPF: pass client-ip=141.146.126.78; envelope-from=drew.adams@oracle.com; helo=aserp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/09/26 15:27:07 X-ACL-Warn: Detected OS = Linux 3.1-3.10 [fuzzy] X-Spam_score_int: -55 X-Spam_score: -5.6 X-Spam_bar: ----- X-Spam_report: (-5.6 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-1.2, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, 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:256496 Archived-At: > Good example of remedy are tooltips. Example is what > I have here on the mode line: >=20 > -:**- >=20 > So that is where the misunderstoods start, with -:**- so that looks > like Chinese to me, even though I know what it means as experienced > Emacs user. But from a view point of empowering a user, I have no clue > how is that empowering me. >=20 > If I move the mouse point there to the first - I can see following > words inside of a tooltip: >=20 > Buffer coding system (multi-byte): undecided-unix > Mouse-1: describe coding system > Mouse-3: set coding system +1 for finding the tool-tip. And +1 to Emacs for providing it. > So it is a tip, it should tell me some indications, but words are too > hard for new users, one could ask himself what really applies to that > definition of "buffer": >=20 > * Overview of noun buffer Then you list 7 meanings of the English word "buffer", from some dictionary. Nope; not the best way to go. Menu bar `Help' > `Search Documentation' > `Emacs Terminology' tells you: Buffer The buffer is the basic editing unit; one buffer corresponds to one text being edited. You normally have several buffers, but at any time you are editing only one, the current buffer, though several can be visible when you are using multiple windows or frames (q.v.). Most buffers are visiting (q.v.) some file. *Note Buffers::. (It ends with a link to node `Buffers' in the manual.) But yes, Emacs should do more, to make its glossary more readily available. (And it maybe shouldn't use "q.v.".) `M-x report-emacs-bug' to suggest glossary changes. And thanks for taking an interest in Emacs help/doc. > So there are plenty of ways how new user can get misunderstoods. Do > not assume that such has a ready Wordnet dictionary to do > {M-x wordnut-search} like I do. They most probably don't have it. You shouldn't need any access to a dictionary here. What Emacs needs to do a better job of is advising you to "Ask Emacs", and telling you _how_ to "Ask Emacs". Looking up "buffer" in a dictionary is nowhere near as helpful as asking Emacs what _Emacs_ means by "buffer". At least it shouldn't be. Emacs should be the go-to place to ask about Emacs. At your fingertips, with a good help system. But a new user isn't very likely to know this. And a new user isn't very likely to know _how_ to ask Emacs what "buffer" means. And yet Emacs is ready, willing, and able to answer the question. > A tooltip in Emacs user interface should have the option to be > "caught" or examined, that it does not disappear, so that now user can > click on words such as "buffer" and find out the definition of it, > that user can understand what means "coding" in the context of buffer > coding system, that user can understand what means "multi-byte", and > what does it mean UNIX and what does it mean "undecided-unix", as if > user does not know that,=20 Agreed, direct bridges from short help/feedback to more complete help would be welcome additions. Emacs has good user help. But yes, there's room for improvement. > - Making Emacs friendlier will be easier with a built-in dictionary > that will describe any terminology in easy English Emacs has a glossary - see above. It could no doubt be improved. Suggestions welcome (`M-x report-emacs-bug'). > - all tooltips, all words, should be describable and definable by > clicking the mouse or choosing {M-x define-word} or similar > function. Just all. I am talking about easy English description of > Menus, it is analogous to {C-h k} to describe the menu, but in easy > way, without confusing the user more and more. Agreed, though some of that might be easier said than done. You can't click a mouseover tooltip, for example. But you can click a link in a *Help* window. In `help+.el' I define command `help-on-click/key', bound to `C-h RET' and `C-h mouse-1'. And library `menu-bar+.el' adds it to menu `Help' > `Describe' as item `This'. This command doesn't work for everything, but it's usable many places. It prompts you to click something, hit a key, or choose a menu item, and it tells you about the thing you click or the key/menu you choose. ,---- | help-on-click/key is an interactive Lisp function in =E2=80=98help+.el=E2= =80=99. |=20 | It is bound to C-h RET, f1 RET, help RET, menu-bar help-menu describe | help-on-click/key. |=20 | (help-on-click/key KEY) |=20 | Give help on a key/menu sequence or object clicked with the mouse. | The object can be any part of an Emacs window or a name appearing in a | buffer. You can do any of the following: |=20 | type a key sequence (e.g. `C-M-s') | choose a menu item (e.g. [menu-bar files open-file]) | click on a scroll bar | click on the mode line | click in the minibuffer | click on an Emacs-related name in a buffer: apropos is called | click anywhere else in a buffer: its modes are described |=20 | Help is generally provided using `describe-key' and the Emacs online | manual (via `Info-goto-emacs-key-command-node'). If no entry is found | in the index of the Emacs manual, then the manual is searched from the | beginning for literal occurrences of KEY. |=20 | If you click on a name in a buffer, then `apropos-documentation' and | `apropos' are used to find information on the name. These functions | are not used when you do something besides click on a name. |=20 | If you click elsewhere in a buffer other than the minibuffer, then | `describe-mode' is used to describe the buffer's current mode(s). `---- It's a start, but Emacs could offer more such help. `help+.el' has been around since 2007. ______ `help+.el': https://www.emacswiki.org/emacs/download/help%2b.el About Help+ libraries: https://www.emacswiki.org/emacs/HelpPlus