From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?utf-8?B?R8O2a3R1xJ8=?= Kayaalp Newsgroups: gmane.emacs.devel Subject: Re: Interactive guide for new users Date: Sat, 12 Sep 2020 14:02:29 +0300 Message-ID: <87blibtfzu.fsf@gkayaalp.com> References: <875z8ortot.fsf@gkayaalp.com> <83lfhjkq0r.fsf@gnu.org> <8620B5CD-CA92-46BF-80A8-DBE7052F4CA6@gmail.com> <83d02re2uk.fsf@gnu.org> 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="28347"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: mu4e 1.2.0; emacs 28.0.50 Cc: Gregory Heytings , casouri@gmail.com To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Sep 12 13:03:15 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 1kH3JH-00075w-6B for ged-emacs-devel@m.gmane-mx.org; Sat, 12 Sep 2020 13:03:11 +0200 Original-Received: from localhost ([::1]:56100 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kH3JG-0003EB-9S for ged-emacs-devel@m.gmane-mx.org; Sat, 12 Sep 2020 07:03:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46438) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kH3Io-0002ok-RX for emacs-devel@gnu.org; Sat, 12 Sep 2020 07:02:42 -0400 Original-Received: from relay3-d.mail.gandi.net ([217.70.183.195]:57597) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kH3Im-0004C8-K8 for emacs-devel@gnu.org; Sat, 12 Sep 2020 07:02:42 -0400 X-Originating-IP: 149.0.50.61 Original-Received: from localhost (unknown [149.0.50.61]) (Authenticated sender: self@gkayaalp.com) by relay3-d.mail.gandi.net (Postfix) with ESMTPSA id DB0D360003; Sat, 12 Sep 2020 11:02:30 +0000 (UTC) In-reply-to: <83d02re2uk.fsf@gnu.org> Received-SPF: none client-ip=217.70.183.195; envelope-from=self@gkayaalp.com; helo=relay3-d.mail.gandi.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/09/12 07:02:37 X-ACL-Warn: Detected OS = Linux 3.11 and newer [fuzzy] X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_NONE=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:255297 Archived-At: On 2020-09-12 12:55 +03, Eli Zaretskii wrote: > What is the definition of "the first time"? where will we keep the > indication that this is/isn't "the first time"? Also, will this > affect "emacs -Q" or "emacs -q"? Potential solution could be to only show this if Emacs is run without any command line arguments, and only if the empty file =E2=80=98~/.config/emacs-28-interactive-guide-ran=E2=80=99 (or something si= milar, of course) exists and no .emacs or init.el exists. It not being in an ephemeral location means the user may make sure to keep the file there so that even if they don=E2=80=99t have a .emacs, they may avoid this thing popping up every time they run Emacs. It may be useful to also provide an environment variable which wen set to t inhibits this without needing a file, e.g. EMACS_INHIBIT_INTERACTIVE_TUTORIAL. >> SCREEN 2: "Set the color theme", with a clickable list containing the >> (currently) 16 built-in themes. A short code snippet above that list >> illustrates how code is displayed with each of these themes. > The snippet will only be able to show the buffer text appearance. For > other UI elements you will need an image. Would using an image be > better here? This probably wouldn=E2=80=99t work on terminal Emacs. For a more univarsa= lly apllicable, you could have a single snippet, and picking a theme just sets it globally. A confirm button at bottom saves the preference using customize and advances. >> SCREEN 8: Thank you. Your choices have been saved in Emacs' configuration >> file ~/.emacs.d/init.el (or ~/.emacs ?). > What do we do here wrt XDG preferences? Might be a good idea to default to XDG dirs if that=E2=80=99s what Emacs community wants to encourage. But because a lot of text out there will say ~/.emacs or ~/.emacs.d/init.el, the file name should be made very clear. >> You can use M-x initial-greeting at any time to go through this >> configuration again. > That command should be on the Help menu. And I think the name should > be 'introduction-to-emacs' or somesuch. AFAIU it=E2=80=99s customary in the industry these days to call these walkthrough wizards "Guided Tours". That might be a more recognisable name. =E2=80=98initial-greeting=E2=80=99 and =E2=80=98introduction-to-emac= s=E2=80=99 sound rather non-interactive to me, i.e. I=E2=80=99d expect to be reading stuff, deducing from the names. -- =C4=B0. G=C3=B6ktu=C4=9F Kayaalp / @cadadr / pgp: 024C 30DD 597D 142B 49AC 40EB 465C D949 B101 2427