From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Yuri Khan Newsgroups: gmane.emacs.devel Subject: Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'. Date: Wed, 20 Jan 2016 13:31:08 +0600 Message-ID: References: <20160116143238.27391.97533@vcs.savannah.gnu.org> <8737ttx5dm.fsf@web.de> <83oachbgz0.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1453275098 15246 80.91.229.3 (20 Jan 2016 07:31:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 20 Jan 2016 07:31:38 +0000 (UTC) To: John Wiegley , Eli Zaretskii , Michael Heerdegen , Emacs developers Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jan 20 08:31:36 2016 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 1aLnEu-0005Qx-Jp for ged-emacs-devel@m.gmane.org; Wed, 20 Jan 2016 08:31:36 +0100 Original-Received: from localhost ([::1]:40692 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLnEt-0003rr-VZ for ged-emacs-devel@m.gmane.org; Wed, 20 Jan 2016 02:31:35 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49898) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLnEr-0003rj-3i for emacs-devel@gnu.org; Wed, 20 Jan 2016 02:31:33 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aLnEq-0004iD-7y for emacs-devel@gnu.org; Wed, 20 Jan 2016 02:31:33 -0500 Original-Received: from mail-lf0-x230.google.com ([2a00:1450:4010:c07::230]:32992) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aLnEn-0004hf-Gj; Wed, 20 Jan 2016 02:31:29 -0500 Original-Received: by mail-lf0-x230.google.com with SMTP id m198so276666lfm.0; Tue, 19 Jan 2016 23:31:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:content-type; bh=Sfpa8erJ0oX773nhBqJFvXcm95VYb9SoxmEMNJ/VsEE=; b=dAxK7sW5b9VfMpUbuzl6OUPmAS+CV6fOVYFJ/UenqWWIdEVbqHDbAzfrIFUdk6k7gD tGMX0Q/EhNT7vwgQt6oXlabrNJfkGNnscnxuZu90rOLfL990INVqVVGrXDYtaNphq9fl NbOrcFMQo17+KbG6hBupDisYTbqK7TT8X6s59tGToEIMZRvGHxubmvZj1nM5KNXZp2cc s7SnFlH3o8tbqtUpTzKUv9jGiM0GGfl6KyEo8Oer1z0eLbSG+MytN1f5oGfu48g7w+p4 o/J9sTCOF6SWBwH77h2Fk6mWEJTSjnLTMhA7MVHl+HK85exr/zzj+ntmf/ErejVXYEsK EFBw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:content-type; bh=Sfpa8erJ0oX773nhBqJFvXcm95VYb9SoxmEMNJ/VsEE=; b=OQm7RjxUmnwJVNFJRbr66XQmJTu0E8K28Gedvmb7FaBFgamvf/3WAYZrzA8JsI6dTD e5a1Fs7EKZTNpgPWVpDX0YsM2CEFW2dvYC4rZwL0LV7jGyfgoB1TfWECOXLA4oia0kZ7 2tKwfUxNy0hxdV9FF2MDry2xDTRzCp2vXL2LdVtW94fD3cZgDft5S+kq+/gz7+BbKxvz 19YevSVF5bu1Xjs5Mf0sPDgNO/zgWHvAQf9Up8sFR8vRB9df9lCnXrolmPutv+pA+TwD 1qHnHbtJK4BSp1Kan1ipxrLAxW0SyFZF22K+cYe+jSaJZU+fq26EIPTydaQXS9K5G3pS MJhA== X-Gm-Message-State: ALoCoQlLEtSxO9MKeJEQ3xxh/WoI2CuLWleHbjF+VS/nF1wUHqtOIBMQdZ6+Pgz8efEfdxWR0c6fSH0yzG7h39utBfcEFI/zcQ== X-Received: by 10.25.154.20 with SMTP id c20mr10357792lfe.79.1453275088357; Tue, 19 Jan 2016 23:31:28 -0800 (PST) Original-Received: by 10.112.160.72 with HTTP; Tue, 19 Jan 2016 23:31:08 -0800 (PST) In-Reply-To: X-Google-Sender-Auth: sDJPYla-4nCyg-Pm5Y3bibDBT1M X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2a00:1450:4010:c07::230 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:198417 Archived-At: On Tue, Jan 19, 2016 at 11:59 PM, John Wiegley wrote: > We could start adding something like this at the bottom of such functions: > > Invocations of this function may be used as a place expression to `setf'. > > That is, if we wish to encourage `setf' use. The other possibility is to add > documentation to the Elisp manual where it describes `setf', and list all the > functions that may be used by it. I have a feeling that would reach your > intended audience better than extending the docstring for `alist-get'. Good documentation advertises relationships between separately documented entities at both ends.