From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#61609: 26.3; Doc strings of `just-one-space` and `delete-horizontal-space' Date: Sat, 18 Feb 2023 17:19:06 +0000 Message-ID: Mime-Version: 1.0 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="759"; mail-complaints-to="usenet@ciao.gmane.io" To: 61609@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Feb 18 18:20:23 2023 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 1pTQso-000AVx-NX for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 18 Feb 2023 18:20:22 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pTQse-0000Ks-OH; Sat, 18 Feb 2023 12:20:12 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pTQsc-0000Kh-DH for bug-gnu-emacs@gnu.org; Sat, 18 Feb 2023 12:20:10 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pTQsU-0000VN-Kb for bug-gnu-emacs@gnu.org; Sat, 18 Feb 2023 12:20:07 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pTQsU-0004Si-E7 for bug-gnu-emacs@gnu.org; Sat, 18 Feb 2023 12:20:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 18 Feb 2023 17:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 61609 X-GNU-PR-Package: emacs X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.167674076217097 (code B ref -1); Sat, 18 Feb 2023 17:20:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 18 Feb 2023 17:19:22 +0000 Original-Received: from localhost ([127.0.0.1]:44847 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pTQrp-0004Rh-T1 for submit@debbugs.gnu.org; Sat, 18 Feb 2023 12:19:22 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:33556) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pTQrm-0004RV-VA for submit@debbugs.gnu.org; Sat, 18 Feb 2023 12:19:20 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pTQrm-0000H2-KT for bug-gnu-emacs@gnu.org; Sat, 18 Feb 2023 12:19:18 -0500 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pTQrk-0000Ng-9v for bug-gnu-emacs@gnu.org; Sat, 18 Feb 2023 12:19:18 -0500 Original-Received: from pps.filterd (m0246617.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 31I7crh7018137 for ; Sat, 18 Feb 2023 17:19:11 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : content-type : content-transfer-encoding : mime-version; s=corp-2022-7-12; bh=NjxG3psiwbSixraHt3VhGJZnS5OLWQPcAt6K1tR1VZk=; b=k9FoivS/CvlZl9lDxJa2On+dz7Gj0P11RqnZI0JrMvWujrFfkFKxPp0UVAm2i9+D/hII 4xuQQKmfmKGd5yKsgx4xKxNmVIVjlQH0ENt8oRN/EgE4rbWVWmIVvkHGuZsTpbJc90LY oFlyW2Lb2jUrgxodIK4W+c7LtuLPXQYhWhWhB6H0vIUiIJCVXLpX3rTX2DoBO2I1GN5d vJBEkGY7ko08UOKP9IXLIKSdSifUwOotfbafF5vNgolWoz8poNr9NaXo7MQXU/Ta/x/x dRMvZWibcL3NYAudtDdRSyoW5ihi09kmJYXoXqASm1e/6U/HLrvdb7G99Qatse3FAfhd 8Q== Original-Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta01.appoci.oracle.com [130.35.100.223]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3ntq7u8hyq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 18 Feb 2023 17:19:11 +0000 Original-Received: from pps.filterd (iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 31IEkKkD006796 for ; Sat, 18 Feb 2023 17:19:10 GMT Original-Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2103.outbound.protection.outlook.com [104.47.58.103]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3ntn48s9r6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 18 Feb 2023 17:19:09 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=KJd2Kni+BA/oF3BVBRG6Xq4DTyO6dY28LWVziuGV1dVvnqyCLt+/qxsZjdGYpXN/rYgRRrVUo3LaP2novbRuv0E1PhtltTBtBtdMc3MafpVq7pDjrae45bJdSY/oK/LeQfUq34n3UNtlIsXD0YBGyp9hQk6emRq0NDEmJ8rL+ANcO0fVfnCcyLW8izlVnmGBamsNyIJTcsGUpAVrUgXLEJspW18vAmiADcmSA2QmC1vwmIirmtZpNdJCoB4yIdVsOlECF8vrhJNEhph06ej2nJOqtexFzYZnz/waKMl6lvMi3qRXRulOqcWm/KMaOO5vUxV4BO+agIFr9qhKX2R2CQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=NjxG3psiwbSixraHt3VhGJZnS5OLWQPcAt6K1tR1VZk=; b=UMe+23tG/48QBBAMrTuALx2PH8l7bW3qMM31QQi96EocS3Hs84pyNjOsQphnex2HjCqEeFc9YP/A4pzVygyAEEera/RLLzm6Muyt4X1bxb2F69JSwykqp7jom0H7hG7apD7omrfiEBH2GnxPJ9ekclfzqPa44c0k0AU80oVKS/8MK4uxeN6pTLRXPpvaONoYfsQSlFpzfOmKIm4JTQzsNJUccgwmJOauaspfvz6ORvjWaIEQMrF0B3CVSLhfWRtoser3ZuC1JPNMDXb6z9i2V4aAWwQhqnXajL/3s9LUPmXKCQr33Ieh7cJ7MMron/xgonPodAheUPtqL/I22a5Ciw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NjxG3psiwbSixraHt3VhGJZnS5OLWQPcAt6K1tR1VZk=; b=VFoim9o3iAUZYDw84ILvbYe13Rm372AoXk/dm0FSnJZrG0xJXsl1Nif56w1pVfV8hywstoqwvV+SbQh/N4LVKbgX3vhtR0QoAtPN1e4Bz14cGiyCdY6x3n1FcAwP2cFVvbmNMQ5ohemHQFTKkhXSWBqk3UYC7SeanbFg+9twqBE= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by DM4PR10MB7526.namprd10.prod.outlook.com (2603:10b6:8:17f::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6111.12; Sat, 18 Feb 2023 17:19:07 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::d353:3fb:94e4:18b9]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::d353:3fb:94e4:18b9%8]) with mapi id 15.20.6134.014; Sat, 18 Feb 2023 17:19:07 +0000 Thread-Topic: 26.3; Doc strings of `just-one-space` and `delete-horizontal-space' Thread-Index: AdlDvRBgZMjFX3OxRgi0ly9ZDU7Gng== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|DM4PR10MB7526:EE_ x-ms-office365-filtering-correlation-id: e87381a9-c94c-402b-b0da-08db11d43d9a x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 2jmZVZs8tr+ye3Tp4zlGb7FPPIy6u1hf47VrZATW7wgMCx0inzwaBo4enHYQ4GuhPY2WNkp7dEKN0pcKEEj3oVA3m697KeHncpYnRUQOO0ZnJNoq0fLvXa67OTQU6SNzlIgcXcIibQucgtpZmKsCgO6IrSK3QtrqbbLNT5oxAx0utCw/qC+sLwWzxywkRXfealpYvSgljKOFWcmNPenqSOUUo+vEB//BZJ7C9BuC3WobFjl4upreSp9HhcS7JY+zZ0r4oX+Uzn/yualLrZ5QqBiqUKA4zN2rGp5NXPbH+rG7QAAYdcJQCrHy2rFEU6U6PStLwS4ECxJXzsuRC/lnLXfOrHwILumObEEl+/KpWw18EIeMSpGPAt4hbGVcNWVUDkfEWYdZAy+5HRn8ShhaHPUEQtiRg4LCurglBCe5rKAsQsHA2n2AtXiKKQp25kjuqT0KeFmwwR9Yb8ywhKkrfT3k8kRmLdWmMymEWQilOThP5LM+Wm+oFIw94/OaqwwZowmtXDSOHGrNjtim7RBiMJSSDPk27h2/wBu8e2aM236W3NupdJ8bSxlJ1pEKVij9d/Q9DdK20ZBzGxY6pr+nkWdhxm/odTRnfFtgCCFmW0fPkU8BH5W/vbwsyMTLgY0syNle08npLjlfw98SOXgn4XIcKe2EMTKuSyWKNAfxjoZ0J3OQdlJ9owhxEBxT6g4yBYXXpmM78d/ejzFD46xOvBkhJB14pumxTpN+ss9ntPs= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230025)(39860400002)(366004)(346002)(136003)(396003)(376002)(451199018)(9686003)(6506007)(83380400001)(478600001)(8676002)(66446008)(38100700002)(66946007)(66476007)(52536014)(41300700001)(64756008)(66556008)(76116006)(6916009)(55016003)(316002)(186003)(45080400002)(26005)(7696005)(5660300002)(44832011)(8936002)(38070700005)(33656002)(71200400001)(2906002)(86362001)(122000001)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: Kf3PqljSYlmcgtZyNiTJhOxI4YGpg++z6CsoH3IxExfHxI8g+8dTGGA+0yOYBpgGIswJbUlB/vMiRAq+do+XVQhAVW6BnYVUZ9GVCAP70vsj94c6kveRgTS4LNwki370OqvzQbw6nEtYocDq8mEEL+RJXMWnwffkZHn1melc0H60A4rHt/P/ydgp2JWFJryizqK+gsM3BaMCZwitGp/4flbwN4oAP+ek74SQlbeE5QJeVkQZfFcjuyf6VZ4LHqbxekCXKsrfCgxUovS01G9s8X8pbLQQCpxZDzUpYEDg4T4LpMqxdmr1CmmxfMtZxafuBIYAKXYFEKzs0C1xvipXnaC2ABr0v0HGYCypwEpd7jwew7M5aKdEhV66I9ARB/35JN2kFEak7BHuxsOzqMvUKy1bqIKY48m9Qsg87HMcXjBUoeEmeRdeY1K3GoGWUalFX28p6rukVMF1sX32qU27jJUPGezGVB8RGHGpi8Z0yBhHQow2XGEhHGxB5NukjLcimo+GGN/56WnM3QjdNwfuVtrnS5d4jW02m9MN1myjkvz6m4Zcypbvrkmn9X3QnMvRf/k4V9lYOr41X+B3aBUZ3VSbJVPuDp14/kPjZkrg8G2X9lUoH9v87HuFAMaxWIZK4VbVqF2NKwiN1aO/pxnTE7z2XgdsiZN30YpzDH4df7pWg7ViL69rdsw5lc1dJTrqKl9x7mHKVPED5mMvDRZWVVQydicYt8nz1LWPi9csPRyRAVRuxf9qMhbXKe bGsCNpQy78vaY2uoV+qwr1bqcErGL/GK9BcVdG4l07tuB/DlnmjnCboN2W9s/eJYkImYqKklK9hiYfbp6eS/7qFtWdJ5gHn6wK X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: PXZLGAv3flExl/VU1gwX/k0Yki9KsjcpyJ6pF+w2SZ4YQ1Lx5ID+5qrfqeVHeyvkCKw3lFZDhNiFrZz7FzWQU3GM6rEyVgOhay7/22AHQeMTgDXDMKuSjMqmhF/06SoOEW2gczu/aYpZQ+hmE991fFDwhYkPFWpP9Kpg/+wofeyJ+P+g7TKpdDwWG9jiF7+nh+m2jA9sPKJCzUlVUfGdkYJPvOt0vHCFnDms23FXjDazEao7csrdfUjA+UZlbqaJSmAOvIFjZwEpeVzMtXim/0BvXDXRDL5rgZmY7aOGaKOh4KhGHEYtShFv6rNHpQS6PLikg2OnBRtECdyvt/EahzsyLbnZMw4K9s0qsFOLSwmbnW0Os1LioMsOm5L3yv144qSaWDvQPCogXFMZQPq9gIekaR2ZAzwKPXHa+8CZXVcUoDKbFi1BrvbpbtG58fz91hZOcP5TzGwQ33LL3s6u6FAN2/BvRGOI284tsLGLpW4Mp9XW1QGGmu5pDO6tVxIBq7e9bkYaaYmoZWfk/DIz/CH3IWwMTpxwrZRcCiHDyhUNVo7oz1lWZiwWb7xmUDFAj3S7Ve+17Noz2UUh2LS5FGH8pPNT/zKjD1btmkyNdUzNuKJXnG7laEImqiv1Hd34S5mM+MkAMPiNnnMk+Vy7qo2PR+lwYLGqLeoHsVW+j2geTZUa9kXa4dvR6znHS3Au6LrjtDjNn8ozV3oK8BPGlBPhlLHSF+3vQG5OMJOKdR6i1H uDgvwNyxn4TdlkBv7g X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: e87381a9-c94c-402b-b0da-08db11d43d9a X-MS-Exchange-CrossTenant-originalarrivaltime: 18 Feb 2023 17:19:06.6876 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: IuHLjjK33kvxtbPfYFngwXqbo+XmV//eAkBv2HpMV9O1m0500xVzzE2UiQu5HmkaxMLalkTuazQyi5M+x6ztSQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR10MB7526 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.930,Hydra:6.0.562,FMLib:17.11.170.22 definitions=2023-02-18_12,2023-02-17_01,2023-02-09_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 phishscore=0 suspectscore=0 mlxlogscore=911 adultscore=0 mlxscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2302180158 X-Proofpoint-GUID: 0MztkhgU8krPNcrT3Cj7EC59q4Lo9m0S X-Proofpoint-ORIG-GUID: 0MztkhgU8krPNcrT3Cj7EC59q4Lo9m0S Received-SPF: pass client-ip=205.220.165.32; envelope-from=drew.adams@oracle.com; helo=mx0a-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:255979 Archived-At: Please mention in the doc strings that a prefix arg is how you get the behavior described for the argument. The doc strings don't seem to be properly written for users. just-one-space: Delete all spaces and tabs around point, leaving one space (or N spaces). If N is negative, delete newlines as well, leaving -N spaces. delete-horizontal-space: Delete all spaces and tabs around point. If BACKWARD-ONLY is non-nil, only delete them before point. Nothing tells you that N for `just-one-space' is the numeric prefix arg or that BACKWARD-ONLY for `delete-horizontal-space' is the (raw) prefix arg. Without checking the code users won't have a clue how to get the N and BACKWORD-ONLY behaviors. (The descriptions in the manual do provide this info that's missing from the doc strings.) In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.19044 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''