From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: typo in frame.el Date: Fri, 9 Apr 2004 21:03:56 -0400 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <20040410010356.GG7497@fencepost> References: NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1081559172 29674 80.91.224.253 (10 Apr 2004 01:06:12 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 10 Apr 2004 01:06:12 +0000 (UTC) Cc: emacs-devel@gnu.org, Simon Josefsson Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat Apr 10 03:06:05 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1BC6wf-0001un-00 for ; Sat, 10 Apr 2004 03:06:05 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BC6we-0004zD-00 for ; Sat, 10 Apr 2004 03:06:04 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.30) id 1BC6vV-0007a3-0J for emacs-devel@quimby.gnus.org; Fri, 09 Apr 2004 21:04:53 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1BC6v7-0007Wx-Iz for emacs-devel@gnu.org; Fri, 09 Apr 2004 21:04:29 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1BC6ub-0007Ea-Oh for emacs-devel@gnu.org; Fri, 09 Apr 2004 21:04:28 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.30) id 1BC6ub-0007E0-Dj for emacs-devel@gnu.org; Fri, 09 Apr 2004 21:03:57 -0400 Original-Received: from miles by fencepost.gnu.org with local (Exim 4.24) id 1BC6ua-0007QP-IC; Fri, 09 Apr 2004 21:03:56 -0400 Original-To: Drew Adams Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.3.28i Blat: Foop X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:21431 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:21431 On Fri, Apr 09, 2004 at 01:46:53PM -0700, Drew Adams wrote: > How about we use "<=>", conventionally, in doc strings, but we also explain > this convention in the Emacs manual, for those who have never seen it? No, I don't like it. It's both ugly and confusing for the bulk of users ("explaining it in the manual" is not adequate). It's also rather contrary to the style used in doc-strings, which is rather resolutely textual, and largely eschews any kind of pseudo-graphics. I think there's nothing wrong with "iff". As someone else pointed out, even for those who don't know its exact meaning, it's a "benign" typo -- interpreting it as "if" is close enough for them to get the essential meaning of the doc-string (something like "<=>" on the other hand, does not degrade so gracefully). -Miles -- Run away! Run away!