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#44582: 26.3; doc strings of functions `isearch--state-*' are too long Date: Wed, 11 Nov 2020 10:39:32 -0800 (PST) Message-ID: <74141d8b-994e-4c89-a810-322f70a54759@default> 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="21612"; mail-complaints-to="usenet@ciao.gmane.io" To: 44582@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Nov 11 19:50:03 2020 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 1kcvBy-0005WP-IX for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 11 Nov 2020 19:50:02 +0100 Original-Received: from localhost ([::1]:60028 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kcvBx-0004Vz-HQ for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 11 Nov 2020 13:50:01 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44920) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kcv2J-0000wx-05 for bug-gnu-emacs@gnu.org; Wed, 11 Nov 2020 13:40:08 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:59519) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kcv2I-0008Pn-54 for bug-gnu-emacs@gnu.org; Wed, 11 Nov 2020 13:40:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kcv2I-0005hj-1u for bug-gnu-emacs@gnu.org; Wed, 11 Nov 2020 13:40: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: 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-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.160511998821897 (code B ref -1); Wed, 11 Nov 2020 18:40:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 11 Nov 2020 18:39:48 +0000 Original-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 Original-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 Original-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 Original-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 Original-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== Original-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 Original-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 Original-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 Original-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 X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5071.0 (x86)] 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-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:193124 Archived-At: 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''