From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#31441: 26; doc of functions `(lax-)plist-get' Date: Sat, 13 Jul 2019 10:31:32 -0700 (PDT) Message-ID: References: <34003574-4449-428e-8ccd-7aa94d329ba5@default> <87pnmeuh9i.fsf@mouse.gnus.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="63495"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 31441@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 13 19:47:15 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hmM78-000GIf-G3 for geb-bug-gnu-emacs@m.gmane.org; Sat, 13 Jul 2019 19:47:14 +0200 Original-Received: from localhost ([::1]:57480 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hmLsU-0007XI-Fg for geb-bug-gnu-emacs@m.gmane.org; Sat, 13 Jul 2019 13:32:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39463) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hmLsR-0007Vk-Hd for bug-gnu-emacs@gnu.org; Sat, 13 Jul 2019 13:32:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hmLsQ-0000VE-J2 for bug-gnu-emacs@gnu.org; Sat, 13 Jul 2019 13:32:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:34486) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hmLsQ-0000Up-9a for bug-gnu-emacs@gnu.org; Sat, 13 Jul 2019 13:32:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hmLsQ-0005aQ-5D for bug-gnu-emacs@gnu.org; Sat, 13 Jul 2019 13:32:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 13 Jul 2019 17:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31441 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 31441-submit@debbugs.gnu.org id=B31441.156303910421451 (code B ref 31441); Sat, 13 Jul 2019 17:32:02 +0000 Original-Received: (at 31441) by debbugs.gnu.org; 13 Jul 2019 17:31:44 +0000 Original-Received: from localhost ([127.0.0.1]:43307 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hmLs8-0005Zu-HP for submit@debbugs.gnu.org; Sat, 13 Jul 2019 13:31:44 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:43878) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hmLs7-0005Zh-I6 for 31441@debbugs.gnu.org; Sat, 13 Jul 2019 13:31:43 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x6DHTe0p190750; Sat, 13 Jul 2019 17:31:36 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=1IBCrwuE+sOcAEdc2vpeIF/qN7lBA3AnLDbsN0K/UK8=; b=4niAeESTM1wJ5PeFQICq2tU0K1XQJyTwasTKXVSwV1WbR+HtbJO4Ffsmg51pnc+9OtD+ YjSenlieKcYd3wHWBhNoj1BTVQrgNBXeMwba6StGj5MNJwz2KoD4O6z7ePED3nvKx2Xr TZvBupcUI3jby0K9kbYr7K4nvrEgJLpcLVeSlLhiZ4mlwOLCTW6G2oceiXg+fatJZJXs ZqSjr77Udy/7C9Qyoc+8GoqzvEuQv5IkWnqoe0hg1q3G5XDEM93l/BX4szOTIFX0RHhk lqOWMbulT6h6KRk1NKBvGZRnH1i27NH1AIos0qKnHc6LeKdpyKNuvhHFlRz23WVmyeu7 kA== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by userp2130.oracle.com with ESMTP id 2tq6qt9dgu-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 13 Jul 2019 17:31:36 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x6DHRuho103592; Sat, 13 Jul 2019 17:31:36 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3030.oracle.com with ESMTP id 2tq5bb7v48-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 13 Jul 2019 17:31:35 +0000 Original-Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x6DHVX4n018302; Sat, 13 Jul 2019 17:31:34 GMT In-Reply-To: <87pnmeuh9i.fsf@mouse.gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4861.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9317 signatures=668688 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=886 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1907130213 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9317 signatures=668688 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=942 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1907130213 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:162928 Archived-At: > > In addition the manual description of `plist-get' could be improved by > > mentioning these two things, which are mentioned by its doc string: > > > > 1. It uses `eq'. (If one reads further then this becomes apparent when > > reading about `lax-plist-get'. >=20 > The manual says (right above plist-get): >=20 > They all compare property names using @code{eq}. ... which is belied further down by the description of `lax-plist-get'. That's the point. The intro says that they all use `eq' - which is wrong. The entry for `plist-get' says nothing about comparison. The entry for `lax...' says it uses `equal'. Parallel construction calls for each to say what it uses, and remove the statement saying that they all use `eq'. This is about making the doc clearer.