From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: =?UTF-8?Q?Cl=c3=a9ment_Pit-Claudel?= Newsgroups: gmane.emacs.devel Subject: Re: emacs-26: `with-eval-after-load' docstring omission Date: Tue, 27 Feb 2018 15:40:36 -0500 Message-ID: <827ed6de-fd90-144e-53dd-50163a937b63@gmail.com> References: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1519764011 4031 195.159.176.226 (27 Feb 2018 20:40:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 27 Feb 2018 20:40:11 +0000 (UTC) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Feb 27 21:40: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 1eqm2f-0000h6-O1 for ged-emacs-devel@m.gmane.org; Tue, 27 Feb 2018 21:40:05 +0100 Original-Received: from localhost ([::1]:39996 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eqm4i-0002xI-2A for ged-emacs-devel@m.gmane.org; Tue, 27 Feb 2018 15:42:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52457) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eqm3G-0001wt-EL for emacs-devel@gnu.org; Tue, 27 Feb 2018 15:40:43 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eqm3D-0003EA-AJ for emacs-devel@gnu.org; Tue, 27 Feb 2018 15:40:42 -0500 Original-Received: from mail-it0-x229.google.com ([2607:f8b0:4001:c0b::229]:36481) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eqm3D-0003Dz-5g for emacs-devel@gnu.org; Tue, 27 Feb 2018 15:40:39 -0500 Original-Received: by mail-it0-x229.google.com with SMTP id u5so801778itc.1 for ; Tue, 27 Feb 2018 12:40:39 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=TfcSgp/kntOIml437DGsQeP2+eQGERNK0o7rR9fGtsY=; b=ppN+GD7GV+IlG12LzzniFUSByDgcoLkULCiwjd+SG9HcbwFuSDsmFGqLOF9Hjd2Jzi FqZg4+4/HriYnjcUC8uItGGNqwx5lufvua/uN8i1vR1QxtEkhKCCqMfOFny2IRfWTWVA jzcHhBoszaQdHkTeC94mhol/Mgf7YanjE96vP1dNuRk6U4yKZLduN73BE772mcUZPPgI l4DvBkzce0+KYELiKaCxbB9p0F9fDdQxuHJzOr94S81glZzy4dbw9YfzbAilnLoRhigS L9UgmIwfnXTpZ3r/Znbmtu4kyBY3JyuEbzkx4jxtegl69amy+trtWsTZbFK6L5I5en7D ysgA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=TfcSgp/kntOIml437DGsQeP2+eQGERNK0o7rR9fGtsY=; b=Qbg0EW7Z0NZkvPPr0m21Xsr++gJhb/cEpcIfH6weNPZXA8c/PAt4iGwNtOotnvKdJw bXfZw4BSd6RvTdtpsAS7Kp43zIj0dF2po0Hep3qiYPyl7HFhoiEM2yCRZYtesJOJHl/5 0ho4Xkq3Czqj1qsmuYVAxKO9vyYa5jazoEb8AlZS5fvSidEeM+H4++pjtGVSV+kCk5JV SaevwSphyQX8xNwu9GZpeu7uyEGe6a25Wzf5AVQw3ldtpkzDHKX04v+kFA4BuheNfCX7 OiXcR/j6HcCvfHSO/8WYagJl7QpaZA4Eh/H35hzLkXgvaoyjPxumNutKS0X9eG3j3ohO zwHQ== X-Gm-Message-State: APf1xPDi7O5YP+U2ZlnSN2r55NU1EA19o2BaH5lDeO4ZiSgU5TpqKJcx PlZDbL4kOoAD+4xxR0eswpE6VyZc X-Google-Smtp-Source: AH8x225/lhgdEcaxyU7qxaIep6EmhxwA15FS1127aiK6A1qz1N46qKUal83NCXkDHdbSpYxJmPuaQw== X-Received: by 10.36.240.72 with SMTP id p8mr18179369iti.70.1519764038310; Tue, 27 Feb 2018 12:40:38 -0800 (PST) Original-Received: from [18.26.2.123] (26-2-123.dynamic.csail.mit.edu. [18.26.2.123]) by smtp.gmail.com with ESMTPSA id p192sm223327itc.29.2018.02.27.12.40.37 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 27 Feb 2018 12:40:37 -0800 (PST) In-Reply-To: Content-Language: en-GB X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4001:c0b::229 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:223139 Archived-At: On 2018-02-23 09:16, Noam Postavsky wrote: > On Fri, Feb 23, 2018 at 8:42 AM, Vicente Vera wrote: > >> Currently, ‘with-eval-after-load’ docstring doesn't mention that BODY >> is executed as a lambda expression through funcall. The docstrings >> refers to ‘eval-after-load’ 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. It is relevant, because the behavior isn't the same as 'eval'-ing a quoted form. But I don't think the documentation should be fixed; instead, I think the behavior should be changed :)