Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > gnu.bash.bug > #16629

Re: apparent inconsistencies in readline documentation

Path csiph.com!xmission!news.snarked.org!news.linkpendium.com!news.linkpendium.com!panix!usenet.stanford.edu!not-for-mail
From Chet Ramey <chet.ramey@case.edu>
Newsgroups gnu.bash.bug
Subject Re: apparent inconsistencies in readline documentation
Date Mon, 27 Jul 2020 16:09:22 -0400
Organization ITS, Case Western Reserve University
Lines 64
Approved bug-bash@gnu.org
Message-ID <mailman.154.1595880583.2739.bug-bash@gnu.org> (permalink)
References <74580fd0-3f5c-6aab-ec65-815ec18d6781@autistici.org> <c39f3267-e91f-0e20-1478-2f75bef00361@case.edu>
Reply-To chet.ramey@case.edu
NNTP-Posting-Host lists.gnu.org
Mime-Version 1.0
Content-Type text/plain; charset=utf-8
Content-Transfer-Encoding 8bit
X-Trace usenet.stanford.edu 1595880584 5585 209.51.188.17 (27 Jul 2020 20:09:44 GMT)
X-Complaints-To action@cs.stanford.edu
Cc chet.ramey@case.edu
To Daniel Molina <lluvia@autistici.org>, bug-bash@gnu.org
Envelope-to bug-bash@gnu.org
DKIM-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=case.edu; s=smtp-primary; t=1595880579; bh=UVY08nXPeXw0h4kxM7MRKUTEl3z9Ph29QCd/PNIch5w=; h=Reply-To:Cc:Subject:To:References:From:Message-ID:Date: MIME-Version:In-Reply-To:Content-Type:Content-Transfer-Encoding; b=gwYrZRvl46WK85w4NofbGTrzOavfQUCWSFxKBk+laKVFCGEQYe+tXLiGLo8prAyKkt SYmhccrgeXZlnPqjiMV93TjMWvjs58B+zds/JYkSRM0fYWYd0RAO7QMu3iMiCaKA5FX HPkPpUQb3eW0EodqPTbF4PU3ne9sXwqCokPk3dG8H2OVSqRv/RfikusRbPhusojX3L9 LbjGpVLORCZ9ezxsiRV82dmHkncLc2hmVoYyBFLK9f7rusjjKefopgWmnwZNDZ3E7gu um4h01lG52l1Sh1UHVQwkI6rar+6oaOJ6mdJTSFtOoe6gpjtsuam99kFHIOVW8P1MQ+ yYJvDoXw==
DKIM-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=case.edu; s=smtp-primary; t=1595880576; bh=2+TwWLQT0hnc5a8r6vb94DV34CLhaTrh2ygNCA55B84=; h=Reply-To:Cc:Subject:To:References:From:Message-ID:Date: MIME-Version:In-Reply-To:Content-Type:Content-Transfer-Encoding; b=aDIASSzaspAikx+ANZrlFj19Lkl0KX0+pbb6EMgCi38dZ+3riaI/lQNd4pCehcnIyf V0G+DqQUtW6+IE/93yX9L8zwXO64pR9u0wtY0D0xgz314dVdAHKKH7ycmb86rHmhHeS jvhs3BBFE+eVvveJW1wR1agH3chL8a7FDtMidl7+hSAZJDpb3wuBTvaCoJ6fBrMQljV tjJ0dy2S9MKb3iEYuFG5xPQ7zXdBAj0vx9SlkqOfFrfcZlZoVOWSjBiSAZSYvR1zLPb UliTvNKsG/poAydN1ex+MvS/SPBp45G4rwMzYbREyRSB1rdD+SG5r0zd2m/uQx/MuwL NrcCAg7g==
DKIM-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=case.edu; s=g-case; h=reply-to:cc:subject:to:references:from:autocrypt:organization :message-id:date:user-agent:mime-version:in-reply-to :content-language:content-transfer-encoding; bh=2+TwWLQT0hnc5a8r6vb94DV34CLhaTrh2ygNCA55B84=; b=OnVzkQxWN67AbuLbvnDzKOauYKij4wE2FCKSMaB9+tumNsfprNkOTjJTdt8MFPE0mB /cqrMXbfdL0uTbMf3ZFr9mURyNWyW+p1kZ8PbeyVgXEo95pbhnH7deyxgH7mctS4G1JP j33hGa7empaYSOFHHhtKvOIVqE6gJ6wLPTMW227Wpi8rHFFmK9qya+SgtevAJMswJH2f niWzHwQAhoYlTJ/qOVfZbMJRUNCIo9E8YrwMqG0AfZkacznbrlT3cOaMzZX3Cqb6K8dM X6dsWUedV2B5So8uRqUik1ks5m0x8olYwEPfEoljeMEYGcOB64geQHEgKiqIUL//jHvI vJBg==
X-Google-DKIM-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:reply-to:cc:subject:to:references:from:autocrypt :organization:message-id:date:user-agent:mime-version:in-reply-to :content-language:content-transfer-encoding; bh=2+TwWLQT0hnc5a8r6vb94DV34CLhaTrh2ygNCA55B84=; b=iSwUCWdTpusDZeQ4oiFaMMYe1bp8flFvF4HugK3nuWthqLAl6L/RHgKvIKMy8Ue9bh jTLdbnJYxnq3rzj5G4dRMfaDMDtWc+Cypk9OrVmMTThykKpXkLO8B3+izXV9uL8rDR9N 8403t7zRVjb4E/XrkyW9C2kzoYkUbicXOfLmDNrmFL4saM8Cr9WSDB7wKni4X9WpBRFk hDQ4eYNnm8kHkvFq6aKr5ipWXnS33JTFOD0dyZiBpI7ndum5Z5Ty6EgEQN8ZSCduxlAU n/aRwbAQ0rziPM920RN5Yca8Qizg0ZG/5DN5KBS9kVsWizyW0qvhl2Ux/FInyf+yuujD Ezlg==
X-Gm-Message-State AOAM532cdOM5PzQGBD458ZC6M9ep8AYcuuVsJuIIsl9qRsKSi0ROl8Jo mvmBPFhkCBaqx//bTiNFHAHPz8JOODA3x45KGcuRBrRioKAkh9oR78TF4j7NYYptSANHqqjygAo 8jF2fXTuDdO4=
X-Received by 2002:a05:620a:15e8:: with SMTP id p8mr24000905qkm.182.1595880564259; Mon, 27 Jul 2020 13:09:24 -0700 (PDT)
X-Google-Smtp-Source ABdhPJw/rIBQTy4AL6PeRWCO9lrrADaNyafOrvsxQYkEuTdA0iSV+kMFvHrr2KYWU87CspeNlyZ0LA==
X-Received by 2002:a05:620a:15e8:: with SMTP id p8mr24000872qkm.182.1595880563954; Mon, 27 Jul 2020 13:09:23 -0700 (PDT)
Autocrypt addr=chet.ramey@case.edu; prefer-encrypt=mutual; keydata= mQGiBEEOsGwRBACFa0A1oa71HSZLWxAx0svXzhOZNQZOzqHmSuGOG92jIpQpr8DpvgRh40Yp AwdcXb8QG1J5yGAKeevNE1zCFaA725vGSdHUyypHouV0xoWwukYO6qlyyX+2BZU+okBUqoWQ koWxiYaCSfzB2Ln7pmdys1fJhcgBKf3VjWCjd2XJTwCgoFJOwyBFJdugjfwjSoRSwDOIMf0D /iQKqlWhIO1LGpMrGX0il0/x4zj0NAcSwAk7LaPZbN4UPjn5pqGEHBlf1+xDDQCkAoZ/VqES GZragl4VqJfxBr29Ag0UDvNbUbXoxQsARdero1M8GiAIRc50hj7HXFoERwenbNDJL86GPLAQ OTGOCa4W2o29nFfFjQrsrrYHzVtyA/9oyKvTeEMJ7NA3VJdWcmn7gOu0FxEmSNhSoV1T4vP2 1Wf7f5niCCRKQLNyUy0wEApQi4tSysdz+AbgAc0b/bHYVzIf2uO2lIEZQNNt+3g2bmXgloWm W5fsm/di50Gm1l1Na63d3RZ00SeFQos6WEwLUHEB0yp6KXluXLLIZitEJLQwQ2hldCBSYW1l eSAoQ2FzZSBzdGFuZGFyZCkgPGNoZXQucmFtZXlAY2FzZS5lZHU+iF8EExECAB8FAkPi19EC GwMHCwkIBwMCAQMVAgMDFgIBAh4BAheAAAoJELtYafBk6nSrelkAn31Gsuib7GcCZHbv5L5t VKYR9LklAJ4hzUHKA49Z0QXR+qCb80osIcmPSbkBDQRBDrBvEAQAkK6TAOKBEM+EC4j6V/7o /riVZqcgU5cid2qG9TXdwNtD9a3kvA/ObZBO93sX59wc6Bnwo4VJxsOmMlpGrAjJsxNwg3QH akEtf8LXRbVpj5xStdmBdQZUhIQyalo/2/TZq5OijtddUQcL5cs70hTv/FpT3wUvr2Xr8rjF 41IFEz8AAwcD/A0CZEGlzIrT5WCBnl6xBog/8vKiUCbarByat3d1mL6DbizvKNXQRTC9E/vE dENAWCQCjr75Bu55xT8n3SXGtWdDC5xmZ/P3OBYORP8yl8H8I1FIosWOFirbIeYdZPq8SPD1 HL+EXo9zSiHVrrZRJ19ooCKKbSdXHFCY+aJG+0KZiEkEGBECAAkFAkEOsG8CGwwACgkQu1hp 8GTqdKvjcACfZlkVCDwaz/NTO9cy3t69oWpVPNwAnRwe0qk/WL/gfhH346xh5B3HFbFN
User-Agent Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:68.0) Gecko/20100101 Thunderbird/68.10.0
In-Reply-To <74580fd0-3f5c-6aab-ec65-815ec18d6781@autistici.org>
Content-Language en-US
X-Mirapoint-IP-Reputation reputation=Good-1, source=Queried, refid=tid=0001.0A020301.5F1F2E0D.0072, actions=tag
X-Mirapoint-IP-Reputation reputation=good-1, source=Fixed, refid=n/a, actions=tag
X-Junkmail-Status score=7/80, host=mpv1-2015.case.edu
X-Junkmail-PrAS-Raw score=7/80, refid=2.7.2:2020.7.27.193317:17:7.944, ip=, rules=__YOUTUBE_RCVD, DKIM_SIGNATURE, __X_GOOGLE_DKIM_SIGNATURE, __HAS_REPLYTO, __HAS_CC_HDR, __SUBJ_REPLY, __BOUNCE_CHALLENGE_SUBJ, __BOUNCE_NDR_SUBJ_EXEMPT, __TO_MALFORMED_2, __MULTIPLE_RCPTS_TO_X2, __TO_NAME, __TO_NAME_DIFF_FROM_ACC, __HAS_REFERENCES, __REFERENCES, __HAS_FROM, FROM_EDU_TLD, __HAS_MSGID, __SANE_MSGID, DATE_TZ_NA, __USER_AGENT, __MOZILLA_USER_AGENT, __MIME_VERSION, __IN_REP_TO, __CT, __CT_TEXT_PLAIN, __CTE, __REPLYTO_SAMEAS_FROM_ADDY, __REPLYTO_SAMEAS_FROM_ACC, __FROM_DOMAIN_IN_ANY_CC1, __FROM_DOMAIN_IN_ANY_CC2, __REPLYTO_SAMEAS_FROM_DOMAIN, __DKIM_ALIGNS_1, __DKIM_ALIGNS_2, __ANY_URI, __URI_MAILTO, __URI_WITH_PATH, __URI_ENDS_IN_SLASH, __URI_NO_WWW, __HIGHBITS, __CP_URI_IN_BODY, __FRAUD_BADTHINGS, __SUBJ_ALPHA_NEGATE, __URI_IN_BODY, __URI_NOT_IMG, __MAIL_CHAIN, __FORWARDED_MSG, __BODY_NO_MAILTO, __NO_HTML_TAG_RAW, BODYTEXTP_SIZE_3000_LESS, [TRUNCATED], so=2010-03-03 19:42:08, dmn=2016-08-03-0138
Received-SPF pass client-ip=129.22.103.226; envelope-from=chet.ramey@case.edu; helo=mpv1-2015.case.edu
X-detected-operating-system by eggs.gnu.org: First seen = 2020/07/27 16:09:37
X-ACL-Warn Detected OS = Linux 2.4.x-2.6.x [generic]
X-Spam_score_int -43
X-Spam_score -4.4
X-Spam_bar ----
X-Spam_report (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001 autolearn=ham autolearn_force=no
X-Spam_action no action
X-BeenThere bug-bash@gnu.org
X-Mailman-Version 2.1.23
Precedence list
List-Id Bug reports for the GNU Bourne Again SHell <bug-bash.gnu.org>
List-Unsubscribe <https://lists.gnu.org/mailman/options/bug-bash>, <mailto:bug-bash-request@gnu.org?subject=unsubscribe>
List-Archive <https://lists.gnu.org/archive/html/bug-bash>
List-Post <mailto:bug-bash@gnu.org>
List-Help <mailto:bug-bash-request@gnu.org?subject=help>
List-Subscribe <https://lists.gnu.org/mailman/listinfo/bug-bash>, <mailto:bug-bash-request@gnu.org?subject=subscribe>
X-Mailman-Original-Message-ID <c39f3267-e91f-0e20-1478-2f75bef00361@case.edu>
X-Mailman-Original-References <74580fd0-3f5c-6aab-ec65-815ec18d6781@autistici.org>
Xref csiph.com gnu.bash.bug:16629

Show key headers only | View raw


On 7/25/20 12:21 PM, Daniel Molina wrote:
> Hi,
> 
> I found some aspects of readline documentation that seem inconsistent to
> me and I wanted to share them.
> 
> 1. The difference between backward-kill-line and unix-line-discard
> readline commands.
> 
> Documentation states:
> 
>        backward-kill-line (C-x Rubout)
>               Kill backward to the beginning of the line.
> 
>        unix-line-discard (C-u)
>               Kill backward from point to the  beginning  of  the 
> line.   The
>               killed text is saved on the kill-ring.
> 
> In both cases they kill from the point and killed text is saved in the
> kill-ring.

The difference is what happens with numeric arguments. Maybe that is what
should be added to the backward-kill-line description.

> 
> 2. Default key sequences vs. emacs key bindings [the default].
> 
> It is confusing to me that there are two defaults. Firstly, it can be read:
> 
>     EDITING COMMANDS
>            The  following  is  a list of the names of the commands and
>     the default
>            key sequences to which they are bound.  Command names without
>     an accom‐
>            panying key sequence are unbound by default.
> 
> On the other hand, emacs editing command are default:
> 
>     readline  offers  editing  capabilities  while the user is entering the
>            line.  By default, the line editing commands are similar  to 
>     those  of
>            emacs.  A vi-style line editing interface is also available.
> 
> An explicit list of emacs commands is maintained and commands do not
> always coincide (both being valid defaults in practice). For example,
> instead of C-x Rubout for backward-kill-line, emacs has
> 
>              "C-XC-?"  backward-kill-line

Rubout/DEL[ete]/C-? are the same key.

> 
> 3. Key-bindings in the emacs/vi list are written with capital letters
> (C-A), but not in the section with the description (C-a).

It's a writing convention. The behavior doesn't differ. Are there places
where this convention is used inconsistently?

-- 
``The lyf so short, the craft so long to lerne.'' - Chaucer
		 ``Ars longa, vita brevis'' - Hippocrates
Chet Ramey, UTech, CWRU    chet@case.edu    http://tiswww.cwru.edu/~chet/

Back to gnu.bash.bug | Previous | Next | Find similar


Thread

Re: apparent inconsistencies in readline documentation Chet Ramey <chet.ramey@case.edu> - 2020-07-27 16:09 -0400

csiph-web