From unknown Sat Jun 21 03:29:06 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#42871 <42871@debbugs.gnu.org> To: bug#42871 <42871@debbugs.gnu.org> Subject: Status: 28.0.50; Documentation for `seq-contains-p` is outdated Reply-To: bug#42871 <42871@debbugs.gnu.org> Date: Sat, 21 Jun 2025 10:29:06 +0000 retitle 42871 28.0.50; Documentation for `seq-contains-p` is outdated reassign 42871 emacs submitter 42871 Iwan in 't Groen severity 42871 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 15 11:03:39 2020 Received: (at submit) by debbugs.gnu.org; 15 Aug 2020 15:03:39 +0000 Received: from localhost ([127.0.0.1]:56156 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k6xic-0000Fk-QK for submit@debbugs.gnu.org; Sat, 15 Aug 2020 11:03:39 -0400 Received: from lists.gnu.org ([209.51.188.17]:46442) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k6xbu-0008UQ-GN for submit@debbugs.gnu.org; Sat, 15 Aug 2020 10:56:42 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:42298) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k6xbu-0006sf-5t for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2020 10:56:42 -0400 Received: from mail-lj1-x232.google.com ([2a00:1450:4864:20::232]:44262) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1k6xbs-0004wB-62 for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2020 10:56:41 -0400 Received: by mail-lj1-x232.google.com with SMTP id g6so12834566ljn.11 for ; Sat, 15 Aug 2020 07:56:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:mime-version :content-transfer-encoding; bh=IMeRnIteWMF/zG301UeQFVWpMYLcOs/xQk22nxWCuoA=; b=mcU69Q5fMxhCnH/GdMEG+sMJDsXgJQCpqGF5IiORm0m7WGLBbYOAwgW40COZexpr2X fwP+YGNrXtDHaw8/+yAlHza7+l9OnNzd82JXlmb8+NpYTX9EovjYZ1yv7EmruXuKe/6H CiauVpXL0N8XsQ2FTTEqREJ9SrfKmLC3bd3ZbEcbdprFMz4aHCyO/iATa7XTKj0hffrA 2yusUwK6hI/khioN4l8qXTar0xtS9nDFzQAvClNLQF2TUlc8GdQ4fymM3sSll9IplG9y NlZabybU7jUiVSWtbk6W+fLB4VUYjSRXMfPHga7GcbaHqZ1+gsWml4/NMx8pSJc4IArD 3pmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:mime-version :content-transfer-encoding; bh=IMeRnIteWMF/zG301UeQFVWpMYLcOs/xQk22nxWCuoA=; b=qx1FPgp50ReHI+OG39+YptnbFRhJKgoXnNkpuAYb+0r0//XqgZErwlWb4P5owJKs/k 3uerxvRzDw2fuMM6+iq9ga3Dh4A/ts4kG8cJraJmTcHDcr/nAzCRc1Oiiry95mfJfLnk ztZjh7gOON5madWdY0hAgH7AQpcRR2hnH6J9r6n9JGPU9un+xehzV/5TpuuI4dffVt2D 8XiHFfj+tDqHFZioIX9ZMO9+oBtLEKh08Ink0Z6HUVwiKscq+zw4Bz/liFwMRIYHD7/9 MijfQkl1EiRjABGdAFIpPl+Ug++KX+6zgFB8tnJ7X0hXcOGy1wMktm2jqOhoCESCjtLf 0o6g== X-Gm-Message-State: AOAM532oT+FeWeJ/NgAUYXY/Vv3+4Qyzc43SxVmOW7nL8liQJXYaoLUf dP/iaaBrRlyua7tFMqDzTgnEJwa3EscwQA== X-Google-Smtp-Source: ABdhPJyQj6oDrGmc1+cH3FzpOnb1HC5ACm2gz9REZ9ZKRlgSOs5rZHQ4glEd/ilsIBrg0MsxAEhzPw== X-Received: by 2002:a50:fc0e:: with SMTP id i14mr6892731edr.346.1597500259344; Sat, 15 Aug 2020 07:04:19 -0700 (PDT) Received: from Iwans-MacBook-Air.local (ip47-32-173-82.adsl2.static.versatel.nl. [82.173.32.47]) by smtp.gmail.com with ESMTPSA id t3sm9665775eje.82.2020.08.15.07.04.18 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 15 Aug 2020 07:04:18 -0700 (PDT) From: Iwan in 't Groen To: bug-gnu-emacs@gnu.org Subject: 28.0.50; Documentation for `seq-contains-p` is outdated Date: Sat, 15 Aug 2020 16:04:12 +0200 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2a00:1450:4864:20::232; envelope-from=iwanintgroen@gmail.com; helo=mail-lj1-x232.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.7 (/) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Sat, 15 Aug 2020 11:03:37 -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: -2.3 (--) When looking up the documentation for `seq-contains-p` it seems outdated. M-x elisp-index-search RET seq-contains-p RET returns: -- Function: seq-contains-p sequence elt &optional function This function returns non-=E2=80=98nil=E2=80=99 if at least one element= in SEQUENCE is equal to ELT. If the optional argument FUNCTION is non-=E2=80=98nil= =E2=80=99, it is a function of two arguments to use instead of the default =E2=80=98equal=E2=80=99. (seq-contains '(symbol1 symbol2) 'symbol1) =E2=87=92 symbol1 (seq-contains '(symbol1 symbol2) 'symbol3) =E2=87=92 nil The title is correct but the information shown is for the obsolete `seq-contains` function. In GNU Emacs 28.0.50 (build 1, x86_64-apple-darwin19.6.0, NS appkit-1894.60= Version 10.15.6 (Build 19G73)) of 2020-08-15 built on Iwans-MacBook-Air.local Repository revision: 5b463af8dda4d66bb63a7ce58177e83a42541bac Repository branch: master System Description: Mac OS X 10.15.6 Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Found =E2=80=98seq-contains-p=E2=80=99 in Index. (Only match) Configured features: NOTIFY KQUEUE ACL GNUTLS LIBXML2 ZLIB TOOLKIT_SCROLL_BARS NS MODULES THREADS PDUMPER Important settings: value of $LC_ALL: en_US.UTF-8 value of $LC_CTYPE: UTF-8 value of $LANG: en_US.UTF-8 locale-coding-system: utf-8-unix Major mode: Info Minor modes in effect: tooltip-mode: t global-eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-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 buffer-read-only: t line-number-mode: t transient-mark-mode: t Load-path shadows: None found. Features: (shadow sort mail-extr emacsbug message rmc puny dired dired-loaddefs rfc822 mml mml-sec password-cache epa derived epg epg-config gnus-util rmail rmail-loaddefs text-property-search time-date subr-x seq mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader cl-loaddefs cl-lib sendmail rfc2047 rfc2045 ietf-drums mm-util mail-prsvr mail-utils info easymenu thingatpt term/xterm xterm byte-opt gv bytecomp byte-compile cconv tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel term/ns-win ns-win ucs-normalize mule-util term/common-win tool-bar dnd fontset image regexp-opt fringe tabulated-list replace newcomment text-mode elisp-mode lisp-mode prog-mode register page tab-bar menu-bar rfn-eshadow isearch timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core term/tty-colors frame minibuffer 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 composite charscript charprop case-table epa-hook jka-cmpr-hook help simple abbrev obarray 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 threads kqueue cocoa ns multi-tty make-network-process emacs) Memory information: ((conses 16 116389 7554) (symbols 48 6344 1) (strings 32 21018 1550) (string-bytes 1 602251) (vectors 16 8385) (vector-slots 8 107118 7376) (floats 8 27 31) (intervals 56 16372 42) (buffers 992 12)) From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 15 11:17:59 2020 Received: (at 42871-done) by debbugs.gnu.org; 15 Aug 2020 15:17:59 +0000 Received: from localhost ([127.0.0.1]:56202 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k6xwV-0000cl-1g for submit@debbugs.gnu.org; Sat, 15 Aug 2020 11:17:59 -0400 Received: from eggs.gnu.org ([209.51.188.92]:49052) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k6xwT-0000cW-IH for 42871-done@debbugs.gnu.org; Sat, 15 Aug 2020 11:17:58 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:49585) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k6xwO-0001nD-Bd; Sat, 15 Aug 2020 11:17:52 -0400 Received: from [176.228.60.248] (port=3640 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1k6xwM-0002Lk-QS; Sat, 15 Aug 2020 11:17:51 -0400 Date: Sat, 15 Aug 2020 18:17:38 +0300 Message-Id: <83ft8oj5v1.fsf@gnu.org> From: Eli Zaretskii To: Iwan in 't Groen In-Reply-To: (message from Iwan in 't Groen on Sat, 15 Aug 2020 16:04:12 +0200) Subject: Re: bug#42871: 28.0.50; Documentation for `seq-contains-p` is outdated References: MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 42871-done Cc: 42871-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: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Iwan in 't Groen > Date: Sat, 15 Aug 2020 16:04:12 +0200 > > (seq-contains '(symbol1 symbol2) 'symbol1) > ⇒ symbol1 > (seq-contains '(symbol1 symbol2) 'symbol3) > ⇒ nil > > The title is correct but the information shown is for the obsolete > `seq-contains` function. Thanks, fixed. From debbugs-submit-bounces@debbugs.gnu.org Wed Aug 19 04:29:17 2020 Received: (at 42871-done) by debbugs.gnu.org; 19 Aug 2020 08:29:18 +0000 Received: from localhost ([127.0.0.1]:37809 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k8JTA-0003A7-Dm for submit@debbugs.gnu.org; Wed, 19 Aug 2020 04:29:17 -0400 Received: from mail-wm1-f46.google.com ([209.85.128.46]:52305) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k8JEx-0000bQ-Ne for 42871-done@debbugs.gnu.org; Wed, 19 Aug 2020 04:14:39 -0400 Received: by mail-wm1-f46.google.com with SMTP id x5so1194897wmi.2 for <42871-done@debbugs.gnu.org>; Wed, 19 Aug 2020 01:14:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=sPoeG3oPrWcOxf/crGOt2wfX2wYUrAUQsh3niuZtT/g=; b=W2B1PTbSYwV17+eCU9lKhkvrPueSTUy9wBd278yBobIuwY0FPcMRUGUaVf/juYOh2d 33gtr2txEnc2rfq8iUMgirAXY+FJuy90Td6rZT1dIFFlXlme01CRLTqBto9kjs/dy8vb WZpyoPEWMJfP4h/LRa9IWETb8kQFhsEUnJeFZtjK3De+AL5wIwp1+NNaXUfzDiioHYn/ kTocdj2ifmsfqJL2jTKVlrVT57e5NmS9UOSd1u1J5UaH4zcBgyesqOhU6BPAUgWf5gLl n4nTMGYHBPRq7OyWVxCTo3Ha4jtq5fwiD2XDlOzA/5Y6w6AG4VzhvGjiACc0m6w7Z0Pk i6JA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=sPoeG3oPrWcOxf/crGOt2wfX2wYUrAUQsh3niuZtT/g=; b=WXXFl9NhWMLn5HHOaYD3G1LCgX1eKkmHgrSh77mvboCuN0V3NZZFZsZuMF5hijc4LO emIprWvK85V0fymtbnPlBcXxEq1/3p9XT5hqbjDrqkXw3Gmq4SPuHQOph/4WTm/f2S8L 9pfNj1Y1BnTZiLq8wDSNcJlgP93Uk0Jw5uwGEZO31uzJzKezk23Ub5otQdfRx+IW8eOq T/Sm30+MQn2vqB6V18Obu2XH56xz7NHb8rjFFiHPfrWnL4axS8N72kYV2/EGHbzJIqAN ineQ+wmL4QF0eT62sejbayTsOfNGXurUxNU4l2gxkLQ7mvKQQUfxjaQdz5pFLlGwpsGq Ze9Q== X-Gm-Message-State: AOAM531ay0ti/wn/LNhIEMM3IgtpeeP/OQUlTjp4JXftgssI+rsVyU4Q 3ht1xtxsJHokVLqxGs4DLS8= X-Google-Smtp-Source: ABdhPJzzXbSs1IUXo0MXzK8G6HzeYdGh2svbRiICe0sSFSl9gB8mrnUn93q/5j9J9HqUbY5sw2Pudw== X-Received: by 2002:a1c:7915:: with SMTP id l21mr3946637wme.50.1597824869850; Wed, 19 Aug 2020 01:14:29 -0700 (PDT) Received: from [10.6.2.221] ([109.70.144.150]) by smtp.gmail.com with ESMTPSA id q7sm39552475wra.56.2020.08.19.01.14.29 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 19 Aug 2020 01:14:29 -0700 (PDT) Content-Type: text/plain; charset=utf-8 Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.1\)) Subject: Re: bug#42871: 28.0.50; Documentation for `seq-contains-p` is outdated From: Iwan in 't Groen In-Reply-To: <83ft8oj5v1.fsf@gnu.org> Date: Wed, 19 Aug 2020 10:14:28 +0200 Content-Transfer-Encoding: quoted-printable Message-Id: References: <83ft8oj5v1.fsf@gnu.org> To: Eli Zaretskii X-Mailer: Apple Mail (2.3608.120.23.2.1) X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 42871-done X-Mailman-Approved-At: Wed, 19 Aug 2020 04:29:14 -0400 Cc: 42871-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: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) > On 15 Aug 2020, at 17:17, Eli Zaretskii wrote: >=20 >> From: Iwan in 't Groen >> Date: Sat, 15 Aug 2020 16:04:12 +0200 >>=20 >> (seq-contains '(symbol1 symbol2) 'symbol1) >> =E2=87=92 symbol1 >> (seq-contains '(symbol1 symbol2) 'symbol3) >> =E2=87=92 nil >>=20 >> The title is correct but the information shown is for the obsolete >> `seq-contains` function. >=20 > Thanks, fixed. The return value in the description of this function (now a predicate) = should also be changed. Currently is says: This function returns non-=E2=80=98nil=E2=80=99 if at least one element = in SEQUENCE is equal to ELT. It should be: This function returns =E2=80=99t=E2=80=99 if at least one element in = SEQUENCE is equal to ELT. diff --git a/doc/lispref/sequences.texi b/doc/lispref/sequences.texi index ca52369bd0..bb80307c8c 100644 --- a/doc/lispref/sequences.texi +++ b/doc/lispref/sequences.texi @@ -784,7 +784,7 @@ Sequence Functions =20 =20 @defun seq-contains-p sequence elt &optional function - This function returns non-@code{nil} if at least one element in + This function returns @code{t} if at least one element in @var{sequence} is equal to @var{elt}. If the optional argument @var{function} is non-@code{nil}, it is a function of two arguments to use instead of the default @code{equal}. From debbugs-submit-bounces@debbugs.gnu.org Wed Aug 19 06:56:56 2020 Received: (at 42871) by debbugs.gnu.org; 19 Aug 2020 10:56:56 +0000 Received: from localhost ([127.0.0.1]:38086 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k8Lm4-00070G-8W for submit@debbugs.gnu.org; Wed, 19 Aug 2020 06:56:56 -0400 Received: from mail-pj1-f54.google.com ([209.85.216.54]:54008) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k8Lm2-000704-6l for 42871@debbugs.gnu.org; Wed, 19 Aug 2020 06:56:55 -0400 Received: by mail-pj1-f54.google.com with SMTP id nv17so709537pjb.3 for <42871@debbugs.gnu.org>; Wed, 19 Aug 2020 03:56:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=bfwAQO7GaCQUTrk1Q4h+FJ4hOzphjMnKaehKBVdqwxw=; b=VFb3glqmHA2RCO0SKiFzK3NVd1lSs7ZdAXXwAV2WA0SjmlbqevgxCYI0gOOnn+93dt hO7O1d18bKojS+csLqJ7K0TABpYD9A1cRTZhf0cJQSY2KkZpKp2bosM7rAT+9Gzdv1ih y0kceNwcAROFCF2QezT+6tCsIRScGW2I6U0IiOrtafJ2XP8k7M5yZ43dILM0Tc1dHX2L rvnb/8Bv8aBHt8Z4XlwTLfOXMjViMGSbA+LfDzFfKpi9fLVtkfK3qxUa6SVzz7jfTZty HE6QELI7KNDDVTohlvxtU3O4qTJGQt+3n3hkvW7TMdOvxH34TuQPNBum6KyddCvQYkbf orDg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=bfwAQO7GaCQUTrk1Q4h+FJ4hOzphjMnKaehKBVdqwxw=; b=eGR68QsCFiI025eWjk68TQwPL9q3xNn7s3gHiJrwm2vIBxjOcqd/N3UMT2JYyuUOU/ XgLuuiVu8Oukc2eDK1B7QtykA6PrM9YNEFibIPP5leJXzcNrjFutVivuMiAbrlbV5O7A c6/IqN4O9lSo3pVz5MJcXvNblCkoYRgE6WJw+QPay0xpeBoQ+XnI8IXz5nlD76dUoRlX PGOX0vaHspN9NDZaxHKv6RYGH98X20fnBS9HzoVnWZMqnLaEeYYzDO8ax6D67Fp21loN ewRmUS/Mnx2cphS3SS37i0YHSdbkNZ6B8cPP6S7znxF18aMX09Es9qCFZ0vjf23rZIzD p1LA== X-Gm-Message-State: AOAM532OlXWEe5BpE66y0nu+phH0VDnjGmyylQt9ePXjZuSo5OXF/JOq H3ndVqtZGt/R8Uv6WqQPbcgoZw== X-Google-Smtp-Source: ABdhPJyoERklXy+GputJhgGlbaFR7UNvmq5Gyll9edLioJXExRROPSpcacjeZWlyDVQ7wnXSNl3dEw== X-Received: by 2002:a17:902:b787:: with SMTP id e7mr18369959pls.227.1597834608209; Wed, 19 Aug 2020 03:56:48 -0700 (PDT) Received: from localhost ([2a02:8084:20e2:c380:8238:830f:7113:8756]) by smtp.gmail.com with ESMTPSA id g17sm2653491pjl.37.2020.08.19.03.56.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 19 Aug 2020 03:56:47 -0700 (PDT) From: "Basil L. Contovounesios" To: Iwan in 't Groen Subject: Re: bug#42871: 28.0.50; Documentation for `seq-contains-p` is outdated References: <83ft8oj5v1.fsf@gnu.org> Date: Wed, 19 Aug 2020 11:56:45 +0100 In-Reply-To: (Iwan in 't Groen's message of "Wed, 19 Aug 2020 10:14:28 +0200") Message-ID: <87a6yqx5si.fsf@tcd.ie> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 42871 Cc: Eli Zaretskii , 42871@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: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Iwan in 't Groen writes: > The return value in the description of this function (now a predicate) sh= ould also be changed. > > Currently is says: > This function returns non-=E2=80=98nil=E2=80=99 if at least one element i= n SEQUENCE is equal to ELT. > > It should be: > This function returns =E2=80=99t=E2=80=99 if at least one element in SEQU= ENCE is equal to ELT. > > diff --git a/doc/lispref/sequences.texi b/doc/lispref/sequences.texi > index ca52369bd0..bb80307c8c 100644 > --- a/doc/lispref/sequences.texi > +++ b/doc/lispref/sequences.texi > @@ -784,7 +784,7 @@ Sequence Functions >=20=20 >=20=20 > @defun seq-contains-p sequence elt &optional function > - This function returns non-@code{nil} if at least one element in > + This function returns @code{t} if at least one element in > @var{sequence} is equal to @var{elt}. If the optional argument > @var{function} is non-@code{nil}, it is a function of two arguments to > use instead of the default @code{equal}. I don't feel strongly about this, but note that in general it's common and fine to say non-nil in place of t, even when the value is t. Predicates are allowed to return other non-nil values too, see e.g. proper-list-p. The only time the distinction matters enough to document it is when different non-nil values have different meanings, e.g. with while-no-input or with certain user options. HTH, --=20 Basil From debbugs-submit-bounces@debbugs.gnu.org Wed Aug 19 10:35:44 2020 Received: (at 42871) by debbugs.gnu.org; 19 Aug 2020 14:35:44 +0000 Received: from localhost ([127.0.0.1]:40658 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k8PBn-00064j-Vx for submit@debbugs.gnu.org; Wed, 19 Aug 2020 10:35:44 -0400 Received: from eggs.gnu.org ([209.51.188.92]:37284) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k8PBn-00064X-9U for 42871@debbugs.gnu.org; Wed, 19 Aug 2020 10:35:43 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:49237) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k8PBi-0001Ug-1a; Wed, 19 Aug 2020 10:35:38 -0400 Received: from [176.228.60.248] (port=4960 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1k8PBg-0006cM-Ui; Wed, 19 Aug 2020 10:35:37 -0400 Date: Wed, 19 Aug 2020 17:35:28 +0300 Message-Id: <83eeo2ema7.fsf@gnu.org> From: Eli Zaretskii To: Iwan in 't Groen In-Reply-To: (message from Iwan in 't Groen on Wed, 19 Aug 2020 10:14:28 +0200) Subject: Re: bug#42871: 28.0.50; Documentation for `seq-contains-p` is outdated References: <83ft8oj5v1.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 42871 Cc: 42871@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: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Iwan in 't Groen > Date: Wed, 19 Aug 2020 10:14:28 +0200 > Cc: 42871-done@debbugs.gnu.org > > The return value in the description of this function (now a predicate) should also be changed. > > Currently is says: > This function returns non-‘nil’ if at least one element in SEQUENCE is equal to ELT. > > It should be: > This function returns ’t’ if at least one element in SEQUENCE is equal to ELT. I don't see why we need to change the text: 't' is definitely non-nil, right? From unknown Sat Jun 21 03:29:06 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 Sep 2020 11:24:07 +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