From unknown Tue Aug 19 02:58:15 2025 X-Loop: help-debbugs@gnu.org Subject: bug#35164: 25.1; `re-search-forward' docstring args Resent-From: Emanuel Berg Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 05 Apr 2019 20:46:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 35164 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 35164@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.155449715212950 (code B ref -1); Fri, 05 Apr 2019 20:46:02 +0000 Received: (at submit) by debbugs.gnu.org; 5 Apr 2019 20:45:52 +0000 Received: from localhost ([127.0.0.1]:46328 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCVii-0003Mn-5t for submit@debbugs.gnu.org; Fri, 05 Apr 2019 16:45:52 -0400 Received: from eggs.gnu.org ([209.51.188.92]:47261) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCVif-0003MZ-4H for submit@debbugs.gnu.org; Fri, 05 Apr 2019 16:45:51 -0400 Received: from lists.gnu.org ([209.51.188.17]:46488) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hCViT-0005hZ-Px for submit@debbugs.gnu.org; Fri, 05 Apr 2019 16:45:42 -0400 Received: from eggs.gnu.org ([209.51.188.92]:33320) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCViQ-0000Sy-Tz for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 16:45:37 -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,URIBL_BLOCKED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hCViD-0005Ez-4h for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 16:45:24 -0400 Received: from sender-pp-o92.zoho.eu ([185.20.209.252]:25781) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hCViB-0003cA-MI for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 16:45:20 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1554490745; cv=none; d=zohomail.eu; s=zohoarc; b=D8rmVZh4EzFkbAG0R31s+cYzwZEPVxKABlx6tU/PRYdA51l1+MXiSJzWM/5iX+4CidrXylCFaduwz1qd5nOS/I2m3XLSPEFuic4iUcg2+pMr3zKvGFUqj4ebVe5ifEQHdYelLZpci9cdg7WwpDCQi9Qq22RxYe0QLcdTthTxQQk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.eu; s=zohoarc; t=1554490745; h=Content-Type:Date:From:MIME-Version:Message-ID:Subject:To:ARC-Authentication-Results; bh=f7JeF8i3qfFZbXl1b2gq2nagDZsmilf+IWpTq675c4A=; b=jInrUF7ar+wJqiU+rNtc/RORU+fbNjSlgMWP5OCKbBiG4ROnbE2bDvJfkMOwH1ED3JIlJ2IKfOoD4kNV5F1IPxR8fSndtaBnig2UzrxJGr+AV4lDrb/8Emj69SPKCH1lK48nBrU668KuF/htn5l4KlzZ3AAuT1B1/XZQZlElGBU= ARC-Authentication-Results: i=1; mx.zohomail.eu; dkim=pass header.i=zoho.eu; spf=pass smtp.mailfrom=moasenwood@zoho.eu; dmarc=pass header.from= header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1554490745; s=admin; d=zoho.eu; i=moasenwood@zoho.eu; h=From:To:Subject:Date:Message-ID:MIME-Version:Content-Type; l=8289; bh=f7JeF8i3qfFZbXl1b2gq2nagDZsmilf+IWpTq675c4A=; b=YWQsbHcfosNECT85zbrfEFu73aPq3KWwlrvZ6xHTP2BiQFl8dhohOfKOIhN+jAfQ qom0fowDkhocCLXZENhajAhh1xVomC5A+gwkmd5RAU+d1VJcj1zutkPaM28k/v4cy+L qqj4lUdPNsJ41GRpLfRJexNBGJvBWGYOZr1HJa98= Received: from raspberrypi.zoho.eu (c-b895225c.021-67-7570702.bbcust.telenor.se [92.34.149.184]) by mx.zoho.eu with SMTPS id 1554490745065718.4363534371095; Fri, 5 Apr 2019 20:59:05 +0200 (CEST) From: Emanuel Berg Mail-Copies-To: never Date: Fri, 05 Apr 2019 20:59:04 +0200 Message-ID: <861s2gffd3.fsf@zoho.eu> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-ZohoMailClient: External X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 185.20.209.252 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: 0.9 (/) 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.1 (/) The `re-search-forward' docstring does not mention its arguments according to the norm. And it makes sense, often the first thing I do when I bring up the help buffer for a function is to search for a particular argument to see what it does. In GNU Emacs 25.1.1 (arm-unknown-linux-gnueabihf, GTK+ Version 3.22.11) of 2017-09-16, modified by Debian built on bm-wb-02 System Description: Raspbian GNU/Linux 9.8 (stretch) Configured using: 'configure --build arm-linux-gnueabihf --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --build arm-linux-gnueabihf --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --with-x=yes --with-x-toolkit=gtk3 --with-toolkit-scroll-bars 'CFLAGS=-g -O2 -fdebug-prefix-map=/build/emacs25-pkwV6G/emacs25-25.1+1=. -fstack-protector-strong -Wformat -Werror=format-security -Wall' 'CPPFLAGS=-Wdate-time -D_FORTIFY_SOURCE=2' LDFLAGS=-Wl,-z,relro' Configured features: XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND GPM DBUS GCONF GSETTINGS NOTIFY ACL LIBSELINUX GNUTLS LIBXML2 FREETYPE M17N_FLT LIBOTF XFT ZLIB TOOLKIT_SCROLL_BARS GTK3 X11 Important settings: value of $LANG: en_GB.UTF-8 locale-coding-system: utf-8-unix Major mode: Help Minor modes in effect: show-paren-mode: t shell-dirtrack-mode: t erc-list-mode: t erc-menu-mode: t erc-autojoin-mode: t erc-ring-mode: t erc-networks-mode: t erc-pcomplete-mode: t erc-match-mode: t erc-button-mode: t erc-fill-mode: t erc-stamp-mode: t erc-netsplit-mode: t erc-irccontrols-mode: t erc-noncommands-mode: t erc-move-to-prompt-mode: t erc-readonly-mode: t erc-scrolltobottom-mode: t global-eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-compression-mode: t buffer-read-only: t transient-mark-mode: t Recent messages: next-line: End of buffer [3 times] previous-line: Beginning of buffer [6 times] This is the one occurrence. [6 times] Type "q" to restore previous buffer, M-x scroll-up to scroll help. hit: 125 This is the one occurrence. [2 times] Mark set Saving file /home/incal/ooa/doodle.el... Wrote /home/incal/ooa/doodle.el Quit Load-path shadows: /usr/share/emacs/25.1/site-lisp/debian-startup hides /usr/share/emacs/site-lisp/debian-startup /usr/share/emacs25/site-lisp/flim/md4 hides /usr/share/emacs/25.1/lisp/md4 /usr/share/emacs25/site-lisp/flim/hex-util hides /usr/share/emacs/25.1/lisp/hex-util ~/.emacs.d/lisp/abbrev hides /usr/share/emacs/25.1/lisp/abbrev ~/.emacs.d/emacs-init/gnus/server hides /usr/share/emacs/25.1/lisp/server /usr/share/emacs25/site-lisp/flim/sasl-ntlm hides /usr/share/emacs/25.1/lisp/net/sasl-ntlm /usr/share/emacs25/site-lisp/flim/sasl-cram hides /usr/share/emacs/25.1/lisp/net/sasl-cram /usr/share/emacs25/site-lisp/flim/ntlm hides /usr/share/emacs/25.1/lisp/net/ntlm /usr/share/emacs25/site-lisp/flim/sasl hides /usr/share/emacs/25.1/lisp/net/sasl /usr/share/emacs25/site-lisp/flim/hmac-def hides /usr/share/emacs/25.1/lisp/net/hmac-def /usr/share/emacs25/site-lisp/flim/hmac-md5 hides /usr/share/emacs/25.1/lisp/net/hmac-md5 /usr/share/emacs25/site-lisp/flim/sasl-digest hides /usr/share/emacs/25.1/lisp/net/sasl-digest /home/incal/.emacs.d/elpa/seq-2.20/seq hides /usr/share/emacs/25.1/lisp/emacs-lisp/seq /home/incal/.emacs.d/elpa/let-alist-1.0.5/let-alist hides /usr/share/emacs/25.1/lisp/emacs-lisp/let-alist Features: (shadow emacsbug conf-mode mm-archive sh-script smie executable mailalias w3m-cookie canlock url-http url-gw url-cache url-auth mail-extr qp gnus-async gnus-bcklg gnus-ml make-mode eieio-opt speedbar sb-image ezimage dframe find-func whitespace cus-edit cus-start cus-load tabify nnir cursor-sensor pop3 nndraft nnmh nnml network-stream nsm starttls gnus-agent nnvirtual nntp gnus-cache w3m-filter ffap paren xsel w3m-form google-translate-core-ui ido google-translate-core google-translate-tk url url-proxy url-privacy url-expand url-methods url-history url-cookie url-domsuf url-util url-parse url-vars json map lpr tramp-sh term disp-table ehelp my-faces t-mouse man tex-mode iterate-files seq-24 isbn my-bibtex bibtex slime-presentations slime-repl slime-parse bridge nroff-mode sgml-mode cobol-mode ada-mode which-func imenu align find-file checkdoc cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs guile summary message-my moggle mail-to-many mail smtpmail sendmail font-lock-add global-keys yank-my wrap-search w3m-unisearch w3m-search spell-new ispell sort-my sort slime etags xref project arc-mode archive-mode noutline outline easy-mmode hyperspec shell-cli revert-buffer-my lisp-new ielm kill keys help-new debug apropos dired-x compile-my mode-line compile article gnus-cite dl bookmarks w3m-bookmark file-write-to erc-my fill-new quit gnus-my group group-summary gnus-srvr gnus-score score-mode gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime smime dig mailcap gnus-sum gnus-group gnus-undo gnus-start gnus-cloud nnimap nnmail mail-source tls gnutls utf7 netrc nnoo parse-time gnus-spec gnus-int gnus-range gnus-win message rfc822 mml mml-sec epg mm-decode mm-bodies mm-encode mail-parse rfc2231 rfc2047 rfc2045 ietf-drums mailabbrev gmm-utils mailheader gnus gnus-ems nnheader mail-utils edit tabs dired-my w3m-my w3m-tabs w3m-session w3m browse-url doc-view jka-compr image-mode timezone w3m-hist w3m-fb bookmark-w3m w3m-ems w3m-ccl ccl w3m-favicon w3m-image w3m-proc w3m-util time-my linux-shell files-my tramp tramp-compat tramp-loaddefs trampver ucs-normalize shell advice sudo-user-path find-command window-new count get-search-string caps-back buffer-menu switch-to-buffer super scroll dired close buc switch-to-buffer-regexp subr-x align-new erc-list erc-menu erc-join erc-ring erc-networks erc-pcomplete pcomplete comint ansi-color ring erc-track erc-match erc-button wid-edit erc-fill erc-stamp erc-netsplit erc-goodies erc erc-backend erc-compat format-spec auth-source cl-seq eieio eieio-core cl-macs gnus-util time-date mm-util help-fns mail-prsvr password-cache thingatpt pp my-string search-regexp-in-files finder-inf info slime-autoloads package epg-config seq byte-opt gv bytecomp byte-compile cl-extra help-mode easymenu cconv cl-loaddefs pcase cl-lib w3m-load mule-util tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel 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 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 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 inotify dynamic-setting system-font-setting font-render-setting move-toolbar gtk x-toolkit x multi-tty make-network-process emacs) Memory information: ((conses 8 568743 119463) (symbols 24 49702 123) (miscs 20 430 2699) (strings 16 124676 18964) (string-bytes 1 3755177) (vectors 8 73911) (vector-slots 4 1902907 47046) (floats 8 609 647) (intervals 28 11167 1807) (buffers 520 100)) -- underground experts united http://user.it.uu.se/~embe8573 From unknown Tue Aug 19 02:58:15 2025 X-Loop: help-debbugs@gnu.org Subject: bug#35164: 25.1; `re-search-forward' docstring args Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Apr 2019 06:19:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35164 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Emanuel Berg Cc: 35164@debbugs.gnu.org Received: via spool by 35164-submit@debbugs.gnu.org id=B35164.15545314888499 (code B ref 35164); Sat, 06 Apr 2019 06:19:02 +0000 Received: (at 35164) by debbugs.gnu.org; 6 Apr 2019 06:18:08 +0000 Received: from localhost ([127.0.0.1]:46481 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCeeW-0002D1-1y for submit@debbugs.gnu.org; Sat, 06 Apr 2019 02:18:08 -0400 Received: from eggs.gnu.org ([209.51.188.92]:40027) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCeeU-0002CY-6V for 35164@debbugs.gnu.org; Sat, 06 Apr 2019 02:18:06 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:36816) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCeeO-0007DZ-Jj; Sat, 06 Apr 2019 02:18:00 -0400 Received: from [176.228.60.248] (port=3290 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hCeeN-0002MK-Rg; Sat, 06 Apr 2019 02:18:00 -0400 Date: Sat, 06 Apr 2019 09:17:48 +0300 Message-Id: <83ef6fbqsz.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <861s2gffd3.fsf@zoho.eu> (message from Emanuel Berg on Fri, 05 Apr 2019 20:59:04 +0200) References: <861s2gffd3.fsf@zoho.eu> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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 (-) > From: Emanuel Berg > Date: Fri, 05 Apr 2019 20:59:04 +0200 > > The `re-search-forward' docstring does not > mention its arguments according to the norm. > And it makes sense, often the first thing I do > when I bring up the help buffer for a function > is to search for a particular argument to see > what it does. All the arguments are mentioned in the doc string, so I don't think I understand this report. What "norm" are you alluding to, and how exactly does the doc string violate it? From unknown Tue Aug 19 02:58:15 2025 X-Loop: help-debbugs@gnu.org Subject: bug#35164: 25.1; `re-search-forward' docstring args Resent-From: Emanuel Berg Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Apr 2019 07:10:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35164 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 35164@debbugs.gnu.org Received: via spool by 35164-submit@debbugs.gnu.org id=B35164.155453457013154 (code B ref 35164); Sat, 06 Apr 2019 07:10:02 +0000 Received: (at 35164) by debbugs.gnu.org; 6 Apr 2019 07:09:30 +0000 Received: from localhost ([127.0.0.1]:46498 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCfSE-0003Q6-0B for submit@debbugs.gnu.org; Sat, 06 Apr 2019 03:09:30 -0400 Received: from sender-pp-o92.zoho.eu ([185.20.209.252]:25750) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCfSC-0003Py-54 for 35164@debbugs.gnu.org; Sat, 06 Apr 2019 03:09:28 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1554534563; cv=none; d=zohomail.eu; s=zohoarc; b=QjEVSUE73alqHtuh4CjxDjwNUj4BAH1TYEgSheeq8px/mmju+Fo1MsV4nljHYAiuHB6NCzhCiM40UdEf5aptjs9AA2QsItcnKLJS3KwmlHFOtEU29LBJeRygS4v7qVevAnRfPI2jm/KcHb1oIQCQG2GnWYYUngmzrl3PZA1EQmY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.eu; s=zohoarc; t=1554534563; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To:ARC-Authentication-Results; bh=U2NLsSWnNb5UMt4YAG+uvQSNFnPdaNdLgdLt09YMV1A=; b=RI8Tow3IUO2hRKXOlZhHZVYI1j7GQhPQLH1AvyYddQYOwq13JdExZHGJrAIRlDAm5JzXb/qDnn1d/qLjpTEyMhPXRQbSjXJqZW0NgL9O/JwFQxtqPu6P9LV80fcy1vTvgEMVCmm4GJfhSczB5XyOiCi8Swgb3UYX1daGLYb1VTE= ARC-Authentication-Results: i=1; mx.zohomail.eu; dkim=pass header.i=zoho.eu; spf=pass smtp.mailfrom=moasenwood@zoho.eu; dmarc=pass header.from= header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1554534563; s=admin; d=zoho.eu; i=moasenwood@zoho.eu; h=From:To:Cc:Message-ID:Subject:References:Date:In-Reply-To:MIME-Version:Content-Type:Content-Transfer-Encoding; l=3455; bh=U2NLsSWnNb5UMt4YAG+uvQSNFnPdaNdLgdLt09YMV1A=; b=LlxX1y1tokTWbsaCtbQBGQek5gTsorhIykJYzxwO6l5L2xdrhER8D5p9dHCCEdQd Ja441zp2Y7ncIzF7zEpZILac+2Dr79eQYZgCL2jKKdT2+fggy6SeuxCXy9p8ruQ1A8Z yKPLqdM64G5YXGp6ibUfyeZGUFupjd1Ay8ufRV9E= Received: from raspberrypi.zoho.eu (c-b895225c.021-67-7570702.bbcust.telenor.se [92.34.149.184]) by mx.zoho.eu with SMTPS id 1554534562811200.64361887557425; Sat, 6 Apr 2019 09:09:22 +0200 (CEST) From: Emanuel Berg Message-ID: <86r2afbof1.fsf@zoho.eu> References: <861s2gffd3.fsf@zoho.eu> <83ef6fbqsz.fsf@gnu.org> Mail-Copies-To: never Date: Sat, 06 Apr 2019 09:09:22 +0200 In-Reply-To: <83ef6fbqsz.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 06 Apr 2019 09:17:48 +0300") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-ZohoMailClient: External 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 (-) Eli Zaretskii wrote: > All the arguments are mentioned in the doc > string, so I don't think I understand this > report. What "norm" are you alluding to, and > how exactly does the doc string violate it? ;;; docstring-experiment.el --- illustrate docstring deficiency ;;; Commentary: ;;; ;;; This file: ;;; http://user.it.uu.se/~embe8573/emacs-init/docstring-experiment.el ;;; ;;; Updated: 2019-04-06 09:05 ;;; ;;; The purpose of this package is to ;;; illustrate the deficiency of certain ;;; docstrings with respect to the arguments of ;;; the functions. ;;; ;;; The first example docstring is from ;;; `re-search-forward' on GNU Emacs 25.1.1 ;;; (arm-unknown-linux-gnueabihf, GTK+ Version ;;; 3.22.11) of 2017-09-16, modified by Debian. ;;; ;;; To illustrate even further, I have ;;; purposefully written an even worse ;;; docstring to a function that only ;;; exists here. ;;; ;;; To test, evaluate: ;;; ;;; (checkdoc-current-buffer t) ;;; ;;; Here is some additional settings and ;;; helpers: ;;; ;;; (require 'checkdoc) ;;; (setq checkdoc-permit-comma-termination-flag t) ;;; ;;; (defun check-package-style () ;;; (interactive) ;;; (checkdoc-current-buffer t) ; TAKE-NOTES ;;; (message "Style check done.") ) ;;; (defalias 'pack-style #'check-package-style) ;;; ;;; If you for some reason do not get ;;; `checkdoc' to work, the output is: ;;; ;;; *** docstring-experiment.el: checkdoc-current-buffer V 0.6.1 ;;; docstring-experiment.el:37: ;;; Argument =E2=80=98bound=E2=80=99 should appear (as BOUND) in the doc = string ;;; docstring-experiment.el:60: ;;; Arguments occur in the doc string out of order ;;; Code: (defun illo-re-search-forward (regexp &optional bound noerror count) "Search forward from point for regular expression REGEXP. Set point to the end of the occurrence found, and return point. An optional second argument bounds the search; it is a buffer position. The match found must not end after that position. A value of nil means search to the end of the accessible portion of the buffer. Optional third argument, if t, means if fail just return nil (no error). If not nil and not t, move to limit of search and return nil. Optional fourth argument COUNT, if a positive number, means to search for COUNT successive occurrences. If COUNT is negative, search backward, instead of forward, for -COUNT occurrences. A value of nil means the same as 1. With COUNT positive, the match found is the COUNTth one (or first, if COUNT is 1 or nil) in the buffer located entirely after the origin of the search; correspondingly with COUNT negative. Search case-sensitivity is determined by the value of the variable =E2=80=98case-fold-search=E2=80=99, which see. See also the functions =E2=80=98match-beginning=E2=80=99, =E2=80=98match-en= d=E2=80=99, =E2=80=98match-string=E2=80=99, and =E2=80=98replace-match=E2=80=99." (message "This function's purpose was not to be executed.") ) (defun illo-even-worse (out of order) "OUT is a nice place after too much computer work. By a bridge the sound of the water can be very relaxing. It gets your thoughts back to ORDER. OF all the things I can think of now that would be the nicest." (message "Evaluate (checkdoc-current-buffer t) instead!") ) (provide 'docstring-experiment) ;;; docstring-experiment.el ends here --=20 underground experts united http://user.it.uu.se/~embe8573 From unknown Tue Aug 19 02:58:15 2025 X-Loop: help-debbugs@gnu.org Subject: bug#35164: 25.1; `re-search-forward' docstring args Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Apr 2019 09:01:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35164 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Emanuel Berg Cc: 35164@debbugs.gnu.org Received: via spool by 35164-submit@debbugs.gnu.org id=B35164.155454120623639 (code B ref 35164); Sat, 06 Apr 2019 09:01:01 +0000 Received: (at 35164) by debbugs.gnu.org; 6 Apr 2019 09:00:06 +0000 Received: from localhost ([127.0.0.1]:46545 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hChBG-00069A-0S for submit@debbugs.gnu.org; Sat, 06 Apr 2019 05:00:06 -0400 Received: from eggs.gnu.org ([209.51.188.92]:38147) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hChBC-00068A-2j for 35164@debbugs.gnu.org; Sat, 06 Apr 2019 05:00:02 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:38146) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hChB6-00071v-FZ; Sat, 06 Apr 2019 04:59:56 -0400 Received: from [176.228.60.248] (port=1334 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hChB5-0005mA-3f; Sat, 06 Apr 2019 04:59:55 -0400 Date: Sat, 06 Apr 2019 11:59:43 +0300 Message-Id: <83sguva4qo.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <86r2afbof1.fsf@zoho.eu> (message from Emanuel Berg on Sat, 06 Apr 2019 09:09:22 +0200) References: <861s2gffd3.fsf@zoho.eu> <83ef6fbqsz.fsf@gnu.org> <86r2afbof1.fsf@zoho.eu> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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 (-) > From: Emanuel Berg > Cc: 35164@debbugs.gnu.org > Date: Sat, 06 Apr 2019 09:09:22 +0200 > > Eli Zaretskii wrote: > > > All the arguments are mentioned in the doc > > string, so I don't think I understand this > > report. What "norm" are you alluding to, and > > how exactly does the doc string violate it? > > ;;; docstring-experiment.el --- illustrate docstring deficiency I don't think I understand how this answers my question. Please humor me and provide a direct answer. TIA From unknown Tue Aug 19 02:58:15 2025 X-Loop: help-debbugs@gnu.org Subject: bug#35164: 25.1; `re-search-forward' docstring args Resent-From: Emanuel Berg Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Apr 2019 14:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35164 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 35164@debbugs.gnu.org Received: via spool by 35164-submit@debbugs.gnu.org id=B35164.155456106314235 (code B ref 35164); Sat, 06 Apr 2019 14:32:02 +0000 Received: (at 35164) by debbugs.gnu.org; 6 Apr 2019 14:31:03 +0000 Received: from localhost ([127.0.0.1]:47332 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCmLX-0003hX-Cw for submit@debbugs.gnu.org; Sat, 06 Apr 2019 10:31:03 -0400 Received: from sender-pp-o92.zoho.eu ([185.20.209.252]:25753) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCmLU-0003h6-Ci for 35164@debbugs.gnu.org; Sat, 06 Apr 2019 10:31:01 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1554561057; cv=none; d=zohomail.eu; s=zohoarc; b=Ze1w3idLtzbe/pWbRBkkklJkMk2b3BoPCLQYU+mT9whVX8xmYZTfQzomkKPWZqo7/aNl1oAYrHl9bemK3cEXaonYCLS1NnIjv5AlRbFf8u3Schm3DI6KZEh10FhQPTZTVe1xQ+XH2mYcxs5mwKuNVBRr2lrNXO349vyBwgGXHnc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.eu; s=zohoarc; t=1554561057; h=Content-Type:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To:ARC-Authentication-Results; bh=pLa7Snos52o6+fuwqTh1fWbA3aTYi86DCE7LKnH2QZU=; b=dugXD8hoJ+FzNAWAgRhrl3KEZ0Gh2GFJBFO5K4lbtpiAehveSn4Gsq22INrpxleVRsrnInzFeRH5AbuXx80dT916IoZKpUin4HqfS4On7ydqOmdS8paqGR5/oRB1XIrDZrDGqqzM6wLFLQlPkJX1qr24bEvzGXxeb0kBrACvUpY= ARC-Authentication-Results: i=1; mx.zohomail.eu; dkim=pass header.i=zoho.eu; spf=pass smtp.mailfrom=moasenwood@zoho.eu; dmarc=pass header.from= header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1554561057; s=admin; d=zoho.eu; i=moasenwood@zoho.eu; h=From:To:Cc:Subject:References:Date:In-Reply-To:Message-ID:MIME-Version:Content-Type; l=346; bh=pLa7Snos52o6+fuwqTh1fWbA3aTYi86DCE7LKnH2QZU=; b=i/S1vXFEi8biSu+ILf7TA5Yi+rmWeA2iOvfoHbpgVNRIYsoXW7QTSAe4Twp2twBA pQYtKgCGh3PxKKfuy+gW0xjo8WPEPL8UVAntDWdEkcRNFw0pDQW5kj21xMi+CQGgt3U i3XKT5sqn8xDPP98c+nTKqdlQ2OZMkXM8Z4ZbTP8= Received: from raspberrypi.zoho.eu (c-b895225c.021-67-7570702.bbcust.telenor.se [92.34.149.184]) by mx.zoho.eu with SMTPS id 1554561055016698.6839337666393; Sat, 6 Apr 2019 16:30:55 +0200 (CEST) From: Emanuel Berg References: <861s2gffd3.fsf@zoho.eu> <83ef6fbqsz.fsf@gnu.org> <86r2afbof1.fsf@zoho.eu> <83sguva4qo.fsf@gnu.org> Mail-Copies-To: never Date: Sat, 06 Apr 2019 16:30:54 +0200 In-Reply-To: <83sguva4qo.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 06 Apr 2019 11:59:43 +0300") Message-ID: <86ef6fb3z5.fsf@zoho.eu> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-ZohoMailClient: External 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 (-) Eli Zaretskii wrote: > I don't think I understand how this answers > my question. Please humor me and provide > a direct answer. I'm dropping this issue 100%. I thought it would be a quick fix, but if you want docstrings that do not conform with your own rules do it. -- underground experts united http://user.it.uu.se/~embe8573 From unknown Tue Aug 19 02:58:15 2025 X-Loop: help-debbugs@gnu.org Subject: bug#35164: 25.1; `re-search-forward' docstring args Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Apr 2019 14:35:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35164 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Emanuel Berg Cc: 35164@debbugs.gnu.org Received: via spool by 35164-submit@debbugs.gnu.org id=B35164.155456124614514 (code B ref 35164); Sat, 06 Apr 2019 14:35:02 +0000 Received: (at 35164) by debbugs.gnu.org; 6 Apr 2019 14:34:06 +0000 Received: from localhost ([127.0.0.1]:47341 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCmOU-0003m2-72 for submit@debbugs.gnu.org; Sat, 06 Apr 2019 10:34:06 -0400 Received: from eggs.gnu.org ([209.51.188.92]:33880) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCmOT-0003lW-Bj for 35164@debbugs.gnu.org; Sat, 06 Apr 2019 10:34:05 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:41512) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCmON-00046Q-6o; Sat, 06 Apr 2019 10:34:00 -0400 Received: from [176.228.60.248] (port=2807 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hCmOM-0008Rl-Me; Sat, 06 Apr 2019 10:33:59 -0400 Date: Sat, 06 Apr 2019 17:33:48 +0300 Message-Id: <83imvr9p9v.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <86ef6fb3z5.fsf@zoho.eu> (message from Emanuel Berg on Sat, 06 Apr 2019 16:30:54 +0200) References: <861s2gffd3.fsf@zoho.eu> <83ef6fbqsz.fsf@gnu.org> <86r2afbof1.fsf@zoho.eu> <83sguva4qo.fsf@gnu.org> <86ef6fb3z5.fsf@zoho.eu> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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 (-) > From: Emanuel Berg > Cc: 35164@debbugs.gnu.org > Date: Sat, 06 Apr 2019 16:30:54 +0200 > > Eli Zaretskii wrote: > > > I don't think I understand how this answers > > my question. Please humor me and provide > > a direct answer. > > I'm dropping this issue 100%. I thought it > would be a quick fix, but if you want > docstrings that do not conform with your own > rules do it. Which rules, please? I really don't think I understand that, and I don't think I asked something that should trigger such a reaction. I mean, if you submit a bug report, and I ask for clarifying it, why would you refuse? From unknown Tue Aug 19 02:58:15 2025 X-Loop: help-debbugs@gnu.org Subject: bug#35164: 25.1; `re-search-forward' docstring args Resent-From: Emanuel Berg Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Apr 2019 14:36:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35164 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 35164@debbugs.gnu.org Received: via spool by 35164-submit@debbugs.gnu.org id=B35164.155456131114644 (code B ref 35164); Sat, 06 Apr 2019 14:36:02 +0000 Received: (at 35164) by debbugs.gnu.org; 6 Apr 2019 14:35:11 +0000 Received: from localhost ([127.0.0.1]:47348 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCmPX-0003o8-JU for submit@debbugs.gnu.org; Sat, 06 Apr 2019 10:35:11 -0400 Received: from sender-pp-o92.zoho.eu ([185.20.209.252]:25715) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCmPW-0003nz-1Y for 35164@debbugs.gnu.org; Sat, 06 Apr 2019 10:35:10 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1554561305; cv=none; d=zohomail.eu; s=zohoarc; b=IfLCtVwUXVEkJgNnukPE2x8QjS82xAOtrUSWCHe55QvxekHTl6ABBPtEN9aFWJwWYCsU0T0UUJt4cNHqVNnDN4J83BV3xqpfzUB/nzQeKyLfLxruMX25+qJGOVHuL4nWvb3LMzRTtX1ODsdXpiAZbot9DyLTP6ppPmQhFTg3iRs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.eu; s=zohoarc; t=1554561305; h=Content-Type:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To:ARC-Authentication-Results; bh=+YYXiSsdGqfY0ChSlsWxNkJYLxPa7s6XPqUOzwEp+NI=; b=CrN+U8jR1Ce/+Q1+fXAUYVgQWUhY1p/G2WHJcLtKXPri288dHs4i4b/0DbVDUtG8INWmNDBnBe8/t/cOJA0X0zu9QpRnGtTxe0xFH9MV/yBSe8McWbwVX9q/uB1wCyFewoYV5gonmHl8VXwNeXI49RPX+423m0r7NmNt/svwvl4= ARC-Authentication-Results: i=1; mx.zohomail.eu; dkim=pass header.i=zoho.eu; spf=pass smtp.mailfrom=moasenwood@zoho.eu; dmarc=pass header.from= header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1554561305; s=admin; d=zoho.eu; i=moasenwood@zoho.eu; h=From:To:Cc:Subject:References:Date:In-Reply-To:Message-ID:MIME-Version:Content-Type; l=359; bh=+YYXiSsdGqfY0ChSlsWxNkJYLxPa7s6XPqUOzwEp+NI=; b=PQCU+gWmETx9e76OxbSGctC7uvUF+pW+XWBAux9kLeC5Znxh2n3clS4bTVeoJ2kI Hz5ZKMLwYLVaeutwkY/EcrTf6rwNfywH0V3tWYYVAwobBjUfuQBQDUqW4Otqt/wrAgr FoJ/s+hlpJg9n2BaAinbXLTFMkt9eWyBh1wy3Mi4= Received: from raspberrypi.zoho.eu (c-b895225c.021-67-7570702.bbcust.telenor.se [92.34.149.184]) by mx.zoho.eu with SMTPS id 1554561303009598.4340288496481; Sat, 6 Apr 2019 16:35:03 +0200 (CEST) From: Emanuel Berg References: <861s2gffd3.fsf@zoho.eu> <83ef6fbqsz.fsf@gnu.org> <86r2afbof1.fsf@zoho.eu> <83sguva4qo.fsf@gnu.org> <86ef6fb3z5.fsf@zoho.eu> <83imvr9p9v.fsf@gnu.org> Mail-Copies-To: never Date: Sat, 06 Apr 2019 16:35:02 +0200 In-Reply-To: <83imvr9p9v.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 06 Apr 2019 17:33:48 +0300") Message-ID: <861s2fb3s9.fsf@zoho.eu> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-ZohoMailClient: External 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 (-) Eli Zaretskii wrote: > Which rules, please? I really don't think > I understand that, and I don't think I asked > something that should trigger such > a reaction. I mean, if you submit a bug > report, and I ask for clarifying it, why > would you refuse? I have dropped this issue. -- underground experts united http://user.it.uu.se/~embe8573 From unknown Tue Aug 19 02:58:15 2025 X-Loop: help-debbugs@gnu.org Subject: bug#35164: 25.1; `re-search-forward' docstring args Resent-From: Alex Branham Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Apr 2019 15:16:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35164 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 35164@debbugs.gnu.org, Emanuel Berg Received: via spool by 35164-submit@debbugs.gnu.org id=B35164.155456372218452 (code B ref 35164); Sat, 06 Apr 2019 15:16:01 +0000 Received: (at 35164) by debbugs.gnu.org; 6 Apr 2019 15:15:22 +0000 Received: from localhost ([127.0.0.1]:47382 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCn2P-0004nY-Ka for submit@debbugs.gnu.org; Sat, 06 Apr 2019 11:15:21 -0400 Received: from mail-oi1-f182.google.com ([209.85.167.182]:40482) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCn2M-0004nJ-LI for 35164@debbugs.gnu.org; Sat, 06 Apr 2019 11:15:20 -0400 Received: by mail-oi1-f182.google.com with SMTP id 3so7230681oir.7 for <35164@debbugs.gnu.org>; Sat, 06 Apr 2019 08:15:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=utexas-edu.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=KDrKk5Lo7815cTriQsR5tz9ZngaOJdWBz5SlQQv9dYU=; b=UvX6fsbW/5FpneT/s6pUnec+FosDyGiDlOeOhQORjTQMhVcM0B90OuM6ObwiN9WCS0 IswUTWgU926yOxMv78GFmNGYZFqdxdIQw3eJgVTQErENxdd1IoeP/jYUiSUpWUQOYDFn 7FmuBZv4cQYie1ADQNjhX90AjjU1KYbPmGBe2I6BZ+t04iY98v/WAR4W0Q5Nbqux5Wtq bLM7XbFO27m1f/biMaoCfJ+Ws7Em34P1KsxO42bbme/+vcrPnuu2p0rvuyZaJCbVfZCb Vy7b+RzYz5Q1kZseGH/xT3dx8MqtCDWk1UCSpJEfvj2NSNXoLFDQ3YZGhmq12HhM6gyg jimA== 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; bh=KDrKk5Lo7815cTriQsR5tz9ZngaOJdWBz5SlQQv9dYU=; b=fKwGhUjls2ee+bclg06l9pXdSwyiRvmutMbV0U8CgLUl617jVZD8bz4b+Tg7EkIWyA 2Gp6GX0dPBxyBBUAIRoJuM4kM+t3oSkhPujMaVinjeVnxkOipA6LW4OEtk7zP1HZRw2S m7t1qvRkXRncz/qVoEec66qTfg+sxP+/uLz2QKa6IJyLRySvOPsmqOXk8uMZBcg1DFG+ VF1Xv2JcOvmisIaCv6ULgiwHYplFF34hSPMy/fls3mI79UqL4Jhf2vstgQ0WDHpQMAr6 lr9z9HdE/4ObWItkAO8EMVIid70w9hxksXcLOR655hqcg7E6nmnFaBX5hN/RzJtzIi0G TTeA== X-Gm-Message-State: APjAAAXrOKGCWVzVC78QFckEfd3CmjU1Sbpvv9W5ID2qx5l0HplIYdHl svjc/+5RnuFxUM9jM68EmIIhAlKjHZA= X-Google-Smtp-Source: APXvYqwsTrrpgsYGNfRqCjZYiiaXv9mKPckaiZawj83wmKpMT/HemvXFnjj2ot6JS9lBsK+vy3Qr2Q== X-Received: by 2002:aca:54d2:: with SMTP id i201mr10589746oib.29.1554563712690; Sat, 06 Apr 2019 08:15:12 -0700 (PDT) Received: from mars (cpe-70-114-192-208.austin.res.rr.com. [70.114.192.208]) by smtp.gmail.com with ESMTPSA id j7sm9904132otr.50.2019.04.06.08.15.11 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 06 Apr 2019 08:15:11 -0700 (PDT) From: Alex Branham X-Google-Original-From: Alex Branham References: <861s2gffd3.fsf@zoho.eu> <83ef6fbqsz.fsf@gnu.org> <86r2afbof1.fsf@zoho.eu> <83sguva4qo.fsf@gnu.org> <86ef6fb3z5.fsf@zoho.eu> <83imvr9p9v.fsf@gnu.org> Date: Sat, 06 Apr 2019 10:15:09 -0500 In-Reply-To: <83imvr9p9v.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 06 Apr 2019 17:33:48 +0300") Message-ID: <87lg0n88si.fsf@utexas.edu> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain 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 Sat 06 Apr 2019 at 17:33, Eli Zaretskii wrote: >> From: Emanuel Berg >> Cc: 35164@debbugs.gnu.org >> Date: Sat, 06 Apr 2019 16:30:54 +0200 >> >> Eli Zaretskii wrote: >> >> > I don't think I understand how this answers >> > my question. Please humor me and provide >> > a direct answer. >> >> I'm dropping this issue 100%. I thought it >> would be a quick fix, but if you want >> docstrings that do not conform with your own >> rules do it. > > Which rules, please? I really don't think I understand that, and I > don't think I asked something that should trigger such a reaction. I > mean, if you submit a bug report, and I ask for clarifying it, why > would you refuse? I think this is a duplicate of bug#25193, which was fixed in the emacs-25 branch but wasn't in Emacs 25.1; it first appeared in Emacs 25.2. See commit 0c55cf43e61537364ee7ea3d6ba77bb6ac3ef8a3. Alex From unknown Tue Aug 19 02:58:15 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: Emanuel Berg Subject: bug#35164: closed (Re: bug#35164: 25.1; `re-search-forward' docstring args) Message-ID: References: <83bm1j9ldl.fsf@gnu.org> <861s2gffd3.fsf@zoho.eu> X-Gnu-PR-Message: they-closed 35164 X-Gnu-PR-Package: emacs Reply-To: 35164@debbugs.gnu.org Date: Sat, 06 Apr 2019 15:59:01 +0000 Content-Type: multipart/mixed; boundary="----------=_1554566341-30279-1" This is a multi-part message in MIME format... ------------=_1554566341-30279-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #35164: 25.1; `re-search-forward' docstring args 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 35164@debbugs.gnu.org. --=20 35164: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D35164 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1554566341-30279-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 35164-done) by debbugs.gnu.org; 6 Apr 2019 15:58:18 +0000 Received: from localhost ([127.0.0.1]:47402 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCnhy-0007rT-86 for submit@debbugs.gnu.org; Sat, 06 Apr 2019 11:58:18 -0400 Received: from eggs.gnu.org ([209.51.188.92]:51738) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCnhv-0007rF-Oy for 35164-done@debbugs.gnu.org; Sat, 06 Apr 2019 11:58:16 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:42501) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCnhq-0007Dy-4I; Sat, 06 Apr 2019 11:58:10 -0400 Received: from [176.228.60.248] (port=4860 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hCnhn-0002Hz-Lm; Sat, 06 Apr 2019 11:58:08 -0400 Date: Sat, 06 Apr 2019 18:57:58 +0300 Message-Id: <83bm1j9ldl.fsf@gnu.org> From: Eli Zaretskii To: Alex Branham In-reply-to: <87lg0n88si.fsf@utexas.edu> (message from Alex Branham on Sat, 06 Apr 2019 10:15:09 -0500) Subject: Re: bug#35164: 25.1; `re-search-forward' docstring args References: <861s2gffd3.fsf@zoho.eu> <83ef6fbqsz.fsf@gnu.org> <86r2afbof1.fsf@zoho.eu> <83sguva4qo.fsf@gnu.org> <86ef6fb3z5.fsf@zoho.eu> <83imvr9p9v.fsf@gnu.org> <87lg0n88si.fsf@utexas.edu> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 35164-done Cc: 35164-done@debbugs.gnu.org, moasenwood@zoho.eu 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 (-) > From: Alex Branham > Cc: Emanuel Berg , 35164@debbugs.gnu.org > Date: Sat, 06 Apr 2019 10:15:09 -0500 > > > Which rules, please? I really don't think I understand that, and I > > don't think I asked something that should trigger such a reaction. I > > mean, if you submit a bug report, and I ask for clarifying it, why > > would you refuse? > > I think this is a duplicate of bug#25193, which was fixed in the > emacs-25 branch but wasn't in Emacs 25.1; it first appeared in Emacs > 25.2. See commit 0c55cf43e61537364ee7ea3d6ba77bb6ac3ef8a3. Ah, okay, thanks. This explains why I didn't understand the original report: I was looking at the doc string in Emacs 26. So I think we can close this bug. ------------=_1554566341-30279-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 5 Apr 2019 20:45:52 +0000 Received: from localhost ([127.0.0.1]:46328 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCVii-0003Mn-5t for submit@debbugs.gnu.org; Fri, 05 Apr 2019 16:45:52 -0400 Received: from eggs.gnu.org ([209.51.188.92]:47261) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCVif-0003MZ-4H for submit@debbugs.gnu.org; Fri, 05 Apr 2019 16:45:51 -0400 Received: from lists.gnu.org ([209.51.188.17]:46488) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hCViT-0005hZ-Px for submit@debbugs.gnu.org; Fri, 05 Apr 2019 16:45:42 -0400 Received: from eggs.gnu.org ([209.51.188.92]:33320) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCViQ-0000Sy-Tz for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 16:45:37 -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,URIBL_BLOCKED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hCViD-0005Ez-4h for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 16:45:24 -0400 Received: from sender-pp-o92.zoho.eu ([185.20.209.252]:25781) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hCViB-0003cA-MI for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 16:45:20 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1554490745; cv=none; d=zohomail.eu; s=zohoarc; b=D8rmVZh4EzFkbAG0R31s+cYzwZEPVxKABlx6tU/PRYdA51l1+MXiSJzWM/5iX+4CidrXylCFaduwz1qd5nOS/I2m3XLSPEFuic4iUcg2+pMr3zKvGFUqj4ebVe5ifEQHdYelLZpci9cdg7WwpDCQi9Qq22RxYe0QLcdTthTxQQk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.eu; s=zohoarc; t=1554490745; h=Content-Type:Date:From:MIME-Version:Message-ID:Subject:To:ARC-Authentication-Results; bh=f7JeF8i3qfFZbXl1b2gq2nagDZsmilf+IWpTq675c4A=; b=jInrUF7ar+wJqiU+rNtc/RORU+fbNjSlgMWP5OCKbBiG4ROnbE2bDvJfkMOwH1ED3JIlJ2IKfOoD4kNV5F1IPxR8fSndtaBnig2UzrxJGr+AV4lDrb/8Emj69SPKCH1lK48nBrU668KuF/htn5l4KlzZ3AAuT1B1/XZQZlElGBU= ARC-Authentication-Results: i=1; mx.zohomail.eu; dkim=pass header.i=zoho.eu; spf=pass smtp.mailfrom=moasenwood@zoho.eu; dmarc=pass header.from= header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1554490745; s=admin; d=zoho.eu; i=moasenwood@zoho.eu; h=From:To:Subject:Date:Message-ID:MIME-Version:Content-Type; l=8289; bh=f7JeF8i3qfFZbXl1b2gq2nagDZsmilf+IWpTq675c4A=; b=YWQsbHcfosNECT85zbrfEFu73aPq3KWwlrvZ6xHTP2BiQFl8dhohOfKOIhN+jAfQ qom0fowDkhocCLXZENhajAhh1xVomC5A+gwkmd5RAU+d1VJcj1zutkPaM28k/v4cy+L qqj4lUdPNsJ41GRpLfRJexNBGJvBWGYOZr1HJa98= Received: from raspberrypi.zoho.eu (c-b895225c.021-67-7570702.bbcust.telenor.se [92.34.149.184]) by mx.zoho.eu with SMTPS id 1554490745065718.4363534371095; Fri, 5 Apr 2019 20:59:05 +0200 (CEST) From: Emanuel Berg To: bug-gnu-emacs@gnu.org Subject: 25.1; `re-search-forward' docstring args Mail-Copies-To: never Date: Fri, 05 Apr 2019 20:59:04 +0200 Message-ID: <861s2gffd3.fsf@zoho.eu> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-ZohoMailClient: External X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 185.20.209.252 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: 0.9 (/) X-Debbugs-Envelope-To: submit 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.1 (/) The `re-search-forward' docstring does not mention its arguments according to the norm. And it makes sense, often the first thing I do when I bring up the help buffer for a function is to search for a particular argument to see what it does. In GNU Emacs 25.1.1 (arm-unknown-linux-gnueabihf, GTK+ Version 3.22.11) of 2017-09-16, modified by Debian built on bm-wb-02 System Description: Raspbian GNU/Linux 9.8 (stretch) Configured using: 'configure --build arm-linux-gnueabihf --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --build arm-linux-gnueabihf --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --with-x=yes --with-x-toolkit=gtk3 --with-toolkit-scroll-bars 'CFLAGS=-g -O2 -fdebug-prefix-map=/build/emacs25-pkwV6G/emacs25-25.1+1=. -fstack-protector-strong -Wformat -Werror=format-security -Wall' 'CPPFLAGS=-Wdate-time -D_FORTIFY_SOURCE=2' LDFLAGS=-Wl,-z,relro' Configured features: XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND GPM DBUS GCONF GSETTINGS NOTIFY ACL LIBSELINUX GNUTLS LIBXML2 FREETYPE M17N_FLT LIBOTF XFT ZLIB TOOLKIT_SCROLL_BARS GTK3 X11 Important settings: value of $LANG: en_GB.UTF-8 locale-coding-system: utf-8-unix Major mode: Help Minor modes in effect: show-paren-mode: t shell-dirtrack-mode: t erc-list-mode: t erc-menu-mode: t erc-autojoin-mode: t erc-ring-mode: t erc-networks-mode: t erc-pcomplete-mode: t erc-match-mode: t erc-button-mode: t erc-fill-mode: t erc-stamp-mode: t erc-netsplit-mode: t erc-irccontrols-mode: t erc-noncommands-mode: t erc-move-to-prompt-mode: t erc-readonly-mode: t erc-scrolltobottom-mode: t global-eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-compression-mode: t buffer-read-only: t transient-mark-mode: t Recent messages: next-line: End of buffer [3 times] previous-line: Beginning of buffer [6 times] This is the one occurrence. [6 times] Type "q" to restore previous buffer, M-x scroll-up to scroll help. hit: 125 This is the one occurrence. [2 times] Mark set Saving file /home/incal/ooa/doodle.el... Wrote /home/incal/ooa/doodle.el Quit Load-path shadows: /usr/share/emacs/25.1/site-lisp/debian-startup hides /usr/share/emacs/site-lisp/debian-startup /usr/share/emacs25/site-lisp/flim/md4 hides /usr/share/emacs/25.1/lisp/md4 /usr/share/emacs25/site-lisp/flim/hex-util hides /usr/share/emacs/25.1/lisp/hex-util ~/.emacs.d/lisp/abbrev hides /usr/share/emacs/25.1/lisp/abbrev ~/.emacs.d/emacs-init/gnus/server hides /usr/share/emacs/25.1/lisp/server /usr/share/emacs25/site-lisp/flim/sasl-ntlm hides /usr/share/emacs/25.1/lisp/net/sasl-ntlm /usr/share/emacs25/site-lisp/flim/sasl-cram hides /usr/share/emacs/25.1/lisp/net/sasl-cram /usr/share/emacs25/site-lisp/flim/ntlm hides /usr/share/emacs/25.1/lisp/net/ntlm /usr/share/emacs25/site-lisp/flim/sasl hides /usr/share/emacs/25.1/lisp/net/sasl /usr/share/emacs25/site-lisp/flim/hmac-def hides /usr/share/emacs/25.1/lisp/net/hmac-def /usr/share/emacs25/site-lisp/flim/hmac-md5 hides /usr/share/emacs/25.1/lisp/net/hmac-md5 /usr/share/emacs25/site-lisp/flim/sasl-digest hides /usr/share/emacs/25.1/lisp/net/sasl-digest /home/incal/.emacs.d/elpa/seq-2.20/seq hides /usr/share/emacs/25.1/lisp/emacs-lisp/seq /home/incal/.emacs.d/elpa/let-alist-1.0.5/let-alist hides /usr/share/emacs/25.1/lisp/emacs-lisp/let-alist Features: (shadow emacsbug conf-mode mm-archive sh-script smie executable mailalias w3m-cookie canlock url-http url-gw url-cache url-auth mail-extr qp gnus-async gnus-bcklg gnus-ml make-mode eieio-opt speedbar sb-image ezimage dframe find-func whitespace cus-edit cus-start cus-load tabify nnir cursor-sensor pop3 nndraft nnmh nnml network-stream nsm starttls gnus-agent nnvirtual nntp gnus-cache w3m-filter ffap paren xsel w3m-form google-translate-core-ui ido google-translate-core google-translate-tk url url-proxy url-privacy url-expand url-methods url-history url-cookie url-domsuf url-util url-parse url-vars json map lpr tramp-sh term disp-table ehelp my-faces t-mouse man tex-mode iterate-files seq-24 isbn my-bibtex bibtex slime-presentations slime-repl slime-parse bridge nroff-mode sgml-mode cobol-mode ada-mode which-func imenu align find-file checkdoc cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs guile summary message-my moggle mail-to-many mail smtpmail sendmail font-lock-add global-keys yank-my wrap-search w3m-unisearch w3m-search spell-new ispell sort-my sort slime etags xref project arc-mode archive-mode noutline outline easy-mmode hyperspec shell-cli revert-buffer-my lisp-new ielm kill keys help-new debug apropos dired-x compile-my mode-line compile article gnus-cite dl bookmarks w3m-bookmark file-write-to erc-my fill-new quit gnus-my group group-summary gnus-srvr gnus-score score-mode gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime smime dig mailcap gnus-sum gnus-group gnus-undo gnus-start gnus-cloud nnimap nnmail mail-source tls gnutls utf7 netrc nnoo parse-time gnus-spec gnus-int gnus-range gnus-win message rfc822 mml mml-sec epg mm-decode mm-bodies mm-encode mail-parse rfc2231 rfc2047 rfc2045 ietf-drums mailabbrev gmm-utils mailheader gnus gnus-ems nnheader mail-utils edit tabs dired-my w3m-my w3m-tabs w3m-session w3m browse-url doc-view jka-compr image-mode timezone w3m-hist w3m-fb bookmark-w3m w3m-ems w3m-ccl ccl w3m-favicon w3m-image w3m-proc w3m-util time-my linux-shell files-my tramp tramp-compat tramp-loaddefs trampver ucs-normalize shell advice sudo-user-path find-command window-new count get-search-string caps-back buffer-menu switch-to-buffer super scroll dired close buc switch-to-buffer-regexp subr-x align-new erc-list erc-menu erc-join erc-ring erc-networks erc-pcomplete pcomplete comint ansi-color ring erc-track erc-match erc-button wid-edit erc-fill erc-stamp erc-netsplit erc-goodies erc erc-backend erc-compat format-spec auth-source cl-seq eieio eieio-core cl-macs gnus-util time-date mm-util help-fns mail-prsvr password-cache thingatpt pp my-string search-regexp-in-files finder-inf info slime-autoloads package epg-config seq byte-opt gv bytecomp byte-compile cl-extra help-mode easymenu cconv cl-loaddefs pcase cl-lib w3m-load mule-util tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel 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 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 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 inotify dynamic-setting system-font-setting font-render-setting move-toolbar gtk x-toolkit x multi-tty make-network-process emacs) Memory information: ((conses 8 568743 119463) (symbols 24 49702 123) (miscs 20 430 2699) (strings 16 124676 18964) (string-bytes 1 3755177) (vectors 8 73911) (vector-slots 4 1902907 47046) (floats 8 609 647) (intervals 28 11167 1807) (buffers 520 100)) -- underground experts united http://user.it.uu.se/~embe8573 ------------=_1554566341-30279-1--