From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 30 11:07:19 2023 Received: (at submit) by debbugs.gnu.org; 30 Jun 2023 15:07:19 +0000 Received: from localhost ([127.0.0.1]:55526 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qFFiR-00005x-2c for submit@debbugs.gnu.org; Fri, 30 Jun 2023 11:07:19 -0400 Received: from lists.gnu.org ([209.51.188.17]:54178) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qFFiO-00005o-MG for submit@debbugs.gnu.org; Fri, 30 Jun 2023 11:07:17 -0400 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 1qFFiO-0001ku-13 for bug-gnu-emacs@gnu.org; Fri, 30 Jun 2023 11:07:16 -0400 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 1qFFiM-0006IW-3A for bug-gnu-emacs@gnu.org; Fri, 30 Jun 2023 11:07:15 -0400 Received: from pps.filterd (m0246629.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 35UEnBZh013938 for ; Fri, 30 Jun 2023 15:07:09 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-2023-03-30; bh=u8HZG3niagmsTeTctA7V+r0+3itx1M7hof51l6Qxbtk=; b=nB6TwRR9HSBDWQQ73JJH8iwj9wd5S6T0EdWW2A7wmwr+PCjYhUQCt3c5HCMYjTJ6jaZ1 zZE7UxQ/ajhqbSswrVFus8CsAvDV2C/G1oyuLXoaL3CkCec+CxBwaaVuWb1xeziJj19n HUfOafDj+MJGTdbwPy1M8y4tUNrUKsYLStn0mYPB1R+FChQt8G6hp8Bi5coKurLzDJKk ncFVvN7m10FQzw6QYzBNQpEpYROF3Hvt0gncdBq+H70RtdySE8kSRnAAqsReBZaab/VJ WgeDK2Srp7qA6BK/LPP56QkXg7Pr63vYsA75KKsChwecPi5lVHEKYi1w+o8YctqwTTir tQ== Received: from iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta03.appoci.oracle.com [130.35.103.27]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3rdrcagshs-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 30 Jun 2023 15:07:09 +0000 Received: from pps.filterd (iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 35UEkPkm038275 for ; Fri, 30 Jun 2023 15:07:07 GMT Received: from nam11-co1-obe.outbound.protection.outlook.com (mail-co1nam11lp2177.outbound.protection.outlook.com [104.47.56.177]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3rdpxfggyw-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 30 Jun 2023 15:07:07 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=IWRT0U0ObJ7DWA9G685T4Vc9aVfQujL4VlDFlDBKwQPSn0jCTkpLROcCSbxftfGraI0jsY8fFlzuauzhbW1km6l5xMWPc5HAl2LCdAkTXtSLfy6rHYgE4gqsCwF5VXk6YLKnPQRl7NTgxviqL7+HeWkQV7kTva9tvYVD86s6no73l4xfZYN47bSpXlcSI/A7ti2sItdXRrp3XrhNli+n4tJEM/HCDDbWCuLcxoU86vCUENDOqLA2i4aUCU2dyRsnQnjPlsK7P44JyE/0x+cn+HeYn2gj+Ns4HZ2AFwscctjAHH82xyeW1Ar7VCyE6VtIQ3br/q7SiuTrS2wB1PhhZw== 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=u8HZG3niagmsTeTctA7V+r0+3itx1M7hof51l6Qxbtk=; b=ideAQRiln4bGBbLJiGF5KrxFbI/lm3OqPrjcWVMnkhdejrkVQv/eR9uNIfmTqCHfRNGSP6U+C4BXFEL6MsFclJlhYgz4LSugExvZsNrh6NcWXxRQrqqI8A3GEUrtnKQF03CERElmGqwIqSlWCmxC7+nSVqB8E4jDXoHRsQv/estVq/2lUcTWZJobLKkAYXNffooX7ZTss3iSb/qsBzg0RlWyzO8h+ozpxyyXXnDKfnk1nQb7YH7WhG3yqHvCINl21ktAuXTRNFCEQgocFQbl2pAlqyWW016t9FA+fYkkqvqa5+dLBjz7/JU1bGB1AUeVyDJmka9GlYXY8IzQoKa51A== 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=u8HZG3niagmsTeTctA7V+r0+3itx1M7hof51l6Qxbtk=; b=W45JZEN6bX3/kZWs2AJiYm7pg++j1kIZdQO3O/C4cdug1s+Rdsxlp4LlD55B9vrQMrrDxgTmATtSPatwBvtCbRbgIAk893uCfbADZbs0ZR+JTJmPreXEu39a8P1DAnKbsJXSKwMkWvpHepkNMPzHdR5kiPjq0Z4YYX4e7tl0rRA= Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by DS7PR10MB4830.namprd10.prod.outlook.com (2603:10b6:5:3ac::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6544.19; Fri, 30 Jun 2023 15:07:02 +0000 Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::22c4:9389:291e:aeae]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::22c4:9389:291e:aeae%7]) with mapi id 15.20.6544.019; Fri, 30 Jun 2023 15:07:02 +0000 From: Drew Adams To: "bug-gnu-emacs@gnu.org" Subject: 28.2; doc string of `text-property-search-forward' Thread-Topic: 28.2; doc string of `text-property-search-forward' Thread-Index: AdmrZD2Lv+hCjMZiRnCHJmLUStm2bQ== Date: Fri, 30 Jun 2023 15:07:02 +0000 Message-ID: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|DS7PR10MB4830:EE_ x-ms-office365-filtering-correlation-id: 915ad65c-bf45-449b-877d-08db797ba906 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: BXzlxuC0Yu/POXfUcbUgJznKX8wMBv4vnNpgLsRufZ6XIOG6lZSgzSIV6mii1qo3yiJ71c2BQTKTv/JJLVrnT8dQcQhu66CmEpshbjVoH/OC2qOqYB5+pRG2hfGYFCUciHWNeYGln9HnpFqYGPB3oH8pcBNzFil1apFVSjSZ4umcFo4cEXwUhEE/+0W3i1qTn9LLw4z0r1rrueYB68zFOVINfAMt3g/8LYuuLKCakJxrw7rjFT3F74zi6B7BTrHOvBvar3Xg2wJ5YMQ+SyHPHRt00bQDlG3anD1LNmTC8j6A0iPu3SypFOMg5UJzrggGUV8WyAz4ahVmv08G2LqS78oYDUrYUZOldVuezQfUzz54ClNcqWVwBMatCSrN4RGgvoKPIWCq9t5Lr5WaN3eXKuVjw8FPZYHl2fyyYe6HqTOyWzhiXQPA2upsVaXed00jX/fAlMDp70mNe/g8x76mwFaEvB9oVn2YjXvcYj1WTk6mue6QF7Rn400qX3GXd+/9g8cV/MAS+Zoju/xjnCgc7kbOxsl0UsAysku0bR5sd1Ly231P8RyCz6gn9JH+xYFB0lEgrzv30Byuz2nJEdREvP/ByyDduwYJiTnXULw9HE8koKPFG6ooNRMNbPo0W17hmCFeCO7ONKWec9U3ymTSag== 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:(13230028)(396003)(376002)(346002)(366004)(136003)(39860400002)(451199021)(52536014)(86362001)(45080400002)(71200400001)(8936002)(8676002)(5660300002)(26005)(9686003)(6506007)(44832011)(33656002)(7696005)(478600001)(66946007)(66556008)(66476007)(66446008)(64756008)(6916009)(41300700001)(76116006)(316002)(186003)(38070700005)(2906002)(4744005)(83380400001)(55016003)(122000001)(38100700002)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?uc7t99TGy6Dy6JVIhRLpGvsa+UWKRddh0b1rq+RXa+hkr5yO8Xtxw5qsgBVg?= =?us-ascii?Q?bXDVa91tSO9xXiczrwbdmNWxPjS6o6itmqaJlcqMEizp7X8gVR4O+rsESn32?= =?us-ascii?Q?yRfBZh5C0xm4YDh9hZ0TFPCItu4J/tbvFo0rJv0flVR2x6tb/CkR3ctFcn/x?= =?us-ascii?Q?s5u1HzzhowQc9pXt1OWNdOpgi58JnZ36FQ1TaHfCvDjaW0JxviFbi72UVyTZ?= =?us-ascii?Q?bJX/KPAShgfeW5mzTgy0hTaId1Hfif+osT4FA8TCdahj6BPT1bPKA7pAiMyK?= =?us-ascii?Q?5G5CcB14IeGpZ3ZnV7WIL2redao+k9/MNdXGFvClMa987ka81lhcbsAr5vaa?= =?us-ascii?Q?J1OejxjamtjJ6RCyob9f8auuvj+Md/oGG0OWxY91o6zSUVzj8pG6HLEtIpp+?= =?us-ascii?Q?i/zGz20Ghl2v7ebmiiMWCx67aNtPqvWlqUYqPTB88gdx1S7d6odQP4EPKGJk?= =?us-ascii?Q?TuQD01gQgd+rSXbwzZ/PU+Hu+Vzd+dw7AIN2o10V/IB5nhvG6cTKEYU2qoUL?= =?us-ascii?Q?zcxWl3KggHuSCUjck5Cldnw1k/UGhOR9KBHVhah9F+KdAeakYj4ocMfAV6bX?= =?us-ascii?Q?ZaAjPhhSMfQHm7wlswpX793ilw6uSP1S90yb4IfyJI7zX1UWpdS8SSeqPSJk?= =?us-ascii?Q?wNAr5cQ3qPy384vw94YGOZEG1wWqcrsHkJdVc1TdAjVWWQO2Us2o1r1YekTs?= =?us-ascii?Q?LJkJIeyXTff46HtmZ9sd3kkdwzsdNbjSkqbg9UUe1SVFyoAOMcNjD1lq3mVt?= =?us-ascii?Q?zJIgyB6RWitW3bUwZxak6H/Zw0vXYYLEcqdNgLg9NZCsNiQZZi+iIpTz51yi?= =?us-ascii?Q?Fi0lJRjaotCLnaOZJruXm++AhCL5BZU0wCMtlneGmdTXNNUoOhtQPAfHVtFR?= =?us-ascii?Q?LwQb8JIO6OUF3be2nqCLbORuSYZ4GPB+yqvAayiL9iXAFiubjJn3w08HP8Ud?= =?us-ascii?Q?t5d7AHuTjN9NtTicXsD3nfy2lbqlu0nxoLjg2dHtK00G4A46hIttnMnq/UAS?= =?us-ascii?Q?PRc8/cJI/mLxgsea7wXu0o8XManwL46y7620B5KhII2d5AAUmjpGW5H8L+3H?= =?us-ascii?Q?SU6irweAEUHhtXPTs7xJI1zXJU+mdFavhSQH4eb2KgIh4BIwBC3LRDUF7IfX?= =?us-ascii?Q?BDkGJA8KWUsr3cvcryNCZ/iPW+WGvrxEZQGZtol8JuNMDSYVOf9PLpSbbcav?= =?us-ascii?Q?bpHHrPrMd3nuz0A3E7/dbr6mY8ZyNVjtOhxEhtY9eTHmexpuFkjn2vmXKG95?= =?us-ascii?Q?zh9zga6q5ZeygbyXN15efE4RabN2U5cjv9paQSemvkmHfI675HfHisapldRv?= =?us-ascii?Q?zpHRi88p8N5jToBrK+JbYKNb6vMEyxQmZ5/e8WJEBgntxZWBEH2UZtOKLvg+?= =?us-ascii?Q?ejiBp5gKS1brMXZHxJq8NUXE67Y86GDvc1l+SsYnlzKi2ufVszp4Vj4661tm?= =?us-ascii?Q?Y9EFU4YQxiXjttWAL31X+0McES7qy3WGi4sMIUq2KaGVr/c9FVuO7g9SgLkv?= =?us-ascii?Q?NOCdLWjGwDQGQacJqeFc0F5wX5+75Kui1szFxvUQgBFaquHw4+AlqkslXtB8?= =?us-ascii?Q?h8A/0lSg7+pWVC0gh2zxd4SFANq2UFHk0ucXJxhC?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: CPbc5GxByPPA0R/IVoDqAMUCRcjOarZT/1HyXkZIaw6c+9Vb9aVS7YWPAEmTG7XLxIh8A9lkPQ35mavKn1WisL4xW5Gy/2a97HC9KbdFNtAl1OdkNgC3lxzKAvCCstia6SCmGC73LZWCfl0JibyLFVJzpDWgbkMxJnzNUMpxRbkEjHBnpeVuT2aDVeO+shaAQmUKqLlNGCtjaEHhlXYDUUx85SFKOG/8jLDEq/J2Gj2kBg51FP8fw5Kz6mnxcOshGeyrR7IRVV+ix/5ozdeKh0/b6SMDobpcnayg7HG+TeV7N/KhRYzMxzi6Zt771xKGwbNX8dD7hymQawjStOWXaU+ea76GpHC+iLXTmHyk9qtW0gLSvj4hFm1CGCor+RF659p1IZCWzYEXLK8TMDxs33xbZE+POt842crr4ZbRvZOkAV/Rjq/NrGS2uumkKIomkhPuyoYJAVnYJiPH5DAR1w0M1/jBlJRKEus+51lyQ3iFJy3CEhg5RhXo2RohMdq3Mod/oiK8Cx1o7z0zmuXcIml0xC0jbyb/qLphlyNCL1+KFTYIUQUtPsydpElYkuGvS95S+B2HEbE8EJCGxCdjqNd/h9d2f56ZyJ4YmjzjN2rZCEDSVAq/8DK8lbr31KWp7RQLsNhduoq+beSR146Zh+aYKDj35HbYyaLlKjrCTjXkarKV/HwwxpOjNBoKHGvKdLVm0Xw9qolJnd3Y4frm5HXmXbQ4MR0xQj+8abt8kwVDprShQnqnv2/l9fTkQelu 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: 915ad65c-bf45-449b-877d-08db797ba906 X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Jun 2023 15:07:02.6591 (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: OEqkTW80Rs/Qzorx5cwktf/bdzzu3F9dy9DyQlKUUZf0fy8dijOXvwY8bKmodVh2EK4pvR/N/e/IOIvokceNJA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS7PR10MB4830 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.254,Aquarius:18.0.957,Hydra:6.0.591,FMLib:17.11.176.26 definitions=2023-06-30_05,2023-06-30_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 spamscore=0 mlxlogscore=661 malwarescore=0 phishscore=0 bulkscore=0 suspectscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2305260000 definitions=main-2306300128 X-Proofpoint-ORIG-GUID: c4XNIjw75wY9EgTPf8NmT7r2FDm6_g5C X-Proofpoint-GUID: c4XNIjw75wY9EgTPf8NmT7r2FDm6_g5C 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_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) The signature is this: (text-property-search-forward PROPERTY &optional VALUE PREDICATE NOT-CURRENT) The arguments should be described in order. But the first line of the doc string - the most important - says this: Search for the next region of text where PREDICATE is true. Not only is PREDICATE optional; it is not even the first optional arg. The first line should describe the _default_ behavior (nil VALUE, nil PREDICATE). Something like this: Search forward for text where PROPERTY is non-nil. Then go on to introduce, first VALUE, then PREDICATE, then NOT-CURRENT. In GNU Emacs 28.2 (build 2, x86_64-w64-mingw32) of 2022-09-13 Windowing system distributor `Microsoft Corp.', version 10.0.19045 Configured using: `configure --with-modules --without-dbus --with-native-compilation --without-compress-install CFLAGS=3D-O2' From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 01 05:32:18 2023 Received: (at 64367-done) by debbugs.gnu.org; 1 Jul 2023 09:32:18 +0000 Received: from localhost ([127.0.0.1]:56578 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qFWxm-00075f-Hk for submit@debbugs.gnu.org; Sat, 01 Jul 2023 05:32:18 -0400 Received: from eggs.gnu.org ([209.51.188.92]:52366) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qFWxk-00075R-K1 for 64367-done@debbugs.gnu.org; Sat, 01 Jul 2023 05:32:17 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qFWxe-0002Ya-Lz; Sat, 01 Jul 2023 05:32:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=vDrdXl1WraA/zeUeT+ErKb9j/K25y6rdBacGMck/+bQ=; b=n3hal3eTwv9D 1zS+1smRHt9H8FoGFiJIwAbrM0yZiKS+QJelm5G9bOHT204WVe11Z1HvSEu+yy7eo4LWJCfAjcw8X YjwjsV/QyWvROJTteVWlhzr2xa3pho1ugOq/sHmWTBlAYh/eOXp7QqL/J3J7abuKTNOYk2voRxDB3 tItP0RLIsh8csdqan7e7aIkp4gioZescHV5XL5FEzc0LXlwv/jbYxTgBRHd9eA3lAJAvD8HqgGqur dHoETldwlNzpdKo/IIajbmQTyU/KSnIoB9KCRh+etfU0emJIhcTIKk/uP2CFTmgD8VxuFN+GtFqan McQSu+fnvwW+LQaZujo4EA==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qFWxe-00028s-2P; Sat, 01 Jul 2023 05:32:10 -0400 Date: Sat, 01 Jul 2023 12:32:41 +0300 Message-Id: <83cz1cq8na.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-Reply-To: (message from Drew Adams on Fri, 30 Jun 2023 15:07:02 +0000) Subject: Re: bug#64367: 28.2; doc string of `text-property-search-forward' References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 64367-done Cc: 64367-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Drew Adams > Date: Fri, 30 Jun 2023 15:07:02 +0000 > > The signature is this: > > (text-property-search-forward PROPERTY > &optional VALUE PREDICATE NOT-CURRENT) > > The arguments should be described in order. Only preferably so. It is not always possible to do so, and thus it is not a hard requirement. In this case, I see no way of describing the arguments in order and still producing a useful doc string, let alone its first line. > But the first line of the doc string - the most important - says this: > > Search for the next region of text where PREDICATE is true. > > Not only is PREDICATE optional; it is not even the first optional arg. > The first line should describe the _default_ behavior (nil VALUE, nil > PREDICATE). Now fixed on the emacs-29 branch. > Something like this: > > Search forward for text where PROPERTY is non-nil. This loses information and is also inaccurate, so I used a different text: Search for next region of text where PREDICATE returns non-nil for PROPERTY. Closing. From unknown Mon Aug 18 11:11:41 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 29 Jul 2023 11:24:12 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator