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


Groups > gnu.bash.bug > #16637

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 Tue, 28 Jul 2020 10:11:21 -0400
Organization ITS, Case Western Reserve University
Lines 74
Approved bug-bash@gnu.org
Message-ID <mailman.204.1595945498.2739.bug-bash@gnu.org> (permalink)
References <74580fd0-3f5c-6aab-ec65-815ec18d6781@autistici.org> <c39f3267-e91f-0e20-1478-2f75bef00361@case.edu> <e40e660c-c7b0-3c4c-fca6-ecc3f8c2ba06@autistici.org> <835d3ebe-51e1-0986-3395-3ae71bc16313@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 1595945498 18861 209.51.188.17 (28 Jul 2020 14:11:38 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=1595945491; bh=R72fHDpG8KzkRCB8qCE83RwWki614C76HEJnwj9Blqk=; h=Reply-To:Cc:Subject:To:References:From:Message-ID:Date: MIME-Version:In-Reply-To:Content-Type:Content-Transfer-Encoding; b=B5MTijBiUuXTk0C1FecAgHy8nN0kMOgKh3ivzJM0L4dXlL5ks8SCqWpYGwJNElOkAj Ed0MUHyUaIUQ/qBAzMK/KgSJi8LbnbWt0Q36KTa8GuseRW1AIy4w5qe1rewztr4HXaf F7igF/AAw6e+ur1mQHJgBY/PvyOwPHk6PITrtO6s8TDXxuhD7nCmlJZIV2llzNLKznW nSaVJ8W1JtA4ZglRxPgT0vmc/CNVsNZJ0s/G44PIJHv2/WiYyICPiZGYZXY/Hu5t024 PDx74g7xJq0T2s/MJoefbS71IBA7xguSX2wH+z3srNOmnZjDzFzGnF2R1TdWvQSKyuX OIf7qNdQ==
DKIM-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=case.edu; s=smtp-primary; t=1595945488; bh=2wjMZx7SjRbb5v1rPTy8p763ifAH4U4Abb/PBFimKhE=; h=Reply-To:Cc:Subject:To:References:From:Message-ID:Date: MIME-Version:In-Reply-To:Content-Type:Content-Transfer-Encoding; b=advf7tZ0ciVuhXBbC9jgUe+gTLrUgqShPwWV9mi/vcUiraUlq/VpTnd27IY/UAWmt3 NmcsCEPpl6NhCrIVawakWBLeEYY/7D4uEXGAeS+B2/iBbRLF6csy/aDcgSVjM9EDbay tERvgQ5Zzi/LSfAkplAVPoIQrWMZMPUk9juwt4QpbVQzPT6N5UJHqzf6RYAzaNJGZdt OGduzEXrPTYvzTIJvTeHZS0jHgEJrP5tHFyO4w9oNQ1l/jXpZSCqug2CV4B6Tp3V1je vGAb4yL84qI0eoC9EZ8RESylyGxlDlcspr5JPEL9r7nvih08CHVsuzGEaxYwZcOSDG+ 0zXtHlVQ==
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=2wjMZx7SjRbb5v1rPTy8p763ifAH4U4Abb/PBFimKhE=; b=HgsWZn3mDfKNQDiZCGTRIpfHxQhFIvtNiVVofCwxZfoXdbq/7Dk4UKuYpM6v9s6rAz bxOaovPFfi7O4/nioqA5mHC4tNzW4qcGzAg3QXg1zI2LK9VPjyYcbHb4ekmqNSMgz9g5 YjCCA5jXiRd9sLyQChWPOG7+J6zTo/AEKEb4pgWWNNn6rdSKSuzd3VZZtuUcD+dYbgDC VjkPd/wkyxWAT/Sx+rZ71HHfddPWWDbFBVuTlv8tNwWM/dNjxIzwrtwV5bVZkmlM3M6G dPNpN3H2ePqFmtmku9cXKyq3OreVe7e9ITkMrbp+k+Mpx+D7UEIcA9svVGFIB6vbpDY+ Olhw==
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=2wjMZx7SjRbb5v1rPTy8p763ifAH4U4Abb/PBFimKhE=; b=HE1Y1/o0g/3e4CdAkNaLh9iCIrFgq0VPU/b92/uy/a4NWDV5a1EXMVBEJr8krjoalC hsRoiIHBWisnKEgwUFFXMpenIjyIypTXJY3uUQIImd+xUb+A6cfC2Y/OUesTSYfydvHa RUtgvnJTlqxOG8sXfYmP5+GnE9OTuCWxJk06aft026bd5h3506AC37jPn+UVci9OhrSl VSeVyFR/Cj9ulj1y7Fe2DfXzEq2JZRT8YvmHOJSAwowMUVP8yQr90Yz643pk8APfbDXH ebGNUA86xbZwUF3CSLxohjK8LN2dCDPldU6ZfVd85l9GdkH9lQ7CMOXi6VohdviNepjP 8lcg==
X-Gm-Message-State AOAM532boyZF8gnYEtUez43mz9IC/sKUIyp7uwmby0H8zMp6Tp5djlJS lwIdGxzSp2n8wPUstCqyO9HwDZbmh2o64nXQsAh9CoWP8im9SoQEhKH0yG5dIfq3p7BGKqnERhc NZm4CAHRKODY=
X-Received by 2002:ac8:1488:: with SMTP id l8mr15816172qtj.131.1595945484740; Tue, 28 Jul 2020 07:11:24 -0700 (PDT)
X-Google-Smtp-Source ABdhPJwKftqWb4MoipexbAelHgyu76hwFGIDfDCd9bERJfBzF6BLf7PDMEMiJFGi0gqYpzp2+W9qmA==
X-Received by 2002:ac8:1488:: with SMTP id l8mr15816080qtj.131.1595945483542; Tue, 28 Jul 2020 07:11: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 <e40e660c-c7b0-3c4c-fca6-ecc3f8c2ba06@autistici.org>
Content-Language en-US
X-Mirapoint-IP-Reputation reputation=Good-1, source=Queried, refid=tid=0001.0A020303.5F202599.0012, 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.28.134517: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, INFO_TLD, __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, [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/28 09:22:07
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 <835d3ebe-51e1-0986-3395-3ae71bc16313@case.edu>
X-Mailman-Original-References <74580fd0-3f5c-6aab-ec65-815ec18d6781@autistici.org> <c39f3267-e91f-0e20-1478-2f75bef00361@case.edu> <e40e660c-c7b0-3c4c-fca6-ecc3f8c2ba06@autistici.org>
Xref csiph.com gnu.bash.bug:16637

Show key headers only | View raw


On 7/28/20 4:21 AM, Daniel Molina wrote:
> On 27/7/20 22:09, Chet Ramey wrote:
>> 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.
> 
> 
> I see.
> 
> 
>>  Maybe that is what
>> should be added to the backward-kill-line description.
> 
> I think that would be useful for that an similar commands. I found the
> question asked on the web too.

There is already

"If you pass a negative argument to a
command which normally acts in a forward direction, that command will
act in a backward direction.  For example, to kill text back to the
start of the line, you might type @samp{M-- C-k}."

It seems like one statement is better than adding the same text to
multiple command descriptions.



> Maybe a confusing part is Section "1.3.3 Sample Init File" of
> doc/readline.info where there are lines like
> 
>          # Arrow keys in keypad mode
>          #
>          #"\M-OD":        backward-char
> 
> 
>          #
>          # Arrow keys in ANSI mode
>          #
>          "\M-[D":        backward-char
> 
> and
> 
>     "\C-xr": redraw-current-line

This is not what we're talking about. These are specific multi-key
sequences that are bound to specific commands, not a question of whether
C-A and C-a are equivalent. The parallel to the previous question would
be whether "\C-Xr" and "\C-xr" are equivalent key sequences.

-- 
``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-28 10:11 -0400

csiph-web