From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Howard Melman Newsgroups: gmane.emacs.bugs Subject: bug#55527: 28.1; Clearer abbrev docstrings Date: Sat, 21 May 2022 14:26:29 -0400 Message-ID: References: <83bkvtcq38.fsf@gnu.org> <838rqxcnkk.fsf@gnu.org> <837d6gdaab.fsf@gnu.org> <83leuw9ovm.fsf@gnu.org> <27EF500E-25FC-4079-AA2F-66A8B3CA95B5@gmail.com> <838rqv9wnp.fsf@gnu.org> <6DB8A7EA-325F-4E1D-8382-431581A07B95@gmail.com> <83fsl37z9k.fsf@gnu.org> <96FE2CC0-8A4C-4099-A3D5-5FDD351C739F@gmail.com> <83bkvq92wm.fsf@gnu.org> Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="12258"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 55527@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat May 21 20:27:10 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nsTok-000345-6t for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 21 May 2022 20:27:10 +0200 Original-Received: from localhost ([::1]:39180 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nsToi-0007fN-LE for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 21 May 2022 14:27:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40944) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsToc-0007fC-7V for bug-gnu-emacs@gnu.org; Sat, 21 May 2022 14:27:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49028) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nsTob-0005eL-UT for bug-gnu-emacs@gnu.org; Sat, 21 May 2022 14:27:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nsTob-0001WD-Ls for bug-gnu-emacs@gnu.org; Sat, 21 May 2022 14:27:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Howard Melman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 21 May 2022 18:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55527 X-GNU-PR-Package: emacs Original-Received: via spool by 55527-submit@debbugs.gnu.org id=B55527.16531576015805 (code B ref 55527); Sat, 21 May 2022 18:27:01 +0000 Original-Received: (at 55527) by debbugs.gnu.org; 21 May 2022 18:26:41 +0000 Original-Received: from localhost ([127.0.0.1]:42925 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsToH-0001VZ-6K for submit@debbugs.gnu.org; Sat, 21 May 2022 14:26:41 -0400 Original-Received: from mail-qt1-f175.google.com ([209.85.160.175]:35477) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsToC-0001VK-KU for 55527@debbugs.gnu.org; Sat, 21 May 2022 14:26:39 -0400 Original-Received: by mail-qt1-f175.google.com with SMTP id h9so5549907qtx.2 for <55527@debbugs.gnu.org>; Sat, 21 May 2022 11:26:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=6uZtSyjhUrfXkyLrO8Q7IRN2dWMwFiJrkyXEIXVcPXw=; b=Fykplf3gq/Tnho1NTDPFEpxm3ehozMecPITUzqokH2r9TmQIIyLtq9Sq5+TV3px8Z0 4EPLYJXtPL15kGsoetr1ENSZ+aW+2Xcsy+Hpz2hBetPuv/8PBYxLanDNd/juiN4yRyjK Y2ZcWT1dIO61hS8ni2waQnheHL9whfxsQdSf/+kP48wLerxAL75dHkVQcEkqNRAgNZxF lHDpf5gG+whLciVy0EP4nP2gsMNsXiNfi6FJRvh4IMBmxigCyHB1xG0WGwoz7PRa/Cmu Zt+Vl2xmwfp5FQsKzCVV0uSN/4V4uAWZ3eL3OjhT4U2GdDtpG+jL0IuSDYESCeGCz0+5 72Vw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=6uZtSyjhUrfXkyLrO8Q7IRN2dWMwFiJrkyXEIXVcPXw=; b=opbP0JbKM0ihsRbbyYGsKJtbHKMenvV82q1B4pT/x+H8CQMbDCdP0XkIKhCatMxNKx M8dsLLDVpCIni6Jp3xcVaGMsQ+TmqlIR8A22aWCjPkprLQI7daSIUE9qES5/yVP/SfYc /YQw8Ba4yTYH6LFviFDpOU41gngzEsndxlX5KrlZFwh/b7cajB9UJprJE5KPBtOyHlZ6 bUyzW/G13XzSzFwrcJiQ6zSb8TBGJbE32DcRMkAafG1I1Wi32mbQ6kuRPBZyPOwYE57F WRrTE/q8Wx1OIiuCNOb8RtcmsXE2EAtfl/xXcz0bmK4hBGUNrkM+jCtEq1n0aTEizmYk ljgg== X-Gm-Message-State: AOAM530lIgU/T2ipgN85+kKcXMUyDCPKS973V9+6bCxQ62Y4SDtvsdmg pDxdC0vM1Di8o8Hs+oHEr20= X-Google-Smtp-Source: ABdhPJwmBGK+7PvEvCNum9YXx2QJ+Haj3v7iPMHnW6PMn5VDr29yU5cTbumuknSOY/DbQR8i24SeVQ== X-Received: by 2002:a05:622a:178a:b0:2f9:2257:69e3 with SMTP id s10-20020a05622a178a00b002f9225769e3mr4980248qtk.568.1653157591086; Sat, 21 May 2022 11:26:31 -0700 (PDT) Original-Received: from smtpclient.apple (pool-108-26-204-101.bstnma.fios.verizon.net. [108.26.204.101]) by smtp.gmail.com with ESMTPSA id u65-20020a379244000000b0069fc13ce20asm1697057qkd.59.2022.05.21.11.26.30 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sat, 21 May 2022 11:26:30 -0700 (PDT) In-Reply-To: <83bkvq92wm.fsf@gnu.org> X-Mailer: Apple Mail (2.3654.120.0.1.13) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:232844 Archived-At: > On May 21, 2022, at 2:06 PM, Eli Zaretskii wrote: >=20 >> From: Howard Melman >> Date: Sat, 21 May 2022 13:49:48 -0400 >> Cc: 55527@debbugs.gnu.org >>=20 >> The existing docstrings for these commands had "word(s)" in them >> and I don't think that's what made them unclear. I also think it's a >> common case to define an abbrev for a multi-word expansion. >=20 > I disagree, and let's leave it at that. >=20 >> Also, I see now that the inverse- versions of these command treat a=20= >> negative argument as reversing the direction to find the word to use >> as the abbreviation but the (old and new) docstrings fails to mention=20= >> this. I'm not sure if that's intentional or not (IMO it's an odd use = case). >=20 > This is unrelated. The effect of negative argument was implied; I've > now made it explicit. >=20 > Our disagreement aside, are there any other issues left? Nope. Thanks. Howard=