From unknown Wed Sep 10 04:08:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual Resent-From: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan) Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 19 Oct 2016 17:05:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 24740 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 24740@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.147689668813646 (code B ref -1); Wed, 19 Oct 2016 17:05:01 +0000 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) 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-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 unknown Wed Sep 10 04:08:34 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: a.lloyd.flanagan@gmail.com (A. Lloyd Flanagan) Subject: bug#24740: closed (Re: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual) Message-ID: References: <83d1iwus27.fsf@gnu.org> <87k2d4xog0.fsf@wme03370.wme.owhc.net> X-Gnu-PR-Message: they-closed 24740 X-Gnu-PR-Package: emacs Reply-To: 24740@debbugs.gnu.org Date: Wed, 19 Oct 2016 18:13:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1476900782-20409-1" This is a multi-part message in MIME format... ------------=_1476900782-20409-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #24740: 26.0.50; Bad signature for alist-get in elisp manual which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 24740@debbugs.gnu.org. --=20 24740: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D24740 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1476900782-20409-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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. ------------=_1476900782-20409-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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)) ------------=_1476900782-20409-1-- From unknown Wed Sep 10 04:08:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual Resent-From: Stephen Berman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 19 Oct 2016 23:40:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24740 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 24740@debbugs.gnu.org Cc: a.lloyd.flanagan@gmail.com, eliz@gnu.org Received: via spool by 24740-submit@debbugs.gnu.org id=B24740.147692036625336 (code B ref 24740); Wed, 19 Oct 2016 23:40:02 +0000 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 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-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 unknown Wed Sep 10 04:08:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual Resent-From: "A. Lloyd Flanagan" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 Oct 2016 01:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24740 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stephen Berman , 24740@debbugs.gnu.org Cc: eliz@gnu.org Received: via spool by 24740-submit@debbugs.gnu.org id=B24740.1476925234314 (code B ref 24740); Thu, 20 Oct 2016 01:01:02 +0000 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: Content-Type: multipart/alternative; boundary=001a114a94887c2e52053f4173e8 X-Spam-Score: 0.5 (/) 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 unknown Wed Sep 10 04:08:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 Oct 2016 07:50:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24740 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stephen Berman Cc: a.lloyd.flanagan@gmail.com, 24740@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 24740-submit@debbugs.gnu.org id=B24740.14769497695532 (code B ref 24740); Thu, 20 Oct 2016 07:50:02 +0000 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 In-reply-to: <87funrq57g.fsf@gmx.net> (message from Stephen Berman on Thu, 20 Oct 2016 01:39:15 +0200) 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-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: -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 unknown Wed Sep 10 04:08:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24740: 26.0.50; Bad signature for alist-get in elisp manual Resent-From: Stephen Berman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 20 Oct 2016 08:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24740 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: a.lloyd.flanagan@gmail.com, 24740@debbugs.gnu.org, Stephen Berman Received: via spool by 24740-submit@debbugs.gnu.org id=B24740.14769510177435 (code B ref 24740); Thu, 20 Oct 2016 08:11:02 +0000 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 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-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