From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: jargon translation up-front in doc (was: Menu suggestion) Date: Mon, 26 Apr 2004 09:36:55 -0700 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <2719-Mon26Apr2004123559+0300-eliz@gnu.org> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1082998453 30969 80.91.224.253 (26 Apr 2004 16:54:13 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 26 Apr 2004 16:54:13 +0000 (UTC) Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Mon Apr 26 18:54:03 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1BI9Mp-0002Xo-00 for ; Mon, 26 Apr 2004 18:54:03 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BI9Md-0004XM-00 for ; Mon, 26 Apr 2004 18:54:03 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.30) id 1BI9HA-0006VO-Lu for emacs-devel@quimby.gnus.org; Mon, 26 Apr 2004 12:48:12 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1BI9E4-00064Q-2l for emacs-devel@gnu.org; Mon, 26 Apr 2004 12:45:00 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1BI98S-0004oH-Li for emacs-devel@gnu.org; Mon, 26 Apr 2004 12:39:44 -0400 Original-Received: from [148.87.2.201] (helo=inet-mail1.oracle.com) by monty-python.gnu.org with esmtp (TLSv1:DES-CBC3-SHA:168) (Exim 4.30) id 1BI96P-0003pF-H7 for emacs-devel@gnu.org; Mon, 26 Apr 2004 12:37:05 -0400 Original-Received: from inet-mail1.oracle.com (localhost [127.0.0.1]) by inet-mail1.oracle.com (Switch-3.1.4/Switch-3.1.0) with ESMTP id i3QGbx2U016758 for ; Mon, 26 Apr 2004 09:37:59 -0700 (PDT) Original-Received: from rgmgw2.us.oracle.com (rgmgw2.us.oracle.com [138.1.191.11]) by inet-mail1.oracle.com (Switch-3.1.4/Switch-3.1.0) with ESMTP id i3QGbuOm016644 for ; Mon, 26 Apr 2004 09:37:57 -0700 (PDT) Original-Received: from rgmgw2.us.oracle.com (localhost [127.0.0.1]) by rgmgw2.us.oracle.com (Switch-3.1.4/Switch-3.1.0) with ESMTP id i3QGaumJ026006 for ; Mon, 26 Apr 2004 10:36:56 -0600 Original-Received: from dradamslap (dradams-lap.us.oracle.com [130.35.177.126]) by rgmgw2.us.oracle.com (Switch-3.1.4/Switch-3.1.0) with SMTP id i3QGauSM025995 for ; Mon, 26 Apr 2004 10:36:56 -0600 Original-To: X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) Importance: Normal In-Reply-To: <2719-Mon26Apr2004123559+0300-eliz@gnu.org> X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1409 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:22184 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:22184 Apologies if the latest tutorial & Emacs manual already take care of this. Proposal - Add a *brief* jargon translation near the beginning of the tutorial and the Emacs manual, such as that at http://www.emacswiki.org/cgi-bin/wiki/EmacsNewbie, "Fundamental Concepts" > "Emacs-Speak (Jargon)". The 5-line table there can help newbies digest the systematic presentations of Emacs concepts that follow in the manual: Common Term Emacs Term ----------- ---------- selection region cut kill paste yank window frame shortcut key sequence The two columns don't present exact synonyms, but that can be detailed at the appropriate places. This would at least give new users a head start in understanding the doc (and doc strings). - Drew -----Original Message----- From: emacs-devel-bounces+drew.adams=oracle.com@gnu.org [mailto:emacs-devel-bounces+drew.adams=oracle.com@gnu.org]On Behalf Of Eli Zaretskii Sent: Monday, April 26, 2004 3:36 AM To: Kim F. Storm Cc: emacs-devel@gnu.org Subject: Re: Menu suggestion > From: storm@cua.dk (Kim F. Storm) > Date: 26 Apr 2004 11:56:24 +0200 > > When a new user is trying emacs for the first time, I bet that he > already knows about scrolling using arrow keys, home/end, pgup/pgdn, IIRC, once upon a time, I suggested to say in the tutorial, right at its beginning, that if the reader already knows how to move around, she could skip the first N sections. (We could even make those parts disappear, i.e. not be displayed, if the user doesn't want to read them.) I think Richard agreed, but requested that this be accompanied by an advice to read those sections anyway, since they teach Emacs bindings for cursor motion commands, which in our opinion are handier for fast typists than the arrow keys and their ilk. Given that some of the more boring sections of the tutorial are skipped, we could add to it a few new sections describing features that users generally want but cannot find and/or figure out easily. Unfortunately, I never had time to rework the tutorial along these lines. Perhaps someone would consider doing that now. Alternatively, some kind of ``guided tour'' thru Emacs for beginners (which could use the tutorial as the starting point), would IMHO be a very useful addition to Emacs. Such a document could overcome the greatest disadvantage of the tutorial: that it's a linear document that is quite large, so it's inconvenient to read it in parts. _______________________________________________ Emacs-devel mailing list Emacs-devel@gnu.org http://mail.gnu.org/mailman/listinfo/emacs-devel