From unknown Wed Sep 10 04:08:39 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#24740 <24740@debbugs.gnu.org> To: bug#24740 <24740@debbugs.gnu.org> Subject: Status: 26.0.50; Bad signature for alist-get in elisp manual Reply-To: bug#24740 <24740@debbugs.gnu.org> Date: Wed, 10 Sep 2025 11:08:39 +0000 retitle 24740 26.0.50; Bad signature for alist-get in elisp manual reassign 24740 emacs submitter 24740 a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan) severity 24740 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 19 13:04:48 2016 Received: (at submit) by debbugs.gnu.org; 19 Oct 2016 17:04:48 +0000 Received: from localhost ([127.0.0.1]:39978 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bwuIJ-0003Y1-Mz for submit@debbugs.gnu.org; Wed, 19 Oct 2016 13:04:48 -0400 Received: from eggs.gnu.org ([208.118.235.92]:51330) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bwuHy-0003XA-KN for submit@debbugs.gnu.org; Wed, 19 Oct 2016 13:04:27 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bwuHs-0005mH-2t for submit@debbugs.gnu.org; Wed, 19 Oct 2016 13:04:21 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM, T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:36937) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1bwuHr-0005mD-Vv for submit@debbugs.gnu.org; Wed, 19 Oct 2016 13:04:20 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:42289) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bwuHq-0008JX-Je for bug-gnu-emacs@gnu.org; Wed, 19 Oct 2016 13:04:19 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bwuHn-0005l5-DO for bug-gnu-emacs@gnu.org; Wed, 19 Oct 2016 13:04:18 -0400 Received: from mail-oi0-x242.google.com ([2607:f8b0:4003:c06::242]:36850) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1bwuHn-0005ke-4r for bug-gnu-emacs@gnu.org; Wed, 19 Oct 2016 13:04:15 -0400 Received: by mail-oi0-x242.google.com with SMTP id e12so1923115oib.3 for ; Wed, 19 Oct 2016 10:04:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:subject:date:message-id:mime-version; bh=J+uWTJ//4d+2hGnjAZvYIdcdhcAP6yu0l00qKCXT2qQ=; b=zagfbiCT1xM136HQO195A/5khYWQKWbHsdDpFOF4IW5RdHO7HCQTQEdRd086eA3sLm a7nOyJb4WApJv0u/jFhc+77tB3fH58oinjUKRMtF5+J8Yqui4EkJnQJqbQALhhlsNu09 BsV6RWx5TKYJRo+h+i4uT3umlUOTPlAUO6OJjbB7ABYI9hj2BeNoIWPpQcV5o9EAqKNp ca64Hjr4iUgKxlgD2n6fBxmsx8qxIWQPqezefIWqMa0kFtGj8voo/4aqFCZBnE6rGkpN I77MRBipAkpOHqTZcQNW++l0Zq1bARdHN8xVVpIp5l+pPS+HRvZDdoqGdqxV0Uy8uhjO 3qEg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:subject:date:message-id:mime-version; bh=J+uWTJ//4d+2hGnjAZvYIdcdhcAP6yu0l00qKCXT2qQ=; b=PwHjEvOqbB1C+ckHXeB0VJESzeyJ7+Y9ZaucK+mnp1jS1xcLo/WAVwJPjkfQlZ5T1j Umc30XotYbG5JmVOe+H3qbixHkFzsK8G02pN1CFE3Uri6GJlanJ0OpM1SAG3Y4jRiE2b NHZbXS42yE6SkX9VefeIc4Z7uYmK12HXt5l1KXDdgrH6bAhUM4HfH5Jm2bIjyKiZOQDF 8Ne53eKdm0wEHsa/EHAD1Uye1/eMfIVY23qCO1Tc84WYmTpXWAoGMWS3LD5NKCNUnZMf Sa1pPSuokJq9O5UsV0CcFfuDhwiS5xK6mPY+BlNWrmLOtHiCoFzKCy9npmLff7ci/6Ts Ivbw== X-Gm-Message-State: AA6/9Rm87ZFKQr8S8EyGJVAkDI8SR1vDzgLixyKUilO5QudkWOOTjEsYEiM2wH+/KX08Jw== X-Received: by 10.202.195.130 with SMTP id t124mr5249986oif.118.1476896653255; Wed, 19 Oct 2016 10:04:13 -0700 (PDT) Received: from wme03370.wme.owhc.net (50-200-152-189-static.hfc.comcastbusiness.net. [50.200.152.189]) by smtp.gmail.com with ESMTPSA id 1sm14555475otb.2.2016.10.19.10.04.11 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 19 Oct 2016 10:04:12 -0700 (PDT) From: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan) To: bug-gnu-emacs@gnu.org Subject: 26.0.50; Bad signature for alist-get in elisp manual Date: Wed, 19 Oct 2016 13:01:51 -0400 Message-ID: <87k2d4xog0.fsf@wme03370.wme.owhc.net> MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Wed, 19 Oct 2016 13:04:46 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) In the elisp manual, section "Association Lists", the function alist-get is shown with the signature: Function: alist-get key value &optional default remove but it should be Function: alist-get key alist &optional default remove index e7a739f..bacf036 100644 --- a/doc/lispref/lists.texi +++ b/doc/lispref/lists.texi @@ -1556,7 +1556,7 @@ Association Lists @end smallexample @end defun -@defun alist-get key value &optional default remove +@defun alist-get key alist &optional default remove This function is like @code{assq}, but instead of returning the entire association for @var{key}, @code{(@var{key} . @var{value})}, it returns just the @var{value}. If @var{key} is not found in In GNU Emacs 26.0.50.2 (x86_64-unknown-linux-gnu, GTK+ Version 2.24.31, cairo version 1.14.6) of 2016-10-17 built on wme03370.wme.owhc.net Repository revision: 1a99d5dda2460946b1035827bd2407b5f0d8336c Windowing system distributor 'Fedora Project', version 11.0.11804000 System Description: Fedora release 24 (Twenty Four) Recent messages: Entering debugger... Back to top level (nil 1 . 2) invert-alist (2 . 1) invert-alist (2 . 1) Mark set Type C-x 1 to delete the help window. Making completion list... [3 times] Configured using: 'configure --with-file-notification=gfile --with-cairo --with-x-toolkit=gtk2' Configured features: XPM JPEG TIFF GIF PNG RSVG CAIRO IMAGEMAGICK SOUND GPM DBUS GCONF GSETTINGS NOTIFY ACL LIBSELINUX GNUTLS LIBXML2 FREETYPE M17N_FLT LIBOTF XFT ZLIB TOOLKIT_SCROLL_BARS GTK2 X11 LIBSYSTEMD Important settings: value of $LANG: en_US.UTF-8 value of $XMODIFIERS: @im=ibus locale-coding-system: utf-8-unix Major mode: Lisp Interaction Minor modes in effect: show-paren-mode: t diff-auto-refine-mode: t shell-dirtrack-mode: t yas-global-mode: t yas-minor-mode: t form-feed-mode: t smartparens-global-mode: t smartparens-mode: t undo-tree-mode: t override-global-mode: t tooltip-mode: t global-eldoc-mode: t eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t column-number-mode: t line-number-mode: t auto-fill-function: do-auto-fill transient-mark-mode: t Load-path shadows: None found. Features: (shadow sort mail-extr emacsbug sendmail eieio-opt speedbar sb-image ezimage dframe help-fns radix-tree debug misearch multi-isearch mm-archive message rfc822 mml mml-sec epa mailabbrev gmm-utils mailheader mm-decode mm-bodies mm-encode server paren image-file tabify vc-git diff-mode org-element ob-sql ob-sh shell ob-scheme ob-sass ob-ruby ob-R ob-python ob-org ob-lisp ob-js ob-css ob-clojure ob-C cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs less-css-mode css-mode smie sgml-mode dom derived yasnippet form-feed slime apropos hideshow pp cl flycheck-pyflakes flycheck json map rx flx-ido flx ido smartparens undo-tree shrink-whitespace paradox paradox-menu paradox-commit-list hydra lv paradox-execute paradox-github paradox-core spinner org-rmail org-mhe org-irc org-info org-gnus gnus-util rmail rmail-loaddefs mail-utils org-docview doc-view jka-compr image-mode dired dired-loaddefs org-bibtex bibtex org-bbdb org-w3m async projectile advice grep compile ibuf-ext ibuffer ibuffer-loaddefs dash thingatpt edmacro kmacro use-package diminish bind-key secret-data org org-macro org-footnote org-pcomplete pcomplete org-list org-faces org-entities noutline outline easy-mmode org-version ob-emacs-lisp ob ob-tangle ob-ref ob-lob ob-table ob-exp org-src ob-keys ob-comint comint ansi-color ring ob-core ob-eval org-compat org-macs org-loaddefs format-spec find-func cal-menu calendar cal-loaddefs network-stream starttls url-http tls gnutls mail-parse rfc2231 rfc2047 rfc2045 mm-util ietf-drums mail-prsvr url-gw nsm subr-x puny url-cache url-auth url url-proxy url-privacy url-expand url-methods url-history url-cookie url-domsuf url-util mailcap epg finder-inf kotl-loaddefs info package epg-config url-handlers url-parse auth-source cl-seq eieio eieio-core cl-macs eieio-loaddefs password-cache url-vars seq byte-opt gv bytecomp byte-compile cl-extra help-mode easymenu cconv cl-loaddefs pcase cl-lib time-date mule-util tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel term/x-win x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list newcomment elisp-mode lisp-mode prog-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core term/tty-colors frame cl-generic cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese charscript case-table epa-hook jka-cmpr-hook help simple abbrev obarray minibuffer cl-preloaded nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote dbusbind gfilenotify dynamic-setting system-font-setting font-render-setting cairo move-toolbar gtk x-toolkit x multi-tty make-network-process emacs) Memory information: ((conses 16 376549 58838) (symbols 48 46677 0) (miscs 40 227 467) (strings 32 112733 29030) (string-bytes 1 4389236) (vectors 16 52314) (vector-slots 8 1656624 204295) (floats 8 851 557) (intervals 56 928 401) (buffers 976 22) (heap 1024 54005 5448)) From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 19 14:12:29 2016 Received: (at 24740-done) by debbugs.gnu.org; 19 Oct 2016 18:12:29 +0000 Received: from localhost ([127.0.0.1]:40000 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bwvLp-0005IP-Hf for submit@debbugs.gnu.org; Wed, 19 Oct 2016 14:12:29 -0400 Received: from eggs.gnu.org ([208.118.235.92]:43881) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bwvLn-0005IC-4n for 24740-done@debbugs.gnu.org; Wed, 19 Oct 2016 14:12:27 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bwvLc-0007UL-VL for 24740-done@debbugs.gnu.org; Wed, 19 Oct 2016 14:12:21 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.3 required=5.0 tests=BAYES_40,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:56903) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bwvLc-0007UB-SL; Wed, 19 Oct 2016 14:12:16 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3847 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bwvLc-0004Qp-45; Wed, 19 Oct 2016 14:12:16 -0400 Date: Wed, 19 Oct 2016 21:12:00 +0300 Message-Id: <83d1iwus27.fsf@gnu.org> From: Eli Zaretskii To: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan) In-reply-to: <87k2d4xog0.fsf@wme03370.wme.owhc.net> (a.lloyd.flanagan@gmail.com) Subject: Re: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual References: <87k2d4xog0.fsf@wme03370.wme.owhc.net> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.3 (-----) X-Debbugs-Envelope-To: 24740-done Cc: 24740-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.3 (-----) > From: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan) > Date: Wed, 19 Oct 2016 13:01:51 -0400 > > In the elisp manual, section "Association Lists", the function alist-get > is shown with the signature: > > Function: alist-get key value &optional default remove > > but it should be > > Function: alist-get key alist &optional default remove Thanks, fixed on the emacs-25 branch. From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 19 19:39:26 2016 Received: (at 24740) by debbugs.gnu.org; 19 Oct 2016 23:39:26 +0000 Received: from localhost ([127.0.0.1]:40151 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx0SD-0006aa-Qk for submit@debbugs.gnu.org; Wed, 19 Oct 2016 19:39:26 -0400 Received: from mout.gmx.net ([212.227.15.19]:56891) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx0SB-0006aN-Tc for 24740@debbugs.gnu.org; Wed, 19 Oct 2016 19:39:24 -0400 Received: from rosalinde ([89.245.91.89]) by mail.gmx.com (mrgmx003) with ESMTPSA (Nemesis) id 0M4Gyx-1coq1f47Jj-00roM1; Thu, 20 Oct 2016 01:39:17 +0200 From: Stephen Berman To: 24740@debbugs.gnu.org Subject: Re: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual References: <87k2d4xog0.fsf@wme03370.wme.owhc.net> <83d1iwus27.fsf@gnu.org> Date: Thu, 20 Oct 2016 01:39:15 +0200 In-Reply-To: <83d1iwus27.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 19 Oct 2016 21:12:00 +0300") Message-ID: <87funrq57g.fsf@gmx.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K0:s9yof2Ng4K/WToRqcBN6vbtVFUqDbPaG6MJPa+54nytCtrhQsBZ q02EP95vDMOfWuhW3miCpxKYiJYc1N9jb73PUnW/SZiyvM7h+EtTq5v2ooGpKnziV13fcbG PEDzlrtmy51O+RAElhJ8l/rrdTScIV72X8NtlCqT2+qNGjer/ukKKO16qiCSxspXsm14sA7 NkdMUqIV9uqslsrp5rwZA== X-UI-Out-Filterresults: notjunk:1;V01:K0:hemb+7Bth70=:CRYHZ24s2TCgGNEga8YvhN e9fVcQMjrFwtQGU5NyaLlgDot4e8ewId0ueoN/WnbduNRpJz1/tKQDXCJnNEAEt13c2VTb/Mi A0NP6sPdyDB+PX2YrDY6y9m27Zr85lvBLsx36TC6n3hP9jF/FfghgSnhaKFb6FgvrMiF/iXdg 3I7/bbsRkDPZGWkipjciQsR69iSFCL7yhoyJoa54tZFOFemXDumBgVfByS4WhclblurdA0OH0 r+N3zQSFQEYLKy+3yVsm42qTg4by5ch4U9H54aebaNRdd8SghYGSQJtxi/VtmgwI2/qmVqIgl JqGvxo/GBF91vf4ZVdskxaFUWtqKRAaGx80/G982pZiEc0x01ILZrZUTskqcS9+sgwp4Cmps4 JgwlrvcMGjZK3d6k4TVChX7zuKY0YBBA+FGOO02Css5c2zZU5Eyqdolw7e7IKRMeMX8j17c05 aQbbvL9ovW4wjEcycvkKX9+h0+9Jw1qqKbl0grZEtuzSioOwc1ct0nB4AOU+jm0zpT7CGGPPX waLfR7FjbbB7M/uMA2o1DTL5iR8HhdQ8BbzioEHNwD+yDsSJmlT5NN/3JwYkyXtR6MhSSfZo6 Tp4HlBkE9QGPx7W3uRNf3HXY/+RKPyW3fTAKaD0CrFZraloNeb8t34MH1XYoL3zLZsDwRsyB2 BZ3l5mSfB9yDlBgCy7PA8ySjRKF2Qda1iDGTLk0nt1lDklOlhze9I14FgY3fs0RGSmvmjpC/B Z3f9MMgYl5/3qut5aUr84jHO8+B3BuutMzgJdqNgUOST/vuBO8VozXtzZUoB1u53f8bfKNu1k oFsE/Rw X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 24740 Cc: a.lloyd.flanagan@gmail.com, eliz@gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) On Wed, 19 Oct 2016 21:12:00 +0300 Eli Zaretskii wrote: >> From: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan) >> Date: Wed, 19 Oct 2016 13:01:51 -0400 >> >> In the elisp manual, section "Association Lists", the function alist-get >> is shown with the signature: >> >> Function: alist-get key value &optional default remove >> >> but it should be >> >> Function: alist-get key alist &optional default remove > > Thanks, fixed on the emacs-25 branch. > -@defun alist-get key value &optional default remove > +@defun alist-get key alist &optional default remove > This function is like @code{assq}, but instead of returning the entire > -association for @var{key}, @code{(@var{key} . @var{value})}, it > -returns just the @var{value}. If @var{key} is not found in > -@var{alist} it returns @var{default}. > +association for @var{key} in @var{alist}, > +@w{@code{(@var{key} . @var{value})}}, it returns just the @var{value}. ^^^^^^^^^^^ > +If @var{key} is not found in @var{alist}, it returns @var{default}. Shouldn't the text be "it returns just the value", i.e. without the markup, since `value' is no longer a formal argument of the function signature? Steve Berman From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 19 21:00:34 2016 Received: (at 24740) by debbugs.gnu.org; 20 Oct 2016 01:00:34 +0000 Received: from localhost ([127.0.0.1]:40179 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx1ik-00004y-6s for submit@debbugs.gnu.org; Wed, 19 Oct 2016 21:00:34 -0400 Received: from mail-qk0-f178.google.com ([209.85.220.178]:34806) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx1ii-0008WM-1z for 24740@debbugs.gnu.org; Wed, 19 Oct 2016 21:00:32 -0400 Received: by mail-qk0-f178.google.com with SMTP id f128so63940492qkb.1 for <24740@debbugs.gnu.org>; Wed, 19 Oct 2016 18:00:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=DKAyGnyCmeFYwYkVpWExvHlizDZp4DO6FPINe/qw/Yk=; b=Q9Z1qA4Ovz1BZh2lzLOzduZf3n2O4Hmh9/b5eHm4tAfpsz2PUFWFSEQmBwLG0O1YWI G0otMJlW+kgtW5XkAlYeL+LI0pPAjK0L2FnTGjHjXJffYE7lBfr83Ao50NDWmZITySrd azr5isxNcORO65fhR3gL7Drholy7szC7hVCXQAzO2+mrw03Ydp4ZwU5q5UQHEh2LLKiE lun0WHGlYZYB4JREN2sRLBCkQeBK+HABIhi28ysdpllb5qi60YAcLBLIIPvqeoVn7wIh 8baLRRMkzCn8dbkVvvzWS1kK8AhUyrKPBy/BQ2dlr4+9sKLeWoEF3pKL4q2QaEK9lqvu ceaA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=DKAyGnyCmeFYwYkVpWExvHlizDZp4DO6FPINe/qw/Yk=; b=iG2Ds+s8lhDhrQ/57bQPsnhO00bPiYbHdcbhFG27XEzTHUsdFon8i7AMOVbOoAhteq iUTvggdZUU/iJkraK5DYEbxuLUodEd7JBktprgZ2KvyXtssRRALdlttfRwYnGNBoCJHo SMr7pK95K4YzWUnth4/kKHnxOAfNEznvsYmH+AWEvspz7Z6TK+cNOQZr1/Z8G3hY1gHr BjAi+EYXjnMlVBO5Qhl/XOjaUE9rIXyKeZuWACxU8xXM/3cR1/OTEfxjLyDcdcD3TP4u Pem0AbPOrlrJm6IaHo4yuDR41Eo3VMVMOLPqnrSmGl8vC+TYu1P/eJ6BtHYiuaWEXshT Y0Sg== X-Gm-Message-State: ABUngvfNwF2fClHHPSSNxnIydGcfpUlPnVxUkH00iD6i2R7UYZ3ceaUkaWGq3Mt8PhDbvzU6ljLjtq4GtJTreg== X-Received: by 10.55.75.215 with SMTP id y206mr8835157qka.26.1476925226493; Wed, 19 Oct 2016 18:00:26 -0700 (PDT) MIME-Version: 1.0 References: <87k2d4xog0.fsf@wme03370.wme.owhc.net> <83d1iwus27.fsf@gnu.org> <87funrq57g.fsf@gmx.net> In-Reply-To: <87funrq57g.fsf@gmx.net> From: "A. Lloyd Flanagan" Date: Thu, 20 Oct 2016 01:00:15 +0000 Message-ID: Subject: Re: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual To: Stephen Berman , 24740@debbugs.gnu.org Content-Type: multipart/alternative; boundary=001a114a94887c2e52053f4173e8 X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 24740 Cc: eliz@gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.5 (/) --001a114a94887c2e52053f4173e8 Content-Type: text/plain; charset=UTF-8 Yes, good catch. On Wed, Oct 19, 2016, 7:39 PM Stephen Berman wrote: > On Wed, 19 Oct 2016 21:12:00 +0300 Eli Zaretskii wrote: > > >> From: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan) > >> Date: Wed, 19 Oct 2016 13:01:51 -0400 > >> > >> In the elisp manual, section "Association Lists", the function alist-get > >> is shown with the signature: > >> > >> Function: alist-get key value &optional default remove > >> > >> but it should be > >> > >> Function: alist-get key alist &optional default remove > > > > Thanks, fixed on the emacs-25 branch. > > > > -@defun alist-get key value &optional default remove > > +@defun alist-get key alist &optional default remove > > This function is like @code{assq}, but instead of returning the entire > > -association for @var{key}, @code{(@var{key} . @var{value})}, it > > -returns just the @var{value}. If @var{key} is not found in > > -@var{alist} it returns @var{default}. > > +association for @var{key} in @var{alist}, > > +@w{@code{(@var{key} . @var{value})}}, it returns just the @var{value}. > ^^^^^^^^^^^ > > +If @var{key} is not found in @var{alist}, it returns @var{default}. > > Shouldn't the text be "it returns just the value", i.e. without the > markup, since `value' is no longer a formal argument of the function > signature? > > Steve Berman > -- "They have computers, and they may have other weapons of mass destruction." -- Janet Reno --001a114a94887c2e52053f4173e8 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
Yes, good catch.

On Wed, Oct 19, 2016= , 7:39 PM Stephen Berman <step= hen.berman@gmx.net> wrote:
O= n Wed, 19 Oct 2016 21:12:00 +0300 Eli Zaretskii <eliz@gnu.org> wrote:<= br class=3D"gmail_msg">
>> From: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan)<= br class=3D"gmail_msg"> >> Date: Wed, 19 Oct 2016 13:01:51 -0400
>>
>> In the elisp manual, section "Association Lists", the fu= nction alist-get
>> is shown with the signature:
>>
>> Function: alist-get key value &optional default remove
>>
>> but it should be
>>
>> Function: alist-get key alist &optional default remove
>
> Thanks, fixed on the emacs-25 branch.


> -@defun alist-get key value &optional default remove
> +@defun alist-get key alist &optional default remove
>=C2=A0 This function is like @code{assq}, but instead of returning the = entire
> -association for @var{key}, @code{(@var{key} . @var{value})}, it
> -returns just the @var{value}.=C2=A0 If @var{key} is not found in
> -@var{alist} it returns @var{default}.
> +association for @var{key} in @var{alist},
> +@w{@code{(@var{key} . @var{value})}}, it returns just the @var{value}= .
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0^^^^^^= ^^^^^
> +If @var{key} is not found in @var{alist}, it returns @var{default}.
Shouldn't the text be "it returns just the value", i.e. witho= ut the
markup, since `value' is no longer a formal argument of the function signature?

Steve Berman
--
"They have computers, and they may have= other weapons of mass destruction." -- Janet Reno
--001a114a94887c2e52053f4173e8-- From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 20 03:49:29 2016 Received: (at 24740) by debbugs.gnu.org; 20 Oct 2016 07:49:29 +0000 Received: from localhost ([127.0.0.1]:40301 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx86S-0001R9-GX for submit@debbugs.gnu.org; Thu, 20 Oct 2016 03:49:29 -0400 Received: from eggs.gnu.org ([208.118.235.92]:60927) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx86Q-0001Qt-NE for 24740@debbugs.gnu.org; Thu, 20 Oct 2016 03:49:27 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bx86K-0001vo-PQ for 24740@debbugs.gnu.org; Thu, 20 Oct 2016 03:49:21 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.5 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40112) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bx86H-0001sf-1a; Thu, 20 Oct 2016 03:49:17 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4714 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bx86G-0001l3-5t; Thu, 20 Oct 2016 03:49:16 -0400 Date: Thu, 20 Oct 2016 10:49:04 +0300 Message-Id: <83shrrtq8f.fsf@gnu.org> From: Eli Zaretskii To: Stephen Berman In-reply-to: <87funrq57g.fsf@gmx.net> (message from Stephen Berman on Thu, 20 Oct 2016 01:39:15 +0200) Subject: Re: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual References: <87k2d4xog0.fsf@wme03370.wme.owhc.net> <83d1iwus27.fsf@gnu.org> <87funrq57g.fsf@gmx.net> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.3 (-----) X-Debbugs-Envelope-To: 24740 Cc: a.lloyd.flanagan@gmail.com, 24740@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.3 (-----) > From: Stephen Berman > Cc: eliz@gnu.org, a.lloyd.flanagan@gmail.com > Date: Thu, 20 Oct 2016 01:39:15 +0200 > > > -@defun alist-get key value &optional default remove > > +@defun alist-get key alist &optional default remove > > This function is like @code{assq}, but instead of returning the entire > > -association for @var{key}, @code{(@var{key} . @var{value})}, it > > -returns just the @var{value}. If @var{key} is not found in > > -@var{alist} it returns @var{default}. > > +association for @var{key} in @var{alist}, > > +@w{@code{(@var{key} . @var{value})}}, it returns just the @var{value}. > ^^^^^^^^^^^ > > +If @var{key} is not found in @var{alist}, it returns @var{default}. > > Shouldn't the text be "it returns just the value", i.e. without the > markup, since `value' is no longer a formal argument of the function > signature? @var is not only for formal arguments, it's for any symbol which stands for something else. That is why @var is also used in the cons cell description; it is not because KEY and VALUE happen to appear in the function argument list. For example, we use @var in text such as this: A value of the form @code{(@var{num} . @var{expr})} stands for the product of the values of @var{num} and @var{expr}. These NUM and EXPR are not formal arguments of any function. The Texinfo manual says: Use the '@var' command to indicate metasyntactic variables. A "metasyntactic variable" is something that stands for another piece of text. For example, you should use a metasyntactic variable in the documentation of a function to describe the arguments that are passed to that function. IOW, the function arguments use case is just one example of where @var should be used. From debbugs-submit-bounces@debbugs.gnu.org Thu Oct 20 04:10:17 2016 Received: (at 24740) by debbugs.gnu.org; 20 Oct 2016 08:10:17 +0000 Received: from localhost ([127.0.0.1]:40317 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx8Qb-0001vr-9h for submit@debbugs.gnu.org; Thu, 20 Oct 2016 04:10:17 -0400 Received: from mout.gmx.net ([212.227.17.21]:59192) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bx8QZ-0001vd-C2 for 24740@debbugs.gnu.org; Thu, 20 Oct 2016 04:10:15 -0400 Received: from rosalinde ([89.245.121.151]) by mail.gmx.com (mrgmx101) with ESMTPSA (Nemesis) id 0LzGV3-1d1Q9p0l0r-014Rwv; Thu, 20 Oct 2016 10:10:08 +0200 From: Stephen Berman To: Eli Zaretskii Subject: Re: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual References: <87k2d4xog0.fsf@wme03370.wme.owhc.net> <83d1iwus27.fsf@gnu.org> <87funrq57g.fsf@gmx.net> <83shrrtq8f.fsf@gnu.org> Date: Thu, 20 Oct 2016 10:10:06 +0200 In-Reply-To: <83shrrtq8f.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 20 Oct 2016 10:49:04 +0300") Message-ID: <87shrrzbj5.fsf@rub.de> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K0:0SLRD8EZkLsjrKCNvKv2GOB49snKGUU0fdEhOPo8ddeHm8F3iSd feCvdp27Ck7d4cfpCwmghnt7uhKXGldsA5uM8pe8/e8JcvW7u7D8VVdGkXe+rPgJTjY8yqk ClYlWAylFpKep6rNgQ6YruYZfzebkHZl2PA/xXuNd7V8i02D5kVnZ0AtQWPqpA/nRLbVkFU dtKF0DDc79hccAJOEl8gA== X-UI-Out-Filterresults: notjunk:1;V01:K0:hh0CCHWf2VU=:e2kBNp2T9ALiIAE0sBzg29 Y6yGJh0xkciIFokH/9cf0wIbgAbLahsshggqtmrVjuicHetVmogIcbwQSGVfrNvZle44PqWo/ Daas+v9OFP0z0Ss+f/bfV+4FNCTIBzof5c9SlC7iDhuhDMSeRgTvNcF4tv3sW/nvDQj4vj6I9 lz5HxDqx3pJeQWOszdXzis3G2ef4Z1OJ11q4abQDpX+WY7BygLBEN+9qeiA0IfAfj10ksUOhV jIfNwAcMvU7XMmae/i4aP0R4AnFOpplj8uualxANK+xjbr78lXZeG9YV5eq3ZIy3+ecC1OOv3 REgMjhpp3Z7vHlhE9/eqhglZ+Pbb132b8HNqrpDMWDMPkSyL4DNVsrkVKjh89nEMvh05bnAbm N/0bBVG3ldxZ9CbrNRmrpLo24SWT5+MlmFaP6RufQL+kbz2oSWInrH1qy5nPUvT2rtP2Ra0F7 Ml+W9lGXNgG5H+d93iV2gazfO8D5ZVFu474gOnUD5xzSB7zOpkR6mCnbIlQw5Gxy2e0/nBEJ9 Axku+wEVZ4zOl9FDLkPOCyj5eY4S8Owq6pVWYcMLd4XWLjZaDV0mJEYdP95Db0eamCeKC3glv ZwXG+p8Z2WoMfHpezDO3hpbZnzRXKQbJZlyeDBQ9X/lbzZSJ1xCgmZoErfJVuGo5gl5Sl8OYH XdlOtUgknmOFoUb/1QEcAT2SCFXnYfQnoUsbmU4g2JYH4uoVDpl3xeMJWIGugibsUkUWJyH57 mvdla8fzO1v89iwcBFYZzZQsGih8zZlG3VooKElYW07N/vyeidiXUANoRq/GOKynnIRIXuAEd ca0fdVO X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 24740 Cc: a.lloyd.flanagan@gmail.com, 24740@debbugs.gnu.org, Stephen Berman X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) On Thu, 20 Oct 2016 10:49:04 +0300 Eli Zaretskii wrote: >> From: Stephen Berman >> Cc: eliz@gnu.org, a.lloyd.flanagan@gmail.com >> Date: Thu, 20 Oct 2016 01:39:15 +0200 >> >> > -@defun alist-get key value &optional default remove >> > +@defun alist-get key alist &optional default remove >> > This function is like @code{assq}, but instead of returning the entire >> > -association for @var{key}, @code{(@var{key} . @var{value})}, it >> > -returns just the @var{value}. If @var{key} is not found in >> > -@var{alist} it returns @var{default}. >> > +association for @var{key} in @var{alist}, >> > +@w{@code{(@var{key} . @var{value})}}, it returns just the @var{value}. >> ^^^^^^^^^^^ >> > +If @var{key} is not found in @var{alist}, it returns @var{default}. >> >> Shouldn't the text be "it returns just the value", i.e. without the >> markup, since `value' is no longer a formal argument of the function >> signature? > > @var is not only for formal arguments, it's for any symbol which > stands for something else. That is why @var is also used in the cons > cell description; it is not because KEY and VALUE happen to appear in > the function argument list. Ok, thanks for the clarification. I think the distinction would be made clearer if the definite article were omitted: "it returns just VALUE", as it is in the subsequent sentence; the definite article makes it sound to me more like a use than a mention. Steve Berman From unknown Wed Sep 10 04:08:39 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 17 Nov 2016 12:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator