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

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

[Drew Adams]

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@gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'

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

[Lars Ingebrigtsen]

Drew Adams <drew.adams@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

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

[Drew Adams]

> > 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. ;-)

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

[Lars Ingebrigtsen]

Drew Adams <drew.adams@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

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

[npostavs]

Lars Ingebrigtsen <larsi@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:

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

[Glenn Morris]

npostavs@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.

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

[npostavs]

tags 20371 fixed
close 20371 26.1
quit

Glenn Morris <rgm@gnu.org> writes:

> npostavs@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

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

[Eli Zaretskii]

> From: npostavs@users.sourceforge.net
> Date: Thu, 01 Jun 2017 22:56:33 -0400
> Cc: 20371@debbugs.gnu.org, Lars Ingebrigtsen <larsi@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?

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

[npostavs]

Eli Zaretskii <eliz@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".

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

[Eli Zaretskii]

> From: npostavs@users.sourceforge.net
> Cc: 20371@debbugs.gnu.org,  rgm@gnu.org,  larsi@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.