From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#39848: 26.3; Provide better help for menu-bar, e.g., Options > Line Wrapping in This Buffer Date: Sat, 29 Feb 2020 16:46:39 -0800 (PST) Message-ID: <62a1ef4d-e9fa-4757-977d-dcb9d3e4aa52@default> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="7060"; mail-complaints-to="usenet@ciao.gmane.io" To: 39848@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Mar 01 01:47:11 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 1j8ClD-0001j1-PN for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 01 Mar 2020 01:47:11 +0100 Original-Received: from localhost ([::1]:37126 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j8ClC-000592-Ej for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 29 Feb 2020 19:47:10 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44037) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j8Cl5-00058r-Cd for bug-gnu-emacs@gnu.org; Sat, 29 Feb 2020 19:47:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j8Cl4-0001iX-CY for bug-gnu-emacs@gnu.org; Sat, 29 Feb 2020 19:47:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57858) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1j8Cl4-0001iT-9c for bug-gnu-emacs@gnu.org; Sat, 29 Feb 2020 19:47:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1j8Cl4-0006RK-7F for bug-gnu-emacs@gnu.org; Sat, 29 Feb 2020 19:47: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: Sun, 01 Mar 2020 00:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 39848 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.158302361124736 (code B ref -1); Sun, 01 Mar 2020 00:47:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 1 Mar 2020 00:46:51 +0000 Original-Received: from localhost ([127.0.0.1]:35598 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j8Ckt-0006Qt-0T for submit@debbugs.gnu.org; Sat, 29 Feb 2020 19:46:51 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:49373) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j8Ckr-0006Qm-Qa for submit@debbugs.gnu.org; Sat, 29 Feb 2020 19:46:50 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44012) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j8Ckq-00055m-DR for bug-gnu-emacs@gnu.org; Sat, 29 Feb 2020 19:46:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j8Cko-0001dA-Qs for bug-gnu-emacs@gnu.org; Sat, 29 Feb 2020 19:46:47 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:37642) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1j8Cko-0001a6-H1 for bug-gnu-emacs@gnu.org; Sat, 29 Feb 2020 19:46:46 -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 0210jGc7126292 for ; Sun, 1 Mar 2020 00:46:43 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=hiJkMHfOBdFiLRV23yvI1eZ3LQkdDPPAoUUeH7rLTnw=; b=VZNIV22PI/vKa/XlssY3zZ/XlE7KsPeDdRkRd1G8eQHR+GBpeNPhOX5N+RBcopX+Iumu mc2nJG7FTBhnaNuPBCxo0zgb/yZErrspSFl7kovHnD/0LXpzulxuSsugJAnVJfqoye3i AAQAyvjyvHQCAFJBGWG0rocubKoH9QDA8v3hqeem3VsSe0jaq3Fvq/homT7pp5BKKdFH +9ifb7iz2WjL+vyDiKj1ycZrBbf7Ld6jRE+Cxn4WYZxxT3RCqdkRDaWv0VgV114Fn+bH Hbxa6GtHw8IyV2xeGvUJkzFlSGSfwGgz7hl8l29NcAY45c+V5OvHl31Be24wBSZeaPz+ xA== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2120.oracle.com with ESMTP id 2yffwqa4k0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 01 Mar 2020 00:46:43 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 0210iUgG004204 for ; Sun, 1 Mar 2020 00:46:43 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserp3020.oracle.com with ESMTP id 2yg1r9dtq0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 01 Mar 2020 00:46:42 +0000 Original-Received: from abhmp0010.oracle.com (abhmp0010.oracle.com [141.146.116.16]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 0210keoX016913 for ; Sun, 1 Mar 2020 00:46:42 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4966.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9546 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 mlxlogscore=843 suspectscore=0 malwarescore=0 adultscore=0 spamscore=0 phishscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2001150001 definitions=main-2003010001 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9546 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 lowpriorityscore=0 spamscore=0 impostorscore=0 malwarescore=0 mlxlogscore=906 mlxscore=0 suspectscore=0 phishscore=0 clxscore=1015 bulkscore=0 adultscore=0 priorityscore=1501 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2001150001 definitions=main-2003010001 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:176709 Archived-At: emacs -Q C-h k As one example, choose from menu-bar: Options > Line Wrapping in This Buffer > Wrap at Window Edge Buffer *Help* shows this: runs the command #[nil = "=08\203=08\0\300\303!\210\304 \205\0\305\306!\207" [visual-line-mode word-wrap truncate-lines 0 nil toggle-truncate-lines -1] 2 nil nil] (found in global-map), which is an interactive compiled Lisp function. It is bound to . (anonymous) Not documented. That's nearly useless. It doesn't take advantage of Emacs or Lisp. 1. Please provide named commands for all Options menu choices. 2. Please try to have *Help* point to the file that defines those commands. 3. Please keep byte-compiler gobbledygook out of Emacs help. Consider this reasonable question, as one point of departure: https://stackoverflow.com/q/60468217/729907 Yes, there's no satisfactory one-word answer to that user's question, but s?he should at least be able to more easily track down the code that provides the option behavior for the current buffer. As it is now, it's not even obvious that the code is in menu-bar.el. 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''