From debbugs-submit-bounces@debbugs.gnu.org Sun Dec 04 12:06:56 2016 Received: (at submit) by debbugs.gnu.org; 4 Dec 2016 17:06:56 +0000 Received: from localhost ([127.0.0.1]:56128 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cDaFc-0003k1-1I for submit@debbugs.gnu.org; Sun, 04 Dec 2016 12:06:56 -0500 Received: from eggs.gnu.org ([208.118.235.92]:40280) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cDaFa-0003jn-18 for submit@debbugs.gnu.org; Sun, 04 Dec 2016 12:06:54 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cDaFT-0003Im-Cx for submit@debbugs.gnu.org; Sun, 04 Dec 2016 12:06:48 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:46623) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cDaFT-0003IP-9h for submit@debbugs.gnu.org; Sun, 04 Dec 2016 12:06:47 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:59484) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cDaFS-0007c0-9w for bug-gnu-emacs@gnu.org; Sun, 04 Dec 2016 12:06:47 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cDaFP-0003Fm-42 for bug-gnu-emacs@gnu.org; Sun, 04 Dec 2016 12:06:46 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:31622) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cDaFO-0003ER-SY for bug-gnu-emacs@gnu.org; Sun, 04 Dec 2016 12:06:43 -0500 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id uB4H6dqd008936 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 4 Dec 2016 17:06:39 GMT 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 uB4H6cSJ030594 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 4 Dec 2016 17:06:39 GMT Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id uB4H6clh023268 for ; Sun, 4 Dec 2016 17:06:38 GMT MIME-Version: 1.0 Message-ID: <45826813-d92b-4769-8ba1-a09c51349b3d@default> Date: Sun, 4 Dec 2016 09:06:38 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 24.5; easy-menu doc strings X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit 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: -4.0 (----) Several doc strings functions refer to the form of the return value of other functions, yet the doc strings of those other functions do not even describe their return values. In GNU Emacs 24.5.1 (i686-pc-mingw32) of 2015-04-11 on LEG570 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/usr --host=3Di686-pc-mingw32' From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 27 07:46:14 2019 Received: (at 25106) by debbugs.gnu.org; 27 Jul 2019 11:46:14 +0000 Received: from localhost ([127.0.0.1]:43774 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrL9S-0007LW-D8 for submit@debbugs.gnu.org; Sat, 27 Jul 2019 07:46:14 -0400 Received: from quimby.gnus.org ([80.91.231.51]:36938) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrL9Q-0007Jf-KU for 25106@debbugs.gnu.org; Sat, 27 Jul 2019 07:46:13 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hrL9N-0007Ac-JN; Sat, 27 Jul 2019 13:46:11 +0200 From: Lars Ingebrigtsen To: Drew Adams Subject: Re: bug#25106: 24.5; easy-menu doc strings References: <45826813-d92b-4769-8ba1-a09c51349b3d@default> Date: Sat, 27 Jul 2019 13:46:09 +0200 In-Reply-To: <45826813-d92b-4769-8ba1-a09c51349b3d@default> (Drew Adams's message of "Sun, 4 Dec 2016 09:06:38 -0800 (PST)") Message-ID: <87r26bittq.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Drew Adams writes: > Several doc strings functions refer to the form of the return value > of other functions, yet the doc strings of those other functions do > not even describe their return values. Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 25106 Cc: 25106@debbugs.gnu.org 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 (-) Drew Adams writes: > Several doc strings functions refer to the form of the return value > of other functions, yet the doc strings of those other functions do > not even describe their return values. What doc strings were you thinking of in particular? -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 27 13:08:25 2019 Received: (at 25106) by debbugs.gnu.org; 27 Jul 2019 17:08:25 +0000 Received: from localhost ([127.0.0.1]:45344 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrQBF-00061l-GX for submit@debbugs.gnu.org; Sat, 27 Jul 2019 13:08:25 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:34796) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrQBE-00061W-Gy for 25106@debbugs.gnu.org; Sat, 27 Jul 2019 13:08:24 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x6RH3jop022816; Sat, 27 Jul 2019 17:08:18 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=AJUsIOjyuqOxP+gcuCV/aKjqYsvaXVyTfvufAUnY6jc=; b=EvS2rrMJH8kiRvbeplH9PZICVYS7E17yQigUDfk8//aqyl0aJ0H/aYjMdstWO2EdIe7U 6ixIJMuhEIVYiIS1FtWkZMYaGwLG0HUODu+cwMpUv5xTWspH8IlQXgtUWpxZTq8q6jbY PxREOqIzstqTEzz1+Ex/gRLdpi0IWP3xeK4Ih0w8N5oh+0PAjHS6WMx3HyquApnckX5Y n5S3LKFs8zoAJ9LJ8degn91VEnI2QaAAxovOvnNio7zkeAXQRvIqxxsr6DNVPIK8ak7x Oqn7bnElbZwFDJRrK87EaNAyZwrPdLCcuu/wrMx+C09Iez1rEZ9QIY9KAzd2dYPor7JE IQ== Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by userp2120.oracle.com with ESMTP id 2u0f8qhj3t-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 27 Jul 2019 17:08:18 +0000 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 x6RH3H5B041100; Sat, 27 Jul 2019 17:06:17 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserp3030.oracle.com with ESMTP id 2u0cnc42u9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 27 Jul 2019 17:06:17 +0000 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 x6RH6Gpn024571; Sat, 27 Jul 2019 17:06:16 GMT MIME-Version: 1.0 Message-ID: <7acd55b6-689a-45bb-917b-0b7cff901c28@default> Date: Sat, 27 Jul 2019 10:06:14 -0700 (PDT) From: Drew Adams To: Lars Ingebrigtsen Subject: RE: bug#25106: 24.5; easy-menu doc strings References: <45826813-d92b-4769-8ba1-a09c51349b3d@default> <87r26bittq.fsf@mouse.gnus.org> In-Reply-To: <87r26bittq.fsf@mouse.gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4873.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9331 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=745 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1907270215 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9331 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=797 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1907270215 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 25106 Cc: 25106@debbugs.gnu.org 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: -3.3 (---) > > Several doc strings functions refer to the form of the return value > > of other functions, yet the doc strings of those other functions do > > not even describe their return values. >=20 > What doc strings were you thinking of in particular? Dunno - that was 3 years ago. Maybe take a look at the easy-menu doc strings? ;-) From debbugs-submit-bounces@debbugs.gnu.org Sun Jul 28 05:56:01 2019 Received: (at 25106) by debbugs.gnu.org; 28 Jul 2019 09:56:01 +0000 Received: from localhost ([127.0.0.1]:45767 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrfuL-0002uv-M7 for submit@debbugs.gnu.org; Sun, 28 Jul 2019 05:56:01 -0400 Received: from quimby.gnus.org ([80.91.231.51]:53130) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrfuK-0002ug-1R for 25106@debbugs.gnu.org; Sun, 28 Jul 2019 05:56:00 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=stories) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hrfuH-0002mP-3H; Sun, 28 Jul 2019 11:55:59 +0200 From: Lars Ingebrigtsen To: Drew Adams Subject: Re: bug#25106: 24.5; easy-menu doc strings References: <45826813-d92b-4769-8ba1-a09c51349b3d@default> <87r26bittq.fsf@mouse.gnus.org> <7acd55b6-689a-45bb-917b-0b7cff901c28@default> Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAGFBMVEUFAQE1GiULBgfm29Rd e7qBlcVaZ5hTQksa/fTYAAACXElEQVQ4jW3STXObMBAGYFm/wFIcdEXbxFzbUROfyazxueXrDObj apGA/n5XMmk9qdfjsfCjdyUEzN3UPNRDXw5hzG5huRmzDhGHAUfEjD7oL0MFoD8W/FJsnbK/Cx1m d+HUYfp0D9oO26d/y67QIzaIl132D8qCvqwvUSFud6cVCizLsig9VDvM4o+3K2RLeS2CdJedWJcG ODrR/4VpHlLetaF7pey8wrGArmu53xp1rwNURw+1xk7q4xRaENBvPXtokiIDXcC1t5A02wVok+oU 62oFKyjgU6yRuyKNVS09jABQGpu8G8OcjHCC/S9B8RpHRW2EyAmsmnsJUaoJ0hlPLhqFMwQS5gxg PwGBeMTKPlfzowdI+gpAWZ8wRYe9W8b3AKoYgSvhIf/Z+UNR5xXehI5k8lia8yud1hjWNkxHRQtK 0R4MAb0Wo5ABNvtikkrRNunqhaDZsoeQ+BhBait8whh6t5oL9yMmFgugtQ0Js2B2kpsAunGcIsL5 zZuhw0GrsEY0Sg0TqPGaIJAi3EfiJs0lwLXV4QOHCZYApQQea2H9tPKwDM5y5cH1wm6kcs7fbk6D xjLtj131Sm5ACOcTTgtlRczpRthSuyaRQigPsQYhxdb3Yuowt5G0yXJ+MS+ME2jJITc0XC6zpfM9 v9I0Rs9WC4AHGm7EVgmZqPxgzJbmAYUgIYhjxjno5QohIhnkLBRnG5f/MOayAocHtlai59qY3wGA DuKZWq2kpTHfWVjEp9hNJT0BgzjmAfzinwR+PfCpb+z/4rRLbe6Ar/ev8LmT2X3t8rkY/AHMjv4U xAw6pwAAAABJRU5ErkJggg== Date: Sun, 28 Jul 2019 11:55:56 +0200 In-Reply-To: <7acd55b6-689a-45bb-917b-0b7cff901c28@default> (Drew Adams's message of "Sat, 27 Jul 2019 10:06:14 -0700 (PDT)") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Drew Adams writes: >> > Several doc strings functions refer to the form of the return value >> > of other functions, yet the doc strings of those other functions do >> > not even describe their return values. >> >> What [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 25106 Cc: 25106@debbugs.gnu.org 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 (-) Drew Adams writes: >> > Several doc strings functions refer to the form of the return value >> > of other functions, yet the doc strings of those other functions do >> > not even describe their return values. >> >> What doc strings were you thinking of in particular? > > Dunno - that was 3 years ago. Maybe take a look > at the easy-menu doc strings? ;-) I skimmed a few, and nothing really jumped stood out. Closing this bug report; if somebody has a specific enhancement request in this area they can open a new one. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sun Jul 28 05:56:19 2019 Received: (at control) by debbugs.gnu.org; 28 Jul 2019 09:56:19 +0000 Received: from localhost ([127.0.0.1]:45770 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrfuc-0002vg-Tr for submit@debbugs.gnu.org; Sun, 28 Jul 2019 05:56:19 -0400 Received: from quimby.gnus.org ([80.91.231.51]:53148) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrfub-0002vX-06 for control@debbugs.gnu.org; Sun, 28 Jul 2019 05:56:17 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=stories) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hrfuY-0002mZ-1A for control@debbugs.gnu.org; Sun, 28 Jul 2019 11:56:16 +0200 Date: Sun, 28 Jul 2019 11:56:13 +0200 Message-Id: To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #25106 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 25106 wontfix close 25106 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control 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 25106 wontfix close 25106 quit From debbugs-submit-bounces@debbugs.gnu.org Sun Jul 28 12:41:13 2019 Received: (at 25106) by debbugs.gnu.org; 28 Jul 2019 16:41:13 +0000 Received: from localhost ([127.0.0.1]:47058 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrmET-0005Ru-36 for submit@debbugs.gnu.org; Sun, 28 Jul 2019 12:41:13 -0400 Received: from aserp2120.oracle.com ([141.146.126.78]:49188) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrmER-0005Rg-Du for 25106@debbugs.gnu.org; Sun, 28 Jul 2019 12:41:11 -0400 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 x6SGe1LG182292; Sun, 28 Jul 2019 16:41:02 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=Myoawid7squOVjFkgW8VQ+ZD/rIZAEvyvOtlYaxFFVs=; b=DJpjHkMhKRHYX/gFl2TrmLUipUMZxpR7HBpKh7uGKqDKUEmv8Szl4yhhP1yGEUWMeiSq UK8VIGQ+2zutfX72yDsyW0h6zJ9zqmILgv6h0briLuOHNpMbPFK4m4r7/WNyy921TN2x ho+VxLRqTIWCEbbYxKauBN8zHnY8VgOCnScsWIBkrTvMGqnFDzNMpNCN/eL0uUzXjChR 5mmt0YcJt1K931Xnl80Pq7rmZorgv/9+ZAUWSfPT5aHzTmVFcorrfJg8Y5JcbMPb2PtF sAF7XXV8qNNyFbG98/2gm9yidMLPqz1ftCEU2wHC1uewMwOyavSHQuu2soNhY2DaisAZ eQ== Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 2u0ejp3r40-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 28 Jul 2019 16:41:02 +0000 Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x6SGc0Sp066130; Sun, 28 Jul 2019 16:41:01 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3020.oracle.com with ESMTP id 2u0dxp2a2y-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 28 Jul 2019 16:41:01 +0000 Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x6SGexPn025154; Sun, 28 Jul 2019 16:41:00 GMT MIME-Version: 1.0 Message-ID: <90eacb4e-822b-4af6-addb-e7d22b68310b@default> Date: Sun, 28 Jul 2019 09:40:59 -0700 (PDT) From: Drew Adams To: Lars Ingebrigtsen Subject: RE: bug#25106: 24.5; easy-menu doc strings References: <45826813-d92b-4769-8ba1-a09c51349b3d@default> <87r26bittq.fsf@mouse.gnus.org> <7acd55b6-689a-45bb-917b-0b7cff901c28@default> In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4873.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9332 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=686 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1907280208 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9332 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=743 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1907280208 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 25106 Cc: 25106@debbugs.gnu.org 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: -3.3 (---) > > Dunno - that was 3 years ago. Maybe take a look > > at the easy-menu doc strings? ;-) >=20 > I skimmed a few, and nothing really jumped stood out. Closing this bug > report; if somebody has a specific enhancement request in this area > they can open a new one. OK, looking quickly at `easy-mmode.el': 1. Doc string of `easy-mmode-defmap' says it defines a constant whose value has the form of the return value of `easy-mmode-define-keymap'. Doc string of `easy-mmode-define-keymap' does not specify the form of the keymap it returns. (And keymaps can have very different kinds of entries.) 2. (Emacs 24.5, which is where the bug was filed, did the same thing for `define-minor-mode': referred to the form of what `easy-mmode-define-keymap' returns. That's since been removed.) Please have the doc string of `easy-mmode-define-keymap' make clear just what the form of the keymap is that it returns. Easy-menu returns a specific kind of keymap, and that's not clear from the doc. From debbugs-submit-bounces@debbugs.gnu.org Sun Jul 28 13:01:43 2019 Received: (at 25106) by debbugs.gnu.org; 28 Jul 2019 17:01:43 +0000 Received: from localhost ([127.0.0.1]:47078 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrmYJ-00062X-3t for submit@debbugs.gnu.org; Sun, 28 Jul 2019 13:01:43 -0400 Received: from eggs.gnu.org ([209.51.188.92]:60420) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrmYH-00062F-TD for 25106@debbugs.gnu.org; Sun, 28 Jul 2019 13:01:42 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:60147) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hrmYC-0004Ib-Gp; Sun, 28 Jul 2019 13:01:36 -0400 Received: from [176.228.60.248] (port=1564 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hrmY8-00086t-I2; Sun, 28 Jul 2019 13:01:33 -0400 Date: Sun, 28 Jul 2019 20:01:16 +0300 Message-Id: <835znmks9v.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <90eacb4e-822b-4af6-addb-e7d22b68310b@default> (message from Drew Adams on Sun, 28 Jul 2019 09:40:59 -0700 (PDT)) Subject: Re: bug#25106: 24.5; easy-menu doc strings References: <45826813-d92b-4769-8ba1-a09c51349b3d@default> <87r26bittq.fsf@mouse.gnus.org> <7acd55b6-689a-45bb-917b-0b7cff901c28@default> <90eacb4e-822b-4af6-addb-e7d22b68310b@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 25106 Cc: 25106@debbugs.gnu.org, larsi@gnus.org 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: -3.3 (---) > Date: Sun, 28 Jul 2019 09:40:59 -0700 (PDT) > From: Drew Adams > Cc: 25106@debbugs.gnu.org > > 1. Doc string of `easy-mmode-defmap' says it defines > a constant whose value has the form of the return > value of `easy-mmode-define-keymap'. No, it says that the constant's value is the _result_ of easy-mmode-define-keymap. It says nothing about the form of the keymap. So there's no mystery to solve here. Would you please learn to accept the judgment of the Emacs developers regarding bug report? All these futile "rearguard battles" are just waste of everyone's time and energy. Please always assume that your arguments were considered in good faith, and the decision, if you don't like it, was not meant to disregard your views in any way, it just disagreed with you. From debbugs-submit-bounces@debbugs.gnu.org Sun Jul 28 14:04:35 2019 Received: (at 25106) by debbugs.gnu.org; 28 Jul 2019 18:04:35 +0000 Received: from localhost ([127.0.0.1]:47108 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrnX8-0000Js-NA for submit@debbugs.gnu.org; Sun, 28 Jul 2019 14:04:35 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:39778) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrnX7-0000JU-Gv for 25106@debbugs.gnu.org; Sun, 28 Jul 2019 14:04:34 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x6SI4RwS155218; Sun, 28 Jul 2019 18:04:27 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=UN9CMKucMebYj2L9h9N2rQ8MmCPrtiK27fG89b3iK8w=; b=VSbZyTm0BVztBugs7s8h79OpuMBC1sO/2Xi12zQr56TGSxqz1qtCS5c9CNJNw05UYLMS 1/BqhpkW7FLFrDBrD4qVbxnt1wedJxbjifTKXivxBIDwGzTExwlC1hIaPooICjZ2T1xB DBbRbcOJyQBWhLCNOQgyq4OahKGPnYvezVx5sOhcLvbRgBrpOs3/4RtCsmhTDNA8RowK nZPrckLwMiCtNFOF/1mYuDMcpLmrwFmst1OUQ0/cCY32mW71X0Jeb1wajjiDTHtLJvE7 CQDBMJUfC7Lt8CMBLlBQn/f5KwPCuU+Cb9Gv22nkI7THnCNVgPsed0BOHbcQLzvjO59J zg== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2120.oracle.com with ESMTP id 2u0f8qksuh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 28 Jul 2019 18:04:27 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x6SI2wTc131928; Sun, 28 Jul 2019 18:04:27 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userp3030.oracle.com with ESMTP id 2u0bqt5fpb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 28 Jul 2019 18:04:26 +0000 Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x6SI4Ptf019888; Sun, 28 Jul 2019 18:04:25 GMT MIME-Version: 1.0 Message-ID: Date: Sun, 28 Jul 2019 11:04:24 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Drew Adams Subject: RE: bug#25106: 24.5; easy-menu doc strings References: <<45826813-d92b-4769-8ba1-a09c51349b3d@default>> <<87r26bittq.fsf@mouse.gnus.org>> <<7acd55b6-689a-45bb-917b-0b7cff901c28@default>> <> <<90eacb4e-822b-4af6-addb-e7d22b68310b@default>> <<835znmks9v.fsf@gnu.org>> In-Reply-To: <<835znmks9v.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4873.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9332 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 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-1906280000 definitions=main-1907280226 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9332 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 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-1906280000 definitions=main-1907280226 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 25106 Cc: 25106@debbugs.gnu.org, larsi@gnus.org 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: -3.3 (---) > > 1. Doc string of `easy-mmode-defmap' says it defines > > a constant whose value has the form of the return > > value of `easy-mmode-define-keymap'. >=20 > No, it says that the constant's value is the _result_ of > easy-mmode-define-keymap. Correct. Which implies that its form is the same. The question raised by the report is how to know what form the returned keymap has. > It says nothing about the form of the keymap. Exactly. That's the problem reported. It invites a reader, in effect, to go check the doc of `easy-mmode-define-keymap'. See if that describes the form of the return value. Going there, you find that there's no description of it (beyond it being a keymap). Your recourse is to go to the code, even though easy-menu returns a specific form of keymap, which its doc could just as well specify. If `easy-mmode-define-keymap' specified the form of the keymap it returns then there would be no difficulty. It doesn't. That's what this request is about: help users by describing the particular form of the keymap. > So there's no mystery to solve here. Mystery, no. Suggested doc improvement, yes. > Please always assume that your arguments were > considered in good faith, and the decision, if > you don't like it, was not meant to disregard > your views in any way, No, of course not. No one said anything about that. I'm sure Lars acted in good faith - never questioned that. > it just disagreed with you. Disagreement about whether the problem should be addressed is normal - a judgment call. People judge things differently. Nothing wrong with that. It's a fact that the form of the keymap returned isn't given in the doc string. The enhancement request suggests that it would help users if it were. I certainly understand that someone can decide that a particular enhancement need not or should not be made. I replied to Lars's request to point out the doc string(s) in question. He looked for that and didn't find it. If that was the reason for closing (as he stated) then pointing out the doc strings (as requested) is appropriate, as is requesting that (given this more specific information) the problem be fixed. There could be other reasons to close the request. I replied to the only reason given so far, saying where the doc difficulty is. Please consider adding the form of the returned keymap to the doc string. Just a request. As for revisiting a closed report: maybe take a look at #25195, which was also followed up on after being closed as wont-fix. The subsequent discussion apparently caused Lars to change his mind. And no, nothing in that discussion put in question Lars's good faith. And yes, we're all appreciative of the work Lars has been doing, revisiting old bug reports. I'm particularly grateful that many of the problems I reported are now getting fixed. Lars is moving quickly and carefully through many, many bug reports, trying his best to quickly decide their fate. I don't think any of us has baked-in, closed opinions - we're all open to new information or new arguments pro & con. This is a process. From debbugs-submit-bounces@debbugs.gnu.org Mon Jul 29 10:51:20 2019 Received: (at 25106) by debbugs.gnu.org; 29 Jul 2019 14:51:20 +0000 Received: from localhost ([127.0.0.1]:48935 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hs6zg-0004PA-5g for submit@debbugs.gnu.org; Mon, 29 Jul 2019 10:51:20 -0400 Received: from mail-io1-f46.google.com ([209.85.166.46]:41378) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hs6ze-0004Ou-FY for 25106@debbugs.gnu.org; Mon, 29 Jul 2019 10:51:18 -0400 Received: by mail-io1-f46.google.com with SMTP id j5so116458990ioj.8 for <25106@debbugs.gnu.org>; Mon, 29 Jul 2019 07:51:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=eFUh0twKcVltprIrKgSy/+wf/FuQpQnl29PDhg7jYpE=; b=q64L+QXLv0uv9VlVI0I5gtPCVEvSqTbEKt/0P9UR8jpM3/gyGKSt/TbPUa4ZuRQcWO znCJ8t5mxTNC19XnI8UwUkQ+txrTMnEEXlBG3JlSGfep3fJIJhHWPHzpJvp4k19wTiXX PASY2jEPPhNf08wJWhH4KIFGuaHi5Dwu4IGLmQm6RMJ/zPWocY1P8WgMeMv+orf93LSV I1tKvxfgizgfU9nAYwFj74lT79kg+PBRAdCV1neHCjiVrSpT0W0mTTdI0DJ22zVzpznc tX2g+9mFL1p+fXpQGfuazjaLXlD73GRmQ3MOcP7jGIBCY7niPF6+zX4Gj1xK3hyv13tN HM4w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=eFUh0twKcVltprIrKgSy/+wf/FuQpQnl29PDhg7jYpE=; b=CRl36U/B91ETMSuHPrYX8dc/evW348EPpMXVxs1lqyAe8aOq0QYEru/+IMLJiz/hBQ bCLM5Wi/+SBAukkBR2nncdjOyUKDCoTUo510i4kn0rjojCO5dL51oLc9Kn+Y+S04zFCE hYcJorNo6AH9UiXm4PoAGLeJ3boqdkOGzFApi9Yre2lLiwwM3tLMTmXBZc8ZkrHmU31/ 6qyOLuucvfVnIykcHVYCLz0aH/vEdmX1Fg4EyJoKMJI4Jxr4hA3gYCv6uUqdIZBFsnzP jjZlt6Bf3oc/MLRenE29QJ7+z0N1DxoHMk3MCRtpPmaxqkJeggvbePL36Czho2jIu+Gi eGtA== X-Gm-Message-State: APjAAAWPfyoVsRPQDOo8MIZO7n0lqmtviCbXBDLwuBj5o6degz6pWJjI jl9G9QQRAlw7Pl9wV2otLp8= X-Google-Smtp-Source: APXvYqwJiMXmZDwvAf13IDiEN52oLlJBRvegAxh4sBEusz+/Wmw1CqvU3yQyz0N6aHsK5AO9tfobxg== X-Received: by 2002:a02:aa0d:: with SMTP id r13mr9925068jam.129.1564411872766; Mon, 29 Jul 2019 07:51:12 -0700 (PDT) Received: from vhost2 (CPE001143542e1f-CMf81d0f809fa0.cpe.net.cable.rogers.com. [99.230.51.196]) by smtp.gmail.com with ESMTPSA id n2sm64414809ioa.27.2019.07.29.07.51.11 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 29 Jul 2019 07:51:12 -0700 (PDT) From: Noam Postavsky To: Drew Adams Subject: Re: bug#25106: 24.5; easy-menu doc strings References: <45826813-d92b-4769-8ba1-a09c51349b3d@default>> <87r26bittq.fsf@mouse.gnus.org>> <7acd55b6-689a-45bb-917b-0b7cff901c28@default>> > <90eacb4e-822b-4af6-addb-e7d22b68310b@default>> <835znmks9v.fsf@gnu.org>> Date: Mon, 29 Jul 2019 10:51:11 -0400 In-Reply-To: (Drew Adams's message of "Sun, 28 Jul 2019 11:04:24 -0700 (PDT)") Message-ID: <85tvb451y8.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1.92 (windows-nt) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 25106 Cc: 25106@debbugs.gnu.org, Eli Zaretskii , larsi@gnus.org 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 (-) Drew Adams writes: > The question raised by the report is how to know > what form the returned keymap has. > >> It says nothing about the form of the keymap. > > Exactly. That's the problem reported. > >> So there's no mystery to solve here. >> it just disagreed with you. > > Disagreement about whether the problem should be > addressed is normal - a judgment call. People > judge things differently. Nothing wrong with that. >From what I can tell, Lars just requested a clarification of the original report which failed to specify what functions were being talked about. The disagreement is that Eli thinks specifying the particular form of keymap being returned is not needed (Lars never said anything about that either way). By the way, I also think documenting the particular form of keymap returned is not needed. > As for revisiting a closed report: maybe take a > look at #25195, which was also followed up on > after being closed as wont-fix. The subsequent > discussion apparently caused Lars to change his > mind. I don't think Lars changed his mind about that exactly, he just misread the original report. From unknown Sat Aug 09 19:20:20 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Tue, 27 Aug 2019 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator