all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Jorge P. de Morais Neto <jorge+list@disroot.org>
To: Stefan Kangas <stefan@marxist.se>
Cc: 39359@debbugs.gnu.org
Subject: bug#39359: [patch] TUTORIAL: Be accurate about "buffer" vs "file"; capitalize Dired. Four other trivial TUTORIAL patches
Date: Sun, 07 Jun 2020 13:20:46 -0300	[thread overview]
Message-ID: <878sgyx2xt.fsf@disroot.org> (raw)
In-Reply-To: <877dy5tcs4.fsf@stefankangas.se>

Em [2020-04-24 sex 12:10:19+0200], Stefan Kangas escreveu:

> Could you please send a new patch including these changes?  I had a
> look at your first message but found it hard to ascertain what it is
> exactly that you're proposing.

I did not understand what is difficult to understand about my first
message.  It has five patches, each surrounded by the output of
~message-mark-inserted-region~ and preceded by a tentative commit
message.  I also did not understand what you asked above.  Maybe my
English comprehension has failed me (I am Brazilian).

Anyway, here is the revised first patch, preceded by a tentative commit
message -- is this what you asked for?:

TUTORIAL: "buffer" vs "file" consistency; capitalize Dired

- For consistency with C-x C-f ("Find file") and C-x C-s ("Save file"),
  refer to C-x s as "Save some files".
- Capitalize "Dired".
--8<---------------cut here---------------start------------->8---
diff --git a/etc/tutorials/TUTORIAL b/etc/tutorials/TUTORIAL
index eb3acde9c0..4465e32e81 100644
--- a/etc/tutorials/TUTORIAL
+++ b/etc/tutorials/TUTORIAL
@@ -612,11 +612,11 @@ but it also means that you need a convenient way to save the first
 file's buffer.  Having to switch back to that buffer, in order to save
 it with C-x C-s, would be a nuisance.  So we have
 
-	C-x s     Save some buffers
+	C-x s     Save some files
 
-C-x s asks you about each buffer which contains changes that you have
-not saved.  It asks you, for each such buffer, whether to save the
-buffer.
+C-x s asks you about each file-visiting buffer which contains changes
+that you have not saved.  It asks you, for each such buffer, whether
+to save the buffer.
 
 >> Insert a line of text, then type C-x s.
    It should ask you whether to save the buffer named TUTORIAL.
@@ -661,7 +661,7 @@ There are many C-x commands.  Here is a list of the ones you have learned:
 
 	C-x C-f		Find file
 	C-x C-s		Save file
-	C-x s		Save some buffers
+	C-x s		Save some files
 	C-x C-b		List buffers
 	C-x b		Switch buffer
 	C-x C-c		Quit Emacs
@@ -1081,7 +1081,7 @@ corresponding command names (such as C-x C-f beside find-file).
 You can learn more about Emacs by reading its manual, either as a
 printed book, or inside Emacs (use the Help menu or type C-h r).
 Two features that you may like especially are completion, which saves
-typing, and dired, which simplifies file handling.
+typing, and Dired, which simplifies file handling.
 
 Completion is a way to avoid unnecessary typing.  For instance, if you
 want to switch to the *Messages* buffer, you can type C-x b *M<Tab>
--8<---------------cut here---------------end--------------->8---

Best regards,
  Jorge

-- 
- <https://jorgemorais.gitlab.io/justice-for-rms/>
- I am Brazilian.  I hope my English is correct and I welcome feedback.
- <https://www.defectivebydesign.org/>
- <https://www.gnu.org/>





  reply	other threads:[~2020-06-07 16:20 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-01-30 15:41 bug#39359: [patch] TUTORIAL: Be accurate about "buffer" vs "file"; capitalize Dired. Four other trivial TUTORIAL patches Jorge
2020-01-31  9:29 ` Eli Zaretskii
2020-01-31 13:28 ` Jorge
2020-02-29  5:02   ` Stefan Kangas
2020-03-03 11:30     ` Jorge P. de Morais Neto
2020-04-24 10:10       ` Stefan Kangas
2020-06-07 16:20         ` Jorge P. de Morais Neto [this message]
2020-06-07 16:40           ` Eli Zaretskii
2020-06-07 18:01             ` Jorge P. de Morais Neto
2020-06-07 18:06               ` Eli Zaretskii
2020-06-07 18:24                 ` Jorge P. de Morais Neto
2020-08-09 11:47                   ` Lars Ingebrigtsen

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=878sgyx2xt.fsf@disroot.org \
    --to=jorge+list@disroot.org \
    --cc=39359@debbugs.gnu.org \
    --cc=stefan@marxist.se \
    /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.