From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: SMIE documentation Date: Sat, 04 Dec 2010 13:01:29 -0500 Message-ID: References: <87aakt863h.fsf@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1291485718 15797 80.91.229.12 (4 Dec 2010 18:01:58 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 4 Dec 2010 18:01:58 +0000 (UTC) Cc: emacs-devel@gnu.org To: =?utf-8?B?xaB0xJtww6FuIE7Em21lYw==?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 04 19:01:50 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 1POwQg-00035X-Hk for ged-emacs-devel@m.gmane.org; Sat, 04 Dec 2010 19:01:50 +0100 Original-Received: from localhost ([127.0.0.1]:52753 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1POwQg-0001Qo-12 for ged-emacs-devel@m.gmane.org; Sat, 04 Dec 2010 13:01:50 -0500 Original-Received: from [140.186.70.92] (port=34187 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1POwQY-0001PX-NT for emacs-devel@gnu.org; Sat, 04 Dec 2010 13:01:43 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1POwQX-0006mO-Jn for emacs-devel@gnu.org; Sat, 04 Dec 2010 13:01:42 -0500 Original-Received: from chene.dit.umontreal.ca ([132.204.246.20]:57341) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1POwQX-0006mH-HU for emacs-devel@gnu.org; Sat, 04 Dec 2010 13:01:41 -0500 Original-Received: from pastel.home (lechon.iro.umontreal.ca [132.204.27.242]) by chene.dit.umontreal.ca (8.14.1/8.14.1) with ESMTP id oB4I1YYB007632; Sat, 4 Dec 2010 13:01:34 -0500 Original-Received: by pastel.home (Postfix, from userid 20848) id D49BDA87A7; Sat, 4 Dec 2010 13:01:29 -0500 (EST) In-Reply-To: <87aakt863h.fsf@gmail.com> (=?utf-8?B?IsWgdMSbcMOhbiBOxJtt?= =?utf-8?B?ZWMiJ3M=?= message of "Sun, 28 Nov 2010 22:56:50 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 1 Rules triggered RV3699=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:133408 Archived-At: > 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 the >> +@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. >> +returns nil or an empty string, SMIE will try to handle the corresponding >> +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". > What about "nearest enclosing" instead of "most closely enclosing"? Thanks, that's what I was looking for, Stefan