all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: karl@freefriends.org (Karl Berry)
To: emacs-devel@gnu.org
Cc: daniel@brockman.se
Subject: guided tour suggestions
Date: Thu, 3 May 2007 13:03:34 -0500	[thread overview]
Message-ID: <200705031803.l43I3Yd29129@f7.net> (raw)

We received this report on webmasters (thanks Daniel) ...


From: daniel@brockman.se

I am reading the newly-installed Emacs guided tour[1] and
taking notes as I go along.

First, this seems wrong (it's the other way around):

    C-v  Previous screen        M-v  Next screen

Second, this seems like an overstatement (Perl has quite a
lot of regexp constructs):

    Emacs regexps support a superset of Perl's regexp constructs.

As just one example, Emacs doesn't support negative lookahead.

Third, here,

    M-x calc    An RPN calculator.

maybe it is better to mention `M-x calculator' instead?

Fourth, here,

    C-x (          Start recording macro
    C-x )          Stop recording macro
    C-x e          Play back macro once
    C-x e e e...   Play back macro multiple times

maybe add this item:

    M-0 C-x e      Play back macro over and over until it fails

Fifth, this

    M-x shell      New shell buffer
    C-u M-x shell  New shell buffer with specified name

should probably look like this:

    M-x shell      Switch to shell buffer
    C-u M-x shell  Make new shell buffer

Sixth, this also seems like an overstatement:

   Emacs ships with a major mode for pretty much every
   widely used programming language (and then some).

Perhaps say it like this instead:

   Emacs ships with major modes for many widely used
   programming languages, markup languages, configuration
   file formats, etc.  In almost all cases, major modes for
   unsupported formats are available as extension packages.
   (Take a look at <a href="http://www.emacswiki.org/">EmacsWiki</a>.)

-- 
Daniel Brockman <daniel@brockman.se>

[1]  http://www.gnu.org/software/emacs/tour/

             reply	other threads:[~2007-05-03 18:03 UTC|newest]

Thread overview: 32+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2007-05-03 18:03 Karl Berry [this message]
2007-05-03 20:34 ` guided tour suggestions Phil Sung
2007-06-02 20:52   ` Chong Yidong
2007-06-02 21:04     ` David Kastrup
2007-06-02 22:08     ` Drew Adams
2007-06-03  8:23       ` Mathias Dahl
2007-06-03 15:32       ` David House
2007-06-11 20:01     ` Phil Sung
2007-06-11 20:19       ` Drew Adams
2007-06-27  1:16         ` Phil Sung
2007-06-27  4:28           ` Drew Adams
2007-06-27  5:45           ` David Kastrup
2007-06-27  6:04             ` Nick Roberts
2007-06-27  7:37               ` David Kastrup
2007-06-28  7:02             ` Phil Sung
2007-06-28  7:20               ` David Kastrup
2007-06-28  9:54                 ` David House
2007-06-28 10:25                   ` David Kastrup
2007-08-09  7:15                 ` Phil Sung
2007-08-09  7:36                   ` David Kastrup
2007-08-13  8:09                     ` Phil Sung
2007-06-28  8:20               ` Nick Roberts
2007-06-28  8:36                 ` David Kastrup
2007-06-29 16:41               ` Juri Linkov
2007-06-30  1:16               ` Nick Roberts
2007-06-30 10:03                 ` David House
2007-07-22 10:59                   ` Dieter Wilhelm
2007-05-03 22:30 ` David Koppelman
2007-05-03 22:41   ` Daniel Brockman
2007-05-04  5:09 ` Dieter Wilhelm
2007-05-04  7:32   ` Eli Zaretskii
2007-05-05 14:39 ` Randal L. Schwartz

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=200705031803.l43I3Yd29129@f7.net \
    --to=karl@freefriends.org \
    --cc=daniel@brockman.se \
    --cc=emacs-devel@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.