From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.devel Subject: Re: emacs-26: `with-eval-after-load' docstring omission Date: Fri, 23 Feb 2018 09:16:56 -0500 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 1519395311 14480 195.159.176.226 (23 Feb 2018 14:15:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 23 Feb 2018 14:15:11 +0000 (UTC) Cc: Emacs developers To: Vicente Vera Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Feb 23 15:15:07 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 1epE7t-0003CQ-Ec for ged-emacs-devel@m.gmane.org; Fri, 23 Feb 2018 15:15:05 +0100 Original-Received: from localhost ([::1]:44819 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1epE9v-0002fE-Lb for ged-emacs-devel@m.gmane.org; Fri, 23 Feb 2018 09:17:11 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51108) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1epE9j-0002bw-3I for emacs-devel@gnu.org; Fri, 23 Feb 2018 09:17:00 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1epE9h-0003i9-Sq for emacs-devel@gnu.org; Fri, 23 Feb 2018 09:16:58 -0500 Original-Received: from mail-ot0-x22b.google.com ([2607:f8b0:4003:c0f::22b]:35989) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1epE9h-0003hg-Ni for emacs-devel@gnu.org; Fri, 23 Feb 2018 09:16:57 -0500 Original-Received: by mail-ot0-x22b.google.com with SMTP id 108so1623466otv.3 for ; Fri, 23 Feb 2018 06:16:57 -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=agJTOLbNtZYHtpOwhN3l00jR4W2wp7chLMaKZusHlZQ=; b=FPNUwpCMhsWlZWQBA27rc9kLrbxq1k8mqbbmDBJzZUreYIFPO2wF/duGYMN4w31tmM 4LlgFuDJWa9vTYrtlVP3/13VrLTWPvXDM5aDO6YvibpBLGDZr+h18ZbVIPiocnV5lrN8 Ww1yndp99FzqtKTM4uU68PF0WJHQEvB7uQYLUmNILrlyQ112lkxLuiVCQ5n7l6Eoi0pm ZGZdCozoHEHSlG8HU0A4pH3pT7/eA6kGs61di3LI5xA4yFKuQIWs7sizh8F8nAyfMzrL 7b6EBNzeca7Vh2W4u3bFFijkEly4lq70VqJk7/PyJ+/P015PKMWkUhX4HD1mD5ZXi9dz iCxg== 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=agJTOLbNtZYHtpOwhN3l00jR4W2wp7chLMaKZusHlZQ=; b=YJyggS2mTCAJo0U3XOxYbUZdTCYPArk0rh7kcG7Tm/Rez02X6zD4eiAaV/+gYJvnUA JagyQD69i4JTXzKmJWneqV7GRhiDg2ooCaperBZQF7doTpWtHxjmf9XMzJ9jUVPmi8i+ 8HizwLfUY5Tujs/XJe66RpIs88XIkzXyMqBJP5xFgCN5Cw8OP2cLhf+Z35a7/Lg8dckm uqAjXQVfE4JeT0bvuQF8FhPdUQF/iEdRw3CH3AvIdem7aUHyh9MIfSCNMJUramP5D9Pa aNMKkTM+7swTMrejOC0Ff24pq2K8183F8BPYs/vwkrtWYsm4zV7zcICs43z4TVsS5/Kp ALuA== X-Gm-Message-State: APf1xPDWZ+50Mo4Iwsi/apN2htv9JJ5vAGJcpmP0MkhPxStehEztuaxB cFvQgwXB1qVO9HYZUh1nx0h+2NlA2i4CExk4Zts= X-Google-Smtp-Source: AG47ELt4QU+C5tuha1E3xCVnwS1o6r4vF+2HEVipXRk9NBYHoz8pkJc7zAil1N1dBB3tZngm/agw2y4cEZuQsbv2AAI= X-Received: by 10.157.0.152 with SMTP id w24mr1237166oti.196.1519395416875; Fri, 23 Feb 2018 06:16:56 -0800 (PST) Original-Received: by 10.74.59.65 with HTTP; Fri, 23 Feb 2018 06:16:56 -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:c0f::22b 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:223007 Archived-At: On Fri, Feb 23, 2018 at 8:42 AM, Vicente Vera wrote: > Currently, =E2=80=98with-eval-after-load=E2=80=99 docstring doesn't menti= on 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.