From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Vicente Vera Newsgroups: gmane.emacs.devel Subject: Re: emacs-26: `with-eval-after-load' docstring omission Date: Sat, 24 Feb 2018 14:42:27 +0000 Message-ID: References: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1519490853 32446 195.159.176.226 (24 Feb 2018 16:47:33 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 24 Feb 2018 16:47:33 +0000 (UTC) Cc: Emacs developers To: Noam Postavsky Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Feb 24 17:47:29 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1epcyv-0007e5-0N for ged-emacs-devel@m.gmane.org; Sat, 24 Feb 2018 17:47:29 +0100 Original-Received: from localhost ([::1]:50691 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1epd0s-0001Nu-At for ged-emacs-devel@m.gmane.org; Sat, 24 Feb 2018 11:49:30 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41225) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1epb1y-0005qW-9D for emacs-devel@gnu.org; Sat, 24 Feb 2018 09:42:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1epb1x-0005uc-F7 for emacs-devel@gnu.org; Sat, 24 Feb 2018 09:42:30 -0500 Original-Received: from mail-oi0-x233.google.com ([2607:f8b0:4003:c06::233]:35558) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1epb1x-0005tx-94 for emacs-devel@gnu.org; Sat, 24 Feb 2018 09:42:29 -0500 Original-Received: by mail-oi0-x233.google.com with SMTP id x10so5229077oig.2 for ; Sat, 24 Feb 2018 06:42:28 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=D95+eZj+altAQprbQ/tpMVi18scSUJd7koR5siTN1WQ=; b=THsoTlWKJyY9xbrCLN2SRS63ZwfhJ3CGKDJnYAqyn1wiKxBISznzqYeGP+aEnqp+by intASPceadCqfXvcn4q6i8M5wHF/zXD65jEolSjsg46gv2ynFtZlFtydEIqi5WqbqK8j FcAba8S6npEDcF6sRqylvvzX/nt64AamW9fbtGE+ZjFF2c5LmEkcP9bBJteU36yJptBC 78wWoHMXg813xxgEsN2SMP5bF6DmtvvXwuinuf8iYlGRtztpNeAoYelXo1YFTSuJ3YLh +81RzlH601HZ8w2k4iUdowFMUuFGDo7dtJiwHYRVdsvUsfZjRR3qLcFtQ3UYXoAjWyv5 ORRA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=D95+eZj+altAQprbQ/tpMVi18scSUJd7koR5siTN1WQ=; b=hT4aInqtn65G8DNIr6NfHf8XgQgycNVUXxO6SMF1cMCeMjsu7xSgR8+zOdyFiSgNce v4S6NjOk1tLWIIzxWC/0VDYcshsC4DZfsIKk4VMzv1Vc9/5vwSUb61hSamdDHUid7Hug AghIpoRw59KAjD0iaxkfR0cZPaYW4RY9x3yeVmygKojULI1pZhY+3L7riRM/M9qXPvtk CnaON4DhRkKCiob1kvRl1i4AY4PpT96Gu0D+ZDGnFS2fOUnbYfufUTSQzjV0CjiY2+Au QbS0FNKT32tqgqqoTlKJl+kB9ovCO3Of6U+jUre0Rns5GfN+lakqxHm22mnKxKmvig2t y+Eg== X-Gm-Message-State: APf1xPC4e5lm0zoXZ51aRLgeRjGmGNF9qWzU5xqE+PI9U48o7Ys5Nvk6 3dnhRbBbf6x+qJ2MupZjTxx4s9yB9hQDdpQb60I= X-Google-Smtp-Source: AG47ELtyS7uu4M9jDinx2bPkpI6PLpmuaYzJpck2zti5Q2XCrL6vi47EdHckKWtLMitl9VwBDA0pjCUB8uWv0gEHtKk= X-Received: by 10.202.58.8 with SMTP id h8mr2971544oia.88.1519483348137; Sat, 24 Feb 2018 06:42:28 -0800 (PST) Original-Received: by 10.157.66.170 with HTTP; Sat, 24 Feb 2018 06:42:27 -0800 (PST) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4003:c06::233 X-Mailman-Approved-At: Sat, 24 Feb 2018 11:48:38 -0500 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:223018 Archived-At: I think is relevant because their behavior is not identical. Nevertheless, it is proposed just for the sake of clarity. One might asume, because of similar syntax, that BODY in =E2=80=98with-eval-after-load=E2=80=99 will be passed to =E2=80=98eval=E2= =80=99 just like in =E2=80=98eval-after-load=E2=80=99: (eval-after-load 'asdf (setq asdf-something nil)) ;; (setq asdf-something nil) will be passed to =E2=80=98eval=E2=80=99 (with-eval-after-load 'asdf (setq asdf-something nil)) ;; This will be the same as: ;; ;; (eval-after-load 'asdf ;; (lambda () (setq asdf-something nil))) ;; ;; which will be passed to =E2=80=98funcall=E2=80=99 and not evaled. And also, because of their name, which says =E2=80=98eval=E2=80=99, one mig= ht think that BODY in =E2=80=98with-eval-after-load=E2=80=99 will be run through =E2= =80=98eval=E2=80=99. Unless by convention the =E2=80=98with-=E2=80=99 prefix is meant to express= that BODY will be treated as a function? 2018-02-23 14:16 GMT+00:00 Noam Postavsky : > On Fri, Feb 23, 2018 at 8:42 AM, Vicente Vera wrot= e: > >> Currently, =E2=80=98with-eval-after-load=E2=80=99 docstring doesn't ment= ion that BODY >> is executed as a lambda expression through funcall. The docstrings >> refers to =E2=80=98eval-after-load=E2=80=99 regarding the FILE argument,= but not how >> BODY is executed. > > Isn't that an irrelevant implementation detail? I don't see why it > should be documented.