From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.help Subject: RE: Disable menu bar mode Date: Mon, 18 Dec 2017 18:37:43 -0800 (PST) Message-ID: References: <7816d4f5-f412-4a7e-8aa2-ce45a489e9ed@googlegroups.com> <6eb917e5-a6a3-46b2-b6c5-7b2488647935@googlegroups.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1513651289 15085 195.159.176.226 (19 Dec 2017 02:41:29 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 19 Dec 2017 02:41:29 +0000 (UTC) To: Rusi , help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Tue Dec 19 03:41:25 2017 Return-path: Envelope-to: geh-help-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 1eR7qP-0003WS-3S for geh-help-gnu-emacs@m.gmane.org; Tue, 19 Dec 2017 03:41:25 +0100 Original-Received: from localhost ([::1]:38856 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eR7sL-0006Tj-S1 for geh-help-gnu-emacs@m.gmane.org; Mon, 18 Dec 2017 21:43:25 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44229) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eR7rs-0006T1-24 for help-gnu-emacs@gnu.org; Mon, 18 Dec 2017 21:42:56 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eR7ro-0001xd-US for help-gnu-emacs@gnu.org; Mon, 18 Dec 2017 21:42:56 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:44192) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eR7ro-0001we-MP for help-gnu-emacs@gnu.org; Mon, 18 Dec 2017 21:42:52 -0500 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.21/8.16.0.21) with SMTP id vBJ2glCC090073; Tue, 19 Dec 2017 02:42:50 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=xbznNQqoQyIaPdIRbGhV9W/hRP2v4LHdoDB9P5e2mNo=; b=ki/SwA0tvFmUc/hbr5LN64s2ri2/PAbLAq1+j09/i8CfHlRnGkxEuHJFcxaFDmyObpJz CM1H56k8IkvP6i6lo8krQ7fx7U82gRTwbf5kkPlEXKklGao84d9U7SGVPkMZYpEdWAVI gtAXZo3OGThOMWHuR5OAjNU+tYtmgD7SwlHVUWXHkE0L63kt12OwwlZCMmjoQJajTZPg AjR7/LHwt/pB5kya627CLHHrSpBcKk2SCTcaWYzyY7y7O6gLYAP03yKj531jVl56bx7h O4Qlz4+z/YJXi6N/XLRRJ7njnRlj+cbuYGf83kgH2DPa5vuCLkh6o9JwXwE7rley3QD5 nQ== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp2120.oracle.com with ESMTP id 2ext1ug2vj-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 19 Dec 2017 02:42:49 +0000 Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id vBJ2bnqJ009342 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 19 Dec 2017 02:37:49 GMT Original-Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id vBJ2bm2O013209; Tue, 19 Dec 2017 02:37:49 GMT In-Reply-To: <6eb917e5-a6a3-46b2-b6c5-7b2488647935@googlegroups.com> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4627.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8749 signatures=668649 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-1711220000 definitions=main-1712190035 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-Received-From: 141.146.126.78 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.org gmane.emacs.help:115392 Archived-At: > IOW the complaint is with the confusing and incomplete > documentation: =C2=ABnil =3D true (turn on)?? So what is false then?=C2= =BB This question comes up every so often. It's a natural one, in part because the doc strings for particular minor modes sometimes suck, er, are less than perfect. Doc strings of regular minor-mode commands (e.g., modes defined with `define-minor-mode') should describe the behavior, which is essentially the same for all such modes. And the doc strings should say clearly that the command is, in fact, a minor-mode command. Whether this gets done manually or partly automatically (e.g. by `define-minor-mode'), it needs to be done. The doc of macro `define-minor-mode', itself, is quite good. Unfortunately, an "end user" of a minor-mode command is not necessarily going to consult the doc for the macro that created the command ;-). The doc string for the command itself needs to have the info about it. This should be a no-brainer, I think. But the fact is that there is a fair amount to say, and for whatever reasons, sometimes it is omitted. There have been a bunch of bugs filed about this general problem. Sometimes things do get improved. Here are a couple such bug reports: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D25428 https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D29497 https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D20462