From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: =?utf-8?B?xaB0xJtww6FuIE7Em21lYw==?= Newsgroups: gmane.emacs.devel Subject: Re: SMIE documentation Date: Sat, 04 Dec 2010 20:56:06 +0100 Message-ID: <877hfp71nt.fsf@gmail.com> References: <87aakt863h.fsf@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1291492695 9929 80.91.229.12 (4 Dec 2010 19:58:15 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 4 Dec 2010 19:58:15 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 04 20:58:10 2010 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1POyFG-0001O6-LF for ged-emacs-devel@m.gmane.org; Sat, 04 Dec 2010 20:58:10 +0100 Original-Received: from localhost ([127.0.0.1]:55353 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1POyFG-0005ZV-47 for ged-emacs-devel@m.gmane.org; Sat, 04 Dec 2010 14:58:10 -0500 Original-Received: from [140.186.70.92] (port=35057 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1POyFA-0005WG-4G for emacs-devel@gnu.org; Sat, 04 Dec 2010 14:58:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1POyF8-0006HJ-3b for emacs-devel@gnu.org; Sat, 04 Dec 2010 14:58:03 -0500 Original-Received: from mail-fx0-f41.google.com ([209.85.161.41]:54674) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1POyF7-0006Gl-U4 for emacs-devel@gnu.org; Sat, 04 Dec 2010 14:58:02 -0500 Original-Received: by fxm13 with SMTP id 13so9318134fxm.0 for ; Sat, 04 Dec 2010 11:58:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:to:cc:subject :in-reply-to:references:user-agent:date:message-id:mime-version :content-type:content-transfer-encoding; bh=6AcwMbuMd522fpUnHeqIkaKe7ovP7WPSqmpudEfmNUg=; b=wpCov4qx8W5NUqEgawswHfN3081gUfHdxiq57AhNCt2ppBGgDDWPkRP2qYJRaKewGq mFFlbWEyAGcYMCrAOSZFZmjxHZ44vpeFZn8Jf6zSGvDnjbG8Sy+aP3ChW0kLrbdzYXzR xHfeFaSmoISBPhGRmT1mi7rFa6TrFse0OMQB8= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type:content-transfer-encoding; b=B9LfhuxyxAblqjbwnL/A1bKkcnfvB7bMrhZJvclGberqq0oi7Hl1k+nYjGfKRPnwLi K5zQPJvuWPvwuYGVMLt9w3Mgx/agT6lbDOTlHyKkwiL6E0zU1oBMuEopqNi0lIwk5wT6 CGJ/m7lhV2ddnAd3U/DSPE/muLEDxg0fLsskI= Original-Received: by 10.223.86.4 with SMTP id q4mr3731996fal.20.1291492680716; Sat, 04 Dec 2010 11:58:00 -0800 (PST) Original-Received: from localhost (176.119.broadband10.iol.cz [90.177.119.176]) by mx.google.com with ESMTPS id n2sm921717fam.4.2010.12.04.11.57.58 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sat, 04 Dec 2010 11:57:59 -0800 (PST) In-Reply-To: (Stefan Monnier's message of "Sat, 04 Dec 2010 13:01:29 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:133415 Archived-At: Stefan Monnier writes: >> Thank you. A few nits I noticed: > > Thanks, I integrated your fixes, except below: > >>> +@c @defvar smie-grammar >>> +@c This variable is an alist specifying the left and right precedence = of >>> +@c each token. It is meant to be initialized with the use of one of t= he >>> +@c functions below. >>> +@c @end defvar > >> Why is this commented out? > > Because I'd rather not document this yet. It doesn't have a "smie--" > prefix so it's not marked as internal, but it's not really external > either (it's set via smie-setup). I may want to make it internal and/or > to change its representation. OK. Maybe adding a short comment to that effect would be helpful, to prevent more people like me wondering about the reason? >>> +returns nil or an empty string, SMIE will try to handle the correspond= ing >>> +text as an sexp according to syntax tables. >> ^^ >> a > > Hmm... In my several years in the states, I spent a fair bit of time > hacking on Emacs, but I didn't talk much about sexps (I talked about > types instead), so I'm not sure how people pronounce them usually, but > I pronounce them "ess-exps", which is why I put an "an" rather than an > "a". So I'd first need confirmation that it's indeed pronouced as > something like "sexp". Right, I suspected as much. I pronounce "sexp" as written, but I'm not a native speaker, so I'd be curious about the prevailing usage, too. In any case, grepping the Emacs repository only reveals three occurences of "an sexp", all others (including all Texinfo docs) being "a sexp". =C5=A0t=C4=9Bp=C3=A1n