From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.devel Subject: Re: /srv/bzr/emacs/trunk r112347: * doc/lispintro/emacs-lisp-intro.texi (defcustom, defun, simplified-beginning-of-buffer, defvar, Building Robots, Review, save-excursion): `defun' and `defcustom' are now macros rather than special forms. (Bug#13853) Date: Mon, 22 Apr 2013 13:02:58 -0400 Message-ID: References: <87obd8rnk1.fsf@yandex.ru> <9yli8bzriy.fsf@fencepost.gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1366650194 27437 80.91.229.3 (22 Apr 2013 17:03:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 22 Apr 2013 17:03:14 +0000 (UTC) Cc: emacs-devel@gnu.org To: xfq Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Apr 22 19:03:16 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UUK94-0000W4-S2 for ged-emacs-devel@m.gmane.org; Mon, 22 Apr 2013 19:03:14 +0200 Original-Received: from localhost ([::1]:40886 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UUK93-0000ed-VV for ged-emacs-devel@m.gmane.org; Mon, 22 Apr 2013 13:03:13 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:39168) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UUK8u-0000Lq-Uf for emacs-devel@gnu.org; Mon, 22 Apr 2013 13:03:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UUK8p-0006T1-P8 for emacs-devel@gnu.org; Mon, 22 Apr 2013 13:03:04 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:54287) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UUK8p-0006Sx-LD for emacs-devel@gnu.org; Mon, 22 Apr 2013 13:02:59 -0400 Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1UUK8o-0004gO-Tj; Mon, 22 Apr 2013 13:02:59 -0400 X-Spook: Pine Gap Serbian Baranyi Sundevil Consul Zachawi World X-Ran: RnXE~K}JQ+`s1&>}2A?R9%m@7SO}cPRs=Nzz!LN/8\+I^qItyBE+=5CP&Dh~gXWvpGW\)` X-Hue: yellow X-Attribution: GM In-Reply-To: (xfq's message of "Mon, 22 Apr 2013 06:54:49 +0800") User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:159122 Archived-At: > Maybe we can add this sentence to (info "(eintr) defun") or (info > "(eintr) Complications"), then add a cross reference to (info "(eintr) > Lisp macro"): > > "Macro" is a construct defined in Lisp, which differs from a function in > that it translates a Lisp expression into another expression which is to > be evaluated instead of the original expression. I think a few sentences in "Complications" after the bit about special forms with a link to the "Lisp macro" section of eintr is indeed all that is needed. Personally I would say something about it acting like a function for our [ie, the elisp-intro's] purposes. >>> -(Another special form, @code{defcustom}, is designed for variables >>> -that people customize. It has more features than @code{defvar}. >>> -(@xref{defcustom, , Setting Variables with @code{defcustom}}.) >> >> Why was this removed? It could have been simply changed to "Another >> function,... ". The reference to defcustom is the important thing, not >> the details of whether it is a special form or macro. > > Maybe "another macro"? For the purposes of the elisp-intro, I have no problem saying a macro is a function. You call it with arguments and it does stuff. "Another macro" is wrong because defvar is not a macro. If you want to say macro rather than function, you need to rewored it a bit more. Eg: There is a related macro, @code{defcustom}, designed for variables that people customize. It has more features than @code{defvar}. (@xref{defcustom, , Setting Variables with @code{defcustom}}.) > Thanks, I will do it the next time. (Is there anyway to amend this > commit log?) No, it's immutable. But no big deal, so don't worry about it.