From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#38736: 26.3; ellipsis in `*Messages*', doc of `format' etc. Date: Tue, 24 Dec 2019 13:02:55 -0800 (PST) Message-ID: <006e6244-dd0a-46a8-8c61-36744b3216de@default> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="78105"; mail-complaints-to="usenet@blaine.gmane.org" To: 38736@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Dec 24 22:04:11 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1ijrLf-000KCJ-E1 for geb-bug-gnu-emacs@m.gmane.org; Tue, 24 Dec 2019 22:04:11 +0100 Original-Received: from localhost ([::1]:41968 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ijrLd-0003yz-Lk for geb-bug-gnu-emacs@m.gmane.org; Tue, 24 Dec 2019 16:04:09 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44457) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ijrLX-0003xe-5P for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2019 16:04:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ijrLW-0005pu-1v for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2019 16:04:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47142) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ijrLV-0005pn-VE for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2019 16:04:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ijrLV-0004a7-RP for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2019 16:04:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 24 Dec 2019 21:04:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 38736 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.157722138417545 (code B ref -1); Tue, 24 Dec 2019 21:04:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 24 Dec 2019 21:03:04 +0000 Original-Received: from localhost ([127.0.0.1]:53115 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ijrKZ-0004Yv-Vp for submit@debbugs.gnu.org; Tue, 24 Dec 2019 16:03:04 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:44914) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ijrKX-0004Ym-U3 for submit@debbugs.gnu.org; Tue, 24 Dec 2019 16:03:02 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44414) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ijrKW-0003v0-P3 for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2019 16:03:01 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ijrKV-0005eM-7z for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2019 16:03:00 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:34386) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ijrKV-0005dp-0g for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2019 16:02:59 -0500 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xBOL0iRR067211 for ; Tue, 24 Dec 2019 21:02:57 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-2019-08-05; bh=fEUwRnS1o20/vgjuOBg0XGbDmoqFyWqb1sAZPi7LuLo=; b=Yj5kPOSgSrau05GDdusRdosY3zy7lscv75awXQhFixHGUwA+hQT2J9QPM2SdXSzJHPX/ xbCufnua9D3Gv3hrryIxg7ybDwK3jXnnN7VStEyXRu2k8YeNCBafq48L2QnDyuSQLbvD BYkq+5m2rQW4/KfoK87P4Lt868zj7F34mAMa7eeNd2kKy0VFaoiyepf9/YPwUrnyp3x9 kZRQ2vDiL1n+1lxJYQ/SkFM4XSHnjl4pUCY6C0EAXcPa8cX5K1m6dcqezAweC0rFAIG0 aqxHVoEKl4156xnjIZnQuO1zEPVYRPVw0jFuHidOcBl74k7CM2ervC63IJo8uQS2qAoH wQ== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by aserp2120.oracle.com with ESMTP id 2x1bbpw044-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 24 Dec 2019 21:02:57 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xBOKwKgl040131 for ; Tue, 24 Dec 2019 21:02:57 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserp3030.oracle.com with ESMTP id 2x37tedrh0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 24 Dec 2019 21:02:57 +0000 Original-Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id xBOL2tNQ029092 for ; Tue, 24 Dec 2019 21:02:56 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4939.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9481 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1911140001 definitions=main-1912240185 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9481 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1911140001 definitions=main-1912240185 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:173726 Archived-At: The doc string of `format' doesn't tell you anything about control by `print-level', `print-length', etc. Please consider adding such info. Consider trying to figure out, when looking at a message in `*Messages*', why a long list value shows ellipsis ("..."), instead of showing all the elements. You try `C-h f message', which says nothing about this. The most it does is provide a bunch of details about the formatting intermediary `format-message', imposed since Emacs 25. Are details about %, `, and ' so important for `message' that they merit a paragraph, but `print-level' and `print-length' are not so important? (What's more: the doc string for `message' goes into more detail than=20 the one for `format-message', which doesn't even mention %, even though the former tells you to refer to the latter "for details".) Following the `format-message' link, you still get no clue about this, but you then follow a link for `format'. There you still get no clue about it, but you see that %S uses `prin1'. Following the `prin1' link you finally find out that you can control `message's use of ellipsis using `print-length' and `print-level'. Users shouldn't have to go through all of that (and that even assumes that they are able to guess that following just that thread might get=20 them somewhere useful). What's true for `message' is also true for `error', etc. At least the doc of `format' - and probably its often-used callers, such as `message' - should specifically mention these "print"-controlling (really just formatting) variables. 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.17763 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''