From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: nljlistbox2@gmail.com (N. Jackson) Newsgroups: gmane.emacs.bugs Subject: bug#32047: 26.1; Misleading/confusing text about `C-k' in TUTORIAL Date: Tue, 03 Jul 2018 21:34:33 -0400 Message-ID: <87o9fn2386.fsf@moondust.localdomain> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1530667997 1227 195.159.176.226 (4 Jul 2018 01:33:17 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 4 Jul 2018 01:33:17 +0000 (UTC) To: 32047@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jul 04 03:33:13 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1faWfN-0000A1-Vu for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Jul 2018 03:33:10 +0200 Original-Received: from localhost ([::1]:43508 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1faWhT-0005FI-Gb for geb-bug-gnu-emacs@m.gmane.org; Tue, 03 Jul 2018 21:35:19 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60564) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1faWhH-0005DE-AE for bug-gnu-emacs@gnu.org; Tue, 03 Jul 2018 21:35:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1faWhC-0007KG-EA for bug-gnu-emacs@gnu.org; Tue, 03 Jul 2018 21:35:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:37846) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1faWhC-0007K5-B2 for bug-gnu-emacs@gnu.org; Tue, 03 Jul 2018 21:35:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1faWhC-0007vF-1t for bug-gnu-emacs@gnu.org; Tue, 03 Jul 2018 21:35:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: nljlistbox2@gmail.com (N. Jackson) Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 04 Jul 2018 01:35:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 32047 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.153066809230430 (code B ref -1); Wed, 04 Jul 2018 01:35:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 4 Jul 2018 01:34:52 +0000 Original-Received: from localhost ([127.0.0.1]:45743 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1faWh1-0007uf-Rn for submit@debbugs.gnu.org; Tue, 03 Jul 2018 21:34:52 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:41307) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1faWgy-0007uJ-4G for submit@debbugs.gnu.org; Tue, 03 Jul 2018 21:34:48 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1faWgr-0006vC-TS for submit@debbugs.gnu.org; Tue, 03 Jul 2018 21:34:42 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:50131) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1faWgr-0006ug-Pf for submit@debbugs.gnu.org; Tue, 03 Jul 2018 21:34:41 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60511) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1faWgq-00056L-Ff for bug-gnu-emacs@gnu.org; Tue, 03 Jul 2018 21:34:41 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1faWgl-0006pu-Iz for bug-gnu-emacs@gnu.org; Tue, 03 Jul 2018 21:34:40 -0400 Original-Received: from mail-qt0-x229.google.com ([2607:f8b0:400d:c0d::229]:45556) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1faWgl-0006pV-DT for bug-gnu-emacs@gnu.org; Tue, 03 Jul 2018 21:34:35 -0400 Original-Received: by mail-qt0-x229.google.com with SMTP id y5-v6so3307646qti.12 for ; Tue, 03 Jul 2018 18:34:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:mime-version; bh=4Vtgl+3NNx3tTmj01PmEXajIMIGlfy6q10DWhmSzvyo=; b=joXE1bB24KmlPxWpwurubnUNukfJBoYzXq4JnfG87y2RKVLkstP28zj3EAOJLewQ4t XiwalnCLpX/uryZ0aAxv7ovtY8lkEyFbTGrJahYzGCu3TDBwM5ZFwJom/MDuwvVYMepo smhqaCghyFENR2jWhAp1DF/+98UZMqPGK3CQShFLm7UiXyuhuQtC201D/A4pK6rjAuo2 zgcs6VLc4H4cb1De8ddX4WGPwM2g7pOpoUghIHQ2IBaIuJS3r0otAkgNgYjQ3jV2JM/T lki5F/IzsIxJpF9jCbI5UbU4C2cCz3Jwes7bymwxpwVIf6onMSpe1q+4Ko9lI4U2RNZD Kkjg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:mime-version; bh=4Vtgl+3NNx3tTmj01PmEXajIMIGlfy6q10DWhmSzvyo=; b=hKqYMzn75tLcYdEfOzP3IqMXIE9mmzuvsdelKuAcwakiGQGgxsMas7GycpW3d2WwX+ NBbZHgCMu2FmQPhHkW1RA7eoVAiwu8cAVRxFyO02r2lB6K8PKx8I+jNTMHmCW/xFkHiR IOK+g3ac3xWFVLkBGp056o0tCpgzoN/uyFWFZOzkt7GEJkhJgUKeRxNHiMKRdk/ZKVs6 CFJEmPJhLv/rCkbAgnti5vNo4Vevb4wBU8jS5mxPbQfb77M7IxuMq2ZMk4ap/MuBsXpN PrqaKiz8asgFwZVEIHeWDP3MWRnXkq/nvY8FiE9CcbVYRte1yUEQlk7IVipkYllF1wgW XY9Q== X-Gm-Message-State: APt69E2YV6HxXbYfgHNi7jyL1Z5uP2ICOBfFcH3/I1sWqlfmh/pWUucp mAvnsxs5LajmxMk+xAbt8JEuOg== X-Google-Smtp-Source: AAOMgpd6Mz75woyqdQ9iwvSO+1q2+w+uzCCTkGSqsIzuEvx6LYlMthY0YAA+coxi3B2IBi/3sGhOKQ== X-Received: by 2002:aed:36e7:: with SMTP id f94-v6mr39206qtb.276.1530668074434; Tue, 03 Jul 2018 18:34:34 -0700 (PDT) Original-Received: from moondust.localdomain.nodomain.none (toroon474qw-lp130-04-74-14-128-81.dsl.bell.ca. [74.14.128.81]) by smtp.gmail.com with ESMTPSA id t11-v6sm1925574qkt.28.2018.07.03.18.34.33 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 03 Jul 2018 18:34:33 -0700 (PDT) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:148164 Archived-At: At around Line 419 of the Emacs tutorial there are two statements which are not strictly correct, which might potentially cause confusion. 414 >> Move the cursor to the beginning of a line which is not empty. 415 Then type C-k to kill the text on that line. 416 >> Type C-k a second time. You'll see that it kills the Newline 417 which follows that line. 418 419 Note that a single C-k kills the contents of the line, and a second 420 C-k kills the line itself, and makes all the other lines move up. C-k 421 treats a numeric argument specially: it kills that many lines AND 422 their contents. This is not mere repetition. C-u 2 C-k kills two 423 lines and their Newlines; typing C-k twice would not do that. The example(s) given in Lines 414 to 417 are correct. But the sentence beginning on Line 419 is misleading. It is only true when point is at the beginning of the line. Likewise the sentence beginning in Line 420 and the sentence beginning in Line 422 ("C-u 2 C-k kills...") about using `C-k' with a numeric argument are misleading in the same way -- the writer is assuming that point was at the beginning of a line without telling the reader of the assumption. [In my opinion, what gets the text into trouble is that it starts talking about `C-k' killing lines, when what it really does (despite its name `kill-line') is kill from point to the end of a line, except when point is at the end of a line when it deletes the Newline separating the line from the following line (if any). This is made clear in the examples in Lines 414 to 417 and then confuddled in the paragraph at Line 419. To really kill lines one needs `kill-whole-line'. Whereas `kill-line' is best thought of as "kill to end of line".] In GNU Emacs 26.1 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.22.26) of 2018-05-28 built on moondust.localdomain Windowing system distributor 'Fedora Project', version 11.0.11906000 System Description: Fedora release 27 (Twenty Seven)