From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Rusi Newsgroups: gmane.emacs.help Subject: Re: Disable menu bar mode Date: Tue, 19 Dec 2017 05:52:54 -0800 (PST) Message-ID: <04423e08-68b8-4d77-be59-f9e6de467bb2@googlegroups.com> 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 1513691616 8732 195.159.176.226 (19 Dec 2017 13:53:36 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 19 Dec 2017 13:53:36 +0000 (UTC) Injection-Date: Tue, 19 Dec 2017 13:52:55 +0000 User-Agent: G2/1.0 To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Tue Dec 19 14:53:31 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 1eRIKm-0001dB-Hz for geh-help-gnu-emacs@m.gmane.org; Tue, 19 Dec 2017 14:53:28 +0100 Original-Received: from localhost ([::1]:45558 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eRIMk-0003Io-HI for geh-help-gnu-emacs@m.gmane.org; Tue, 19 Dec 2017 08:55:30 -0500 X-Received: by 10.55.167.65 with SMTP id q62mr2394172qke.50.1513691575654; Tue, 19 Dec 2017 05:52:55 -0800 (PST) X-Received: by 10.31.61.149 with SMTP id k143mr328266vka.7.1513691575265; Tue, 19 Dec 2017 05:52:55 -0800 (PST) Original-Path: usenet.stanford.edu!m31no3911453qtf.0!news-out.google.com!t48ni1588qtc.1!nntp.google.com!m31no3911450qtf.0!postnews.google.com!glegroupsg2000goo.googlegroups.com!not-for-mail Original-Newsgroups: gnu.emacs.help In-Reply-To: Complaints-To: groups-abuse@google.com Original-Injection-Info: glegroupsg2000goo.googlegroups.com; posting-host=45.126.104.103; posting-account=mBpa7woAAAAGLEWUUKpmbxm-Quu5D8ui Original-NNTP-Posting-Host: 45.126.104.103 Original-Xref: usenet.stanford.edu gnu.emacs.help:221282 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:115397 Archived-At: On Tuesday, December 19, 2017 at 8:12:59 AM UTC+5:30, Drew Adams wrote: > > IOW the complaint is with the confusing and incomplete > > documentation: =C2=ABnil =3D true (turn on)?? So what is false then?=C2= =BB >=20 > 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. My =E2=80=94 quite unschooled =E2=80=94 analysis of the situation is this: There is a pun in Lisp: nil can mean boolean False or the empty list And in cases like this the pun gets particularly infelicitous. >=20 > 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. >=20 > Whether this gets done manually or partly automatically > (e.g. by `define-minor-mode'), it needs to be done. >=20 > 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 ;-). >=20 > 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. >=20 > There have been a bunch of bugs filed about this > general problem. Sometimes things do get improved. > Here are a couple such bug reports: >=20 > 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 Thanks for that list. If its helpful I can file a (doc)bug report=E2=80=A6 if someone who is like= ly to attend to it indicates that its worth attending to. [Yeah Yeah I know that the work that the emacs-devs do is many orders of=20 magnitude more than the work of filing a bug-report! Its also true that my attempts are usually less than successful so I like to check that others also see it as a bug]