From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#32885: 26; doc string of `bindings--define-key' Date: Sun, 30 Sep 2018 08:26:20 -0700 (PDT) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1538321111 15186 195.159.176.226 (30 Sep 2018 15:25:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 30 Sep 2018 15:25:11 +0000 (UTC) To: 32885@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Sep 30 17:25:06 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g6daj-0003qY-Lm for geb-bug-gnu-emacs@m.gmane.org; Sun, 30 Sep 2018 17:25:05 +0200 Original-Received: from localhost ([::1]:55837 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g6dcq-0003XZ-2f for geb-bug-gnu-emacs@m.gmane.org; Sun, 30 Sep 2018 11:27:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56391) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g6dcf-0003XE-Ol for bug-gnu-emacs@gnu.org; Sun, 30 Sep 2018 11:27:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g6dcc-0000FT-KK for bug-gnu-emacs@gnu.org; Sun, 30 Sep 2018 11:27:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:55863) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1g6dcc-0000FO-Gh for bug-gnu-emacs@gnu.org; Sun, 30 Sep 2018 11:27:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1g6dcc-0005dm-Cg for bug-gnu-emacs@gnu.org; Sun, 30 Sep 2018 11:27:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 30 Sep 2018 15:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 32885 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.153832120721653 (code B ref -1); Sun, 30 Sep 2018 15:27:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 30 Sep 2018 15:26:47 +0000 Original-Received: from localhost ([127.0.0.1]:60121 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g6dcM-0005dB-Jk for submit@debbugs.gnu.org; Sun, 30 Sep 2018 11:26:46 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:46720) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g6dcK-0005cw-FW for submit@debbugs.gnu.org; Sun, 30 Sep 2018 11:26:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g6dcD-0008LS-AL for submit@debbugs.gnu.org; Sun, 30 Sep 2018 11:26:39 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:44526) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1g6dcB-0008Ky-Vg for submit@debbugs.gnu.org; Sun, 30 Sep 2018 11:26:37 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56324) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g6dcB-0003V6-8b for bug-gnu-emacs@gnu.org; Sun, 30 Sep 2018 11:26:35 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g6dc6-0008Jn-Q7 for bug-gnu-emacs@gnu.org; Sun, 30 Sep 2018 11:26:35 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:37502) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1g6dc5-0008JJ-Pf for bug-gnu-emacs@gnu.org; Sun, 30 Sep 2018 11:26:30 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w8UFNq3a186810 for ; Sun, 30 Sep 2018 15:26:28 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-2018-07-02; bh=mHJf7DhXtx2/P+U4g9GfxFMFtK9NTbgMlso1kCc+LDA=; b=p6X4cdt9gf00oMh3Zu6n8DCKJXneJG0RY06t511g9/VS/K5TMLO2yD6+upS7nzzgHLag CmTL4hVRFl94fnRM3HiMBQj5aDt8KNd+NNX4iB2xQ0TaNj9MfKaw1hMloaDWqmvppxSA ixLuTPnI1+q1smzmkC18EmamXSp/moB7q31+AFy9KuFWYY4I5U01yAoCCqts7WmbybpV lIiINBgJYuG/LtrceifFefZy06xmdhn3Fd3nFb8Wn7dxcssCelmnnDPFKyYahUdEXvlY yjrFcoGO/eo9F2SBRcFdKuSkB5rEgmIdqMdRwxn0c475rR0jSKtgakCcw3U03DRdkH6Z nw== Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp2130.oracle.com with ESMTP id 2mt0ttbdfm-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 30 Sep 2018 15:26:28 +0000 Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w8UFQM7W003724 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 30 Sep 2018 15:26:22 GMT Original-Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w8UFQLXU007688 for ; Sun, 30 Sep 2018 15:26:21 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4735.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9032 signatures=668707 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=824 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1809300164 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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: 208.118.235.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:150822 Archived-At: Please consider documenting the arguments and describing the function in terms similar to `define-key'. Or at least say that it acts similarly to `define-key' but it "makes as much as possible of the menus pure". The current description makes it sound like it takes a complete menu as arg and returns a new menu that is, if possible, more pure (or that it modifies the existing menu). In fact, it seems similar to `define-key'. In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.16299 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''