GNU bug report logs - #20371
25.0.50; Tutorial first page: tell users how to quit the tutorial

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 20371 in the body.
You can then email your comments to 20371 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.0.50; Tutorial first page: tell users how to quit the tutorial
Date: Sun, 19 Apr 2015 11:10:15 -0700 (PDT)

The top of the tutorial tells you how to quit Emacs.  That's good.
Perhaps it should also tell you how to quit the tutorial and return to
your previous buffer.

See this SO question, for an expression of one confused user's
frustration.  S?he "accidentally" fell into the tutorial and was worried
about how to get back to the original buffer.
http://stackoverflow.com/q/29727620/729907



In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2014-10-20 on LEG570
Bzr revision: 118168 rgm <at> gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'

Message #8 received at 20371 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 20371 <at> debbugs.gnu.org
Subject: Re: bug#20371: 25.0.50;
 Tutorial first page: tell users how to quit the tutorial
Date: Sat, 30 Apr 2016 20:25:42 +0200

Drew Adams <drew.adams <at> oracle.com> writes:

> The top of the tutorial tells you how to quit Emacs.  That's good.
> Perhaps it should also tell you how to quit the tutorial and return to
> your previous buffer.

So how do you do that, then?  :-)

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Message #11 received at 20371 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 20371 <at> debbugs.gnu.org
Subject: RE: bug#20371: 25.0.50; Tutorial first page: tell users how to quit
 the tutorial
Date: Sat, 30 Apr 2016 10:30:48 -0800 (GMT-08:00)

> > The top of the tutorial tells you how to quit Emacs.  That's good.
> > Perhaps it should also tell you how to quit the tutorial and return to
> > your previous buffer.
> 
> So how do you do that, then?  :-)

Dunno.  I'm no expert on the tutorial.

But after this is fixed both you and I can reuse the
tutorial to learn how. ;-)

Message #14 received at 20371 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 20371 <at> debbugs.gnu.org
Subject: Re: bug#20371: 25.0.50;
 Tutorial first page: tell users how to quit the tutorial
Date: Sat, 30 Apr 2016 20:35:42 +0200

Drew Adams <drew.adams <at> oracle.com> writes:

> But after this is fixed both you and I can reuse the
> tutorial to learn how. ;-)

:-)

I've never used the tutorial before, I think.  I see that it's on
fundamental-mode?  If I just kill-buffer the buffer, it asks whether I
want to save my position?  So perhaps that's the right answer...

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Message #17 received at 20371 <at> debbugs.gnu.org (full text, mbox):

From: npostavs <at> users.sourceforge.net
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 20371 <at> debbugs.gnu.org, Drew Adams <drew.adams <at> oracle.com>
Subject: Re: bug#20371: 25.0.50;
 Tutorial first page: tell users how to quit the tutorial
Date: Sun, 03 Jul 2016 11:06:15 -0400

Lars Ingebrigtsen <larsi <at> gnus.org> writes:
>
> If I just kill-buffer the buffer, it asks whether I
> want to save my position?  So perhaps that's the right answer...

Seems like.  I can add to TUTORIAL, but there are a bunch of
translations that I wouldn't know how to edit...

diff --git c/etc/tutorials/TUTORIAL i/etc/tutorials/TUTORIAL
index ee328e8..31d0f42 100644
--- c/etc/tutorials/TUTORIAL
+++ i/etc/tutorials/TUTORIAL
@@ -13,4 +13,5 @@ write that in full each time, we'll use the following abbreviations:
 Important note: to end the Emacs session, type C-x C-c.  (Two characters.)
 To quit a partially entered command, type C-g.
+To stop the tutorial, type C-x k, then <Return> at the prompt.
 The characters ">>" at the left margin indicate directions for you to
 try using a command.  For instance:

Message #20 received at 20371 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: npostavs <at> users.sourceforge.net
Cc: Lars Ingebrigtsen <larsi <at> gnus.org>, 20371 <at> debbugs.gnu.org
Subject: Re: bug#20371: 25.0.50;
 Tutorial first page: tell users how to quit the tutorial
Date: Mon, 04 Jul 2016 12:39:05 -0400

npostavs <at> users.sourceforge.net wrote:

> Seems like.  I can add to TUTORIAL, but there are a bunch of
> translations that I wouldn't know how to edit...

You don't need to worry about the translations.
In theory they are updated before each release (per admin/release-process).
In practice people just update them on a best-effort basis whenever.
It should not be a factor in whether you change the English version or not.

Message #23 received at 20371 <at> debbugs.gnu.org (full text, mbox):

From: npostavs <at> users.sourceforge.net
To: Glenn Morris <rgm <at> gnu.org>
Cc: 20371 <at> debbugs.gnu.org, Lars Ingebrigtsen <larsi <at> gnus.org>
Subject: Re: bug#20371: 25.0.50;
 Tutorial first page: tell users how to quit the tutorial
Date: Thu, 01 Jun 2017 22:56:33 -0400

tags 20371 fixed
close 20371 26.1
quit

Glenn Morris <rgm <at> gnu.org> writes:

> npostavs <at> users.sourceforge.net wrote:
>
>> Seems like.  I can add to TUTORIAL, but there are a bunch of
>> translations that I wouldn't know how to edit...
>
> You don't need to worry about the translations.
> In theory they are updated before each release (per admin/release-process).
> In practice people just update them on a best-effort basis whenever.
> It should not be a factor in whether you change the English version or not.

Kinda forgot about this, pushed now [1: 6efa25d7b5].

[1: 6efa25d7b5]: 2017-06-01 22:55:46 -0400
  * etc/tutorials/TUTORIAL: Explain how to stop the tutorial (Bug#20371).
  http://git.savannah.gnu.org/cgit/emacs.git/commit/?id=6efa25d7b503a03c511d0ec75b47297c0efed3fa

Message #30 received at 20371 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: npostavs <at> users.sourceforge.net
Cc: rgm <at> gnu.org, 20371 <at> debbugs.gnu.org, larsi <at> gnus.org
Subject: Re: bug#20371: 25.0.50;
 Tutorial first page: tell users how to quit the tutorial
Date: Fri, 02 Jun 2017 09:29:10 +0300

> From: npostavs <at> users.sourceforge.net
> Date: Thu, 01 Jun 2017 22:56:33 -0400
> Cc: 20371 <at> debbugs.gnu.org, Lars Ingebrigtsen <larsi <at> gnus.org>
> 
> Kinda forgot about this, pushed now [1: 6efa25d7b5].
> 
> [1: 6efa25d7b5]: 2017-06-01 22:55:46 -0400
>   * etc/tutorials/TUTORIAL: Explain how to stop the tutorial (Bug#20371).
>   http://git.savannah.gnu.org/cgit/emacs.git/commit/?id=6efa25d7b503a03c511d0ec75b47297c0efed3fa

On my system, there's one more question after you press RET, and this
addition doesn't describe it.  Should it?

Message #33 received at 20371 <at> debbugs.gnu.org (full text, mbox):

From: npostavs <at> users.sourceforge.net
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: rgm <at> gnu.org, 20371 <at> debbugs.gnu.org, larsi <at> gnus.org
Subject: Re: bug#20371: 25.0.50;
 Tutorial first page: tell users how to quit the tutorial
Date: Fri, 02 Jun 2017 08:13:51 -0400

Eli Zaretskii <eliz <at> gnu.org> writes:

> On my system, there's one more question after you press RET, and this
> addition doesn't describe it.  Should it?

You mean this one:

    Save your position in the tutorial? (y or n)

I thought that prompt was fairly self-explanatory, furthermore if you
press something other than y or n it additionally says "Please answer y
or n".

Message #36 received at 20371 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: npostavs <at> users.sourceforge.net
Cc: rgm <at> gnu.org, 20371 <at> debbugs.gnu.org, larsi <at> gnus.org
Subject: Re: bug#20371: 25.0.50;
 Tutorial first page: tell users how to quit the tutorial
Date: Fri, 02 Jun 2017 15:21:05 +0300

> From: npostavs <at> users.sourceforge.net
> Cc: 20371 <at> debbugs.gnu.org,  rgm <at> gnu.org,  larsi <at> gnus.org
> Date: Fri, 02 Jun 2017 08:13:51 -0400
> 
> > On my system, there's one more question after you press RET, and this
> > addition doesn't describe it.  Should it?
> 
> You mean this one:
> 
>     Save your position in the tutorial? (y or n)
> 
> I thought that prompt was fairly self-explanatory, furthermore if you
> press something other than y or n it additionally says "Please answer y
> or n".

OK, thanks.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.