From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Xue Fuqiao 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: Tue, 23 Apr 2013 08:47:18 +0800 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=UTF-8 X-Trace: ger.gmane.org 1366678042 21033 80.91.229.3 (23 Apr 2013 00:47:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 23 Apr 2013 00:47:22 +0000 (UTC) Cc: emacs-devel@gnu.org To: Glenn Morris Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Apr 23 02:47:26 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 1UUROH-0003XW-TF for ged-emacs-devel@m.gmane.org; Tue, 23 Apr 2013 02:47:26 +0200 Original-Received: from localhost ([::1]:39664 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UUROH-0000g5-Cq for ged-emacs-devel@m.gmane.org; Mon, 22 Apr 2013 20:47:25 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:46004) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UUROE-0000fx-6k for emacs-devel@gnu.org; Mon, 22 Apr 2013 20:47:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UUROC-0006Dy-Ha for emacs-devel@gnu.org; Mon, 22 Apr 2013 20:47:22 -0400 Original-Received: from mail-ia0-x22b.google.com ([2607:f8b0:4001:c02::22b]:37499) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UUROA-0006DR-Vv; Mon, 22 Apr 2013 20:47:19 -0400 Original-Received: by mail-ia0-f171.google.com with SMTP id f27so63165iae.2 for ; Mon, 22 Apr 2013 17:47:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:cc:content-type; bh=GylXnTsFHfqK++KWjbiHAK/UQH4/Qt2Ma21+/JhBE2o=; b=f+C2MlprJyG+Rfc6phvq6Rn8WQegz+G6VNUGwpwKVC1+0ObduhMoUzpR996ytnr0c/ FQpY4gb2SvqqdExEpNG1uf7xJQlwltEIjZ7niF9csfa7Ued60lt4IHWU0b26GuhBIhfn WwRxUtLKILAHVOwOBiBb+iTn2h1pbLI1bcHsfnHo3E0EddrwVPYMHDLzJlPA+uWuIMRi LgwUomh0fmuWXFVaaKwNXOfx1o81SUoFyfxXYH5Esm3kBi7DGylGvICvDZrFZLMiaR2O 7C4XLFANzpVzx/vELQSh5JbxBsyFHPqP8bSJpQKr8mXm/RiqFEtCZX8//lBCk/Ak/YKw /A9w== X-Received: by 10.50.51.226 with SMTP id n2mr9571017igo.25.1366678038247; Mon, 22 Apr 2013 17:47:18 -0700 (PDT) Original-Received: by 10.43.18.10 with HTTP; Mon, 22 Apr 2013 17:47:18 -0700 (PDT) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:4001:c02::22b 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:159137 Archived-At: On Tue, Apr 23, 2013 at 1:02 AM, Glenn Morris wrote: >> 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}}.) Done as r112355, thanks. -- Best regards, Xue Fuqiao. http://www.gnu.org/software/emacs/