From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Sebastian Urban Newsgroups: gmane.emacs.bugs Subject: bug#37327: Simplifying access to built-in tutorial Date: Fri, 6 Sep 2019 19:39:13 +0200 Message-ID: <871696bc-745c-91d1-00cf-9e97291b6ae8@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="58920"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mozilla/5.0 (Windows NT 6.1; rv:60.0) Gecko/20100101 Thunderbird/60.8.0 To: 37327@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Sep 06 19:40:16 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1i6IDV-000FAw-96 for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Sep 2019 19:40:13 +0200 Original-Received: from localhost ([::1]:59000 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i6IDU-0001tA-2n for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Sep 2019 13:40:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48760) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i6IDM-0001rG-25 for bug-gnu-emacs@gnu.org; Fri, 06 Sep 2019 13:40:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i6IDK-00083n-VL for bug-gnu-emacs@gnu.org; Fri, 06 Sep 2019 13:40:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:56743) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1i6IDK-00083e-RT for bug-gnu-emacs@gnu.org; Fri, 06 Sep 2019 13:40:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1i6IDK-0007HH-L9 for bug-gnu-emacs@gnu.org; Fri, 06 Sep 2019 13:40:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Sebastian Urban Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 06 Sep 2019 17:40:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 37327 X-GNU-PR-Package: emacs X-Debbugs-Original-To: Bug GNU Emacs Original-Received: via spool by submit@debbugs.gnu.org id=B.156779156327909 (code B ref -1); Fri, 06 Sep 2019 17:40:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 6 Sep 2019 17:39:23 +0000 Original-Received: from localhost ([127.0.0.1]:37331 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i6ICh-0007G5-Bi for submit@debbugs.gnu.org; Fri, 06 Sep 2019 13:39:23 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:39486) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i6ICg-0007Fy-B6 for submit@debbugs.gnu.org; Fri, 06 Sep 2019 13:39:22 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48598) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i6ICf-0001Q1-6s for bug-gnu-emacs@gnu.org; Fri, 06 Sep 2019 13:39:22 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i6ICe-0007m5-5c for bug-gnu-emacs@gnu.org; Fri, 06 Sep 2019 13:39:21 -0400 Original-Received: from mail-wm1-x331.google.com ([2a00:1450:4864:20::331]:36163) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1i6ICd-0007lG-93 for bug-gnu-emacs@gnu.org; Fri, 06 Sep 2019 13:39:20 -0400 Original-Received: by mail-wm1-x331.google.com with SMTP id p13so8016970wmh.1 for ; Fri, 06 Sep 2019 10:39:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:subject:to:message-id:date:user-agent:mime-version :content-language:content-transfer-encoding; bh=ijPo440yvxG3TXbyrG6hwdspSnAYUWwcHXnvqJ9GNgM=; b=PX0YMV6rvakAUvjw5auaIRCTi5y3CDgSLEGMbDGz3+Sqx7s+cRL+68CmUmtJ7jogkX LfUDyRLYLMhrHQE0NoJsrX5mb5f51gABnrjxpCpouJFJyBGM5XPXR82w8QSlNH90G/Uy PfzY/KDCLxWzjI/Ai9lfTNWJveV+/OxPTTgj4JKFg2CajviApxvG5XKAXzeLkgc98Ebh vkKBfoFew7MqXzlI+1TnaCI7rIuHn0VxnjjndgRBo67JQM1xmCGBwVZoxYBDANuVVaKS g2UIOXDMtUxmmIVRz5cTrnoVuxMoELfGvxwY5hqnJVj27BdXaR1crvK0SdVqaO78eXF3 Wg6w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:subject:to:message-id:date:user-agent :mime-version:content-language:content-transfer-encoding; bh=ijPo440yvxG3TXbyrG6hwdspSnAYUWwcHXnvqJ9GNgM=; b=cbbdIsTkVALY7h0LSTlnpW5fefS7BrqNjVkx2vPEz6EmASkhFxx/59h4v7ZnudXvH+ xoD5odDM+1j6FxOViczH6xTdPbEoAa/MRFvTxFLyWujBveiNUBB88kWXRT7yVNEsB0vD 2qm734gaLVg6DI/0z4VB0Dd29Ed0ARcb4NvD2rj1ewH6jTuQtzxYs1LjuZLR0mYNby9q 4r6RGE7Ua+2jrmBB80Um70y0+gb7Obr7HKZuFz3IkwXhPmoap/awSp8Zan1tER6Tr/to MNYTqzz0TudSx+42iSFKUAvCZCjoSoPecoJ0g1RAKMRSCVtuWZ/lykuLmFspzs+eQp3B AJKw== X-Gm-Message-State: APjAAAVrHwKKeZvWYp+i8FFRsb7KNZ31Gcc7jtngphiv2mFLjkoo+JYW a/oRJHmV/XugyP9KrqGLo1DycGc/ X-Google-Smtp-Source: APXvYqxqMuHZSC4wgjVQc74AG+M0MWzDT2Wo8KGKwsryi8g6xTqIsCqTKgp4U/nT5MGzYtjYA7Cn8Q== X-Received: by 2002:a05:600c:2056:: with SMTP id p22mr7590127wmg.159.1567791557712; Fri, 06 Sep 2019 10:39:17 -0700 (PDT) Original-Received: from ?IPv6:2a00:f41:1c74:5201:35a8:ac6e:7139:5105? ([2a00:f41:1c74:5201:35a8:ac6e:7139:5105]) by smtp.gmail.com with ESMTPSA id m62sm9749042wmm.35.2019.09.06.10.39.16 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 06 Sep 2019 10:39:17 -0700 (PDT) Content-Language: en-GB X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:166254 Archived-At: Hello, I would like to present an idea of simplifying tutorial access, which is described below. 1. Change 'help-with-tutorial' to act like 'help-with-tutorial-spec-language' by default. 2. Remove 'help-with-tutorial-spec-language'. 3. Change "Emacs Tutorial" in "Help" menu to "Emacs Tutorial...". - The "(choose language)" part won't be needed, because there will be no other tutorial entry, so even unsure people will have to choose "Emacs Tutorial..." (dots because of additional choice in the next step, convention?). 4. Remove "Emacs Tutorial (choose language)..." from "Help" menu. 5. Remove key binding to Tutorial, i.e. 'C-h t', as it won't be needed. - In the "Emacs manual" (Preface) there is "To run the tutorial, start Emacs and type C-h t." The problem is people may not know what 'C-h t' means, it's explained later in point "1.2 The Echo Area". So it will be easier to tell them to go to menu bar, which is by default in both GUI and TUI Emacs, and click "Help" and then "Emacs Tutorial...", which is why key binding is not needed any more. Of course this sentence will change to something like: "To run the tutorial, start Emacs and click `Help' in Menu Bar, then `Emacs Tutorial...' and choose language." 6. Update "Emacs manual" in like 3 places (search for "tutorial"). 7. Optionally list of languages could use native languages names instead of English names, e.g. "Deutsch" or "Deutsch (German)" or "Deutsch (GER)" instead of "German". - Unfortunately I'm not sure how well it would work with e.g. Chinese characters (slower loading time, because of the fonts). Also I don't know whether these names are defined in Emacs or are they read from the file name. If the former - redefine, if the latter - alias, i.e. Deutsch would point to file German? In the end access will be more streamlined. If someone wants tutorial in his native or different language - it doesn't matter. The path is the same - no additional code (and menu entries), no guessing language environment, etc. As a bonus, one more free key to bind to something useful, will be available. S. U. GNU Emacs 26.2 (build 1, i686-w64-mingw32) of 2019-04-13