unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Chong Yidong <cyd@gnu.org>
To: Michael Witten <mfwitten@gmail.com>
Cc: 11689@debbugs.gnu.org
Subject: bug#11689: [PATCH 00/14] Copyediting: etc/tutorials/TUTORIAL
Date: Sat, 07 Jul 2012 18:40:25 +0800	[thread overview]
Message-ID: <877gufetwm.fsf@gnu.org> (raw)
In-Reply-To: <1c1914fbe9e641219e6fff6d7fe92428-mfwitten@gmail.com> (Michael Witten's message of "Wed, 13 Jun 2012 00:00:54 -0000")

> Whilst reading through the TUTORIAL, I made a few minor modifications.
> The following is a summary of the resulting patch series

Thanks.  I've committed these changes, with some exceptions:

> +the scroll bar; one often drags the scroll bar's handle, a rectangular
> +region that is within the scroll bar and that is used to represent the
> +portion of the text that is currently visible in the associated window.

I don't see the point of teaching people how to use scroll bars in the
Emacs tutorial, and anyway this is wrong for non-toolkit X builds.

> +(Note that "scrolling the text up and down" is commonly described as
> +"scrolling the screen (or window) down and up". In particular, note
> +the way in which the two descriptions use direction; scrolling may
> +be interpreted as either moving the text with respect to the user's
> +view, or moving the user's view with respect to the text.)

I'd rather not get into this in the tutorial, where the
scroll-up/scroll-down command names are not mentioned.

> -You can undo deletion of text just as you can undo killing of text.
> -The distinction between killing something and deleting it affects
> -whether you can yank it with C-y; it makes no difference for undo.
> +You can undo the removal of text regardless of whether the text was
> +yanked or killed; there is no distinction as far as undoing is
> +concerned.

This change is gratuitous, since it's more or less the same length.

> -You should save fairly often, so that you will not lose very much
> -work if the system should crash (see the section "Auto Save" below).
> +You should save fairly often, so that you do not lose very much
> +work if the system crashes (see the section "Auto Save" below).

I simply removed this, since the Emacs tutorial is not the place to
dispense this kind of general advice.

> Under TeX and Texinfo, `---' is actually what is meant to be an
> em dash, so that would be a better choice than `--', and is thus
> used to replace `--' a few times.

This is gratuitous--since this is a text file, not TeX or Texinfo, the
meaning should be fairly obvious.

Thanks for the copyedits.





      parent reply	other threads:[~2012-07-07 10:40 UTC|newest]

Thread overview: 16+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-06-13  0:00 bug#11689: [PATCH 00/14] Copyediting: etc/tutorials/TUTORIAL Michael Witten
2012-06-13  0:05 ` bug#11689: [PATCH 01/14] etc/tutorials/TUTORIAL: Remove text saying `C-x 1' is first 2-char command Michael Witten
2012-06-13  0:06 ` bug#11689: [PATCH 02/14] etc/tutorials/TUTORIAL: Describe the act of scrolling text more consistently Michael Witten
2012-06-13  0:06 ` bug#11689: [PATCH 03/14] etc/tutorials/TUTORIAL: Remove redundant comparison of killing and deleting Michael Witten
2012-06-13  0:07 ` bug#11689: [PATCH 04/14] etc/tutorials/TUTORIAL: Eradicate the future tense Michael Witten
2012-06-13  0:07 ` bug#11689: [PATCH 05/14] etc/tutorials/TUTORIAL: Minor rewording to streamline and generalize `C-x s' intro Michael Witten
2012-06-13  0:08 ` bug#11689: [PATCH 06/14] etc/tutorials/TUTORIAL: Use `application' consistently by replacing an occurence of `program' Michael Witten
2012-06-13  0:08 ` bug#11689: [PATCH 07/14] etc/tutorials/TUTORIAL: Generalize the description of when to use `C-x C-c' Michael Witten
2012-06-13  0:08 ` bug#11689: [PATCH 08/14] etc/tutorials/TUTORIAL: Remove the word `globally' Michael Witten
2012-06-13  0:08 ` bug#11689: [PATCH 09/14] etc/tutorials/TUTORIAL: Replace occurences of `--' with more appropriate text Michael Witten
2012-06-13  0:15 ` bug#11689: [PATCH 10/14] etc/tutorials/TUTORIAL: c-h-a-n-g-e-d -> "changed" Michael Witten
2012-06-13  0:17 ` bug#11689: [PATCH 11/14] etc/tutorials/TUTORIAL: Complete instructions by telling the user to move the cursor Michael Witten
2012-06-13  0:18 ` bug#11689: [PATCH 12/14] etc/tutorials/TUTORIAL: Make consistent the white space around `>>' instructions Michael Witten
2012-06-13  0:18 ` bug#11689: [PATCH 13/14] etc/tutorials/TUTORIAL: Place `C-x C-f' beside `find-file' for clarity Michael Witten
2012-06-13  0:19 ` bug#11689: [PATCH 14/14] etc/ChangeLog: Note my patch series for etc/tutorials/TUTORIAL Michael Witten
2012-07-07 10:40 ` Chong Yidong [this message]

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

  List information: https://www.gnu.org/software/emacs/

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

  git send-email \
    --in-reply-to=877gufetwm.fsf@gnu.org \
    --to=cyd@gnu.org \
    --cc=11689@debbugs.gnu.org \
    --cc=mfwitten@gmail.com \
    /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 public inbox

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

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).