From unknown Mon Aug 18 11:32:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#44582: 26.3; doc strings of functions `isearch--state-*' are too long Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 11 Nov 2020 18:40:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 44582 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 44582@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.160511998821897 (code B ref -1); Wed, 11 Nov 2020 18:40:01 +0000 Received: (at submit) by debbugs.gnu.org; 11 Nov 2020 18:39:48 +0000 Received: from localhost ([127.0.0.1]:42832 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kcv24-0005h7-2n for submit@debbugs.gnu.org; Wed, 11 Nov 2020 13:39:48 -0500 Received: from lists.gnu.org ([209.51.188.17]:47930) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kcv21-0005gx-8X for submit@debbugs.gnu.org; Wed, 11 Nov 2020 13:39:47 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:44894) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kcv20-0000f0-Rf for bug-gnu-emacs@gnu.org; Wed, 11 Nov 2020 13:39:44 -0500 Received: from aserp2120.oracle.com ([141.146.126.78]:60982) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kcv1s-0008IG-G1 for bug-gnu-emacs@gnu.org; Wed, 11 Nov 2020 13:39:44 -0500 Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 0ABIY1jP002689 for ; Wed, 11 Nov 2020 18:39:34 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=dSnzqzcHYfJWtPG54VvNBcJPv6CRpmJ6YD/UW2KaLbg=; b=CDFvMQNdAk7zXTSnLug+ZbgBqSfiagLRuR7kGvwReTp/J/92Je98qwokh+DEXbWjX7gF CDNHHs/1fD2ydFyzwIJ9T4jiwP2kju/mrGlDxBOXgrxfdsNtRxrdTK+JvyeCRBplFmS9 p8ZzgIDKhsSRtJjN4ymvUXqP9QgSs4PRbg3cJbr/ccntraUyt3es1s540w9bI582gZoK SsoxmZk31bLhVh/uvRPuIm2Hok6BOxxpUWl0+WyKBUkBwjI+2HF3GtpS+AQFzeUTDCDw 8GWbXefPMZNQIRc9P1t9lwnj0/iiUGNYCAl2FvLhqeNtimb3r9908NHCEcXcdLG6plu5 lg== Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by aserp2120.oracle.com with ESMTP id 34nkhm24vh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL) for ; Wed, 11 Nov 2020 18:39:34 +0000 Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 0ABIZFqB169848 for ; Wed, 11 Nov 2020 18:39:34 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3030.oracle.com with ESMTP id 34p55q9pyy-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 11 Nov 2020 18:39:34 +0000 Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 0ABIdWXK000643 for ; Wed, 11 Nov 2020 18:39:33 GMT MIME-Version: 1.0 Message-ID: <74141d8b-994e-4c89-a810-322f70a54759@default> Date: Wed, 11 Nov 2020 10:39:32 -0800 (PST) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5071.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9802 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 spamscore=0 phishscore=0 mlxlogscore=999 mlxscore=0 malwarescore=0 bulkscore=0 suspectscore=1 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2011110109 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9802 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 priorityscore=1501 mlxscore=0 suspectscore=1 mlxlogscore=999 lowpriorityscore=0 spamscore=0 malwarescore=0 adultscore=0 clxscore=1015 bulkscore=0 impostorscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2011110109 Received-SPF: pass client-ip=141.146.126.78; envelope-from=drew.adams@oracle.com; helo=aserp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/11 13:39:35 X-ACL-Warn: Detected OS = Linux 3.1-3.10 [fuzzy] 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, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) 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 (--) For example: `C-h f isearch--state-case-fold-search': isearch--state-case-fold-search is a compiled Lisp function in 'isearch.el'. (isearch--state-case-fold-search CL-X) This function has a compiler macro 'isearch--state-case-fold-search--cmacr= o'. Access slot "case-fold-search" of `(isearch--state (:constructor nil) (:co= pier nil) (:constructor isearch--get-state (&aux (string isearch-string) (m= essage isearch-message) (point (point)) (success isearch-success) (forward = isearch-forward) (other-end isearch-other-end) (word isearch-regexp-functio= n) (error isearch-error) (wrapped isearch-wrapped) (barrier isearch-barrier= ) (case-fold-search isearch-case-fold-search) (pop-fun (if isearch-push-sta= te-function (funcall isearch-push-state-function))))))' struct CL-X. This function does not change global state, including the match data. That "Access slot" line is 517 chars long! Lest you say that no one should ever consult the doc of an "internal" function (with which I strongly disagree, anyway), consider a command that shows you, as completion candidates, doc strings of all function names matching your input. `apropos-function' itself compensates, by filling the value. But we have a convention about doc-string line lengths, and 517 chars is, well far beyond the limit. 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.18362 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From unknown Mon Aug 18 11:32:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#44582: 26.3; doc strings of functions `isearch--state-*' are too long Resent-From: Juri Linkov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 12 Nov 2020 07:35:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 44582 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 44582@debbugs.gnu.org Received: via spool by 44582-submit@debbugs.gnu.org id=B44582.16051664909976 (code B ref 44582); Thu, 12 Nov 2020 07:35:02 +0000 Received: (at 44582) by debbugs.gnu.org; 12 Nov 2020 07:34:50 +0000 Received: from localhost ([127.0.0.1]:43470 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kd785-0002ap-Uk for submit@debbugs.gnu.org; Thu, 12 Nov 2020 02:34:50 -0500 Received: from relay9-d.mail.gandi.net ([217.70.183.199]:52567) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kd783-0002aT-Hd; Thu, 12 Nov 2020 02:34:48 -0500 X-Originating-IP: 91.129.97.46 Received: from mail.gandi.net (m91-129-97-46.cust.tele2.ee [91.129.97.46]) (Authenticated sender: juri@linkov.net) by relay9-d.mail.gandi.net (Postfix) with ESMTPSA id F00A5FF802; Thu, 12 Nov 2020 07:34:38 +0000 (UTC) From: Juri Linkov Organization: LINKOV.NET References: <74141d8b-994e-4c89-a810-322f70a54759@default> Date: Thu, 12 Nov 2020 09:27:15 +0200 In-Reply-To: <74141d8b-994e-4c89-a810-322f70a54759@default> (Drew Adams's message of "Wed, 11 Nov 2020 10:39:32 -0800 (PST)") Message-ID: <87k0urujak.fsf@mail.linkov.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) 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: -1.0 (-) tags 44582 fixed close 44582 27.1 quit > For example: `C-h f isearch--state-case-fold-search': > > That "Access slot" line is 517 chars long! > > In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) This has been fixed for a long time in the released version 27.1, but you are still reporting bugs for the old version.