From unknown Mon Aug 18 08:50:55 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#25193 <25193@debbugs.gnu.org> To: bug#25193 <25193@debbugs.gnu.org> Subject: Status: [PATCH] Improve the doc of re-search-forward and re-search-backward. Reply-To: bug#25193 <25193@debbugs.gnu.org> Date: Mon, 18 Aug 2025 15:50:55 +0000 retitle 25193 [PATCH] Improve the doc of re-search-forward and re-search-ba= ckward. reassign 25193 emacs submitter 25193 Hong Xu severity 25193 minor tag 25193 patch fixed thanks From debbugs-submit-bounces@debbugs.gnu.org Mon Dec 12 22:20:53 2016 Received: (at submit) by debbugs.gnu.org; 13 Dec 2016 03:20:53 +0000 Received: from localhost ([127.0.0.1]:39946 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cGde9-0005LG-HT for submit@debbugs.gnu.org; Mon, 12 Dec 2016 22:20:53 -0500 Received: from eggs.gnu.org ([208.118.235.92]:43769) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cGde7-0005L3-UD for submit@debbugs.gnu.org; Mon, 12 Dec 2016 22:20:52 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cGde1-0000qa-Lq for submit@debbugs.gnu.org; Mon, 12 Dec 2016 22:20:46 -0500 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 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:57535) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cGde1-0000qT-IS for submit@debbugs.gnu.org; Mon, 12 Dec 2016 22:20:45 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:34714) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cGde0-0003IQ-Ab for bug-gnu-emacs@gnu.org; Mon, 12 Dec 2016 22:20:45 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cGddu-0000og-Pn for bug-gnu-emacs@gnu.org; Mon, 12 Dec 2016 22:20:44 -0500 Received: from sender163-mail.zoho.com ([74.201.84.163]:21453) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cGddu-0000o4-HP for bug-gnu-emacs@gnu.org; Mon, 12 Dec 2016 22:20:38 -0500 Received: from localhost (cpe-104-32-170-214.socal.res.rr.com [104.32.170.214]) by mx.zohomail.com with SMTPS id 1481599232121210.5515301411035; Mon, 12 Dec 2016 19:20:32 -0800 (PST) From: Hong Xu To: bug-gnu-emacs@gnu.org Subject: [PATCH] Improve the doc of re-search-forward and re-search-backward. Date: Mon, 12 Dec 2016 19:20:31 -0800 Message-Id: <1481599231-19381-1-git-send-email-hong@topbug.net> X-Mailer: git-send-email 2.1.4 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] 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.4 (----) 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: -4.4 (----) * search.c (Fre_search_forward, Fre_search_backward): Improve doc. --- src/search.c | 58 ++++++++++++++++++++++++---------------------------------- 1 file changed, 24 insertions(+), 34 deletions(-) diff --git a/src/search.c b/src/search.c index 9f55d728362a..81edc27ecdc8 100644 --- a/src/search.c +++ b/src/search.c @@ -2257,26 +2257,12 @@ See also the functions `match-beginning', `match-end' and `replace-match'. */) DEFUN ("re-search-backward", Fre_search_backward, Sre_search_backward, 1, 4, "sRE search backward: ", - doc: /* Search backward from point for match for regular expression REGEXP. -Set point to the beginning of the occurrence found, and return point. -An optional second argument bounds the search; it is a buffer position. - The match found must not begin before that position. A value of nil - means search to the beginning 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, position at 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 - forward, instead of backward, for -COUNT occurrences. A value of - nil means the same as 1. -With COUNT positive, the match found is the COUNTth to last one (or - last, if COUNT is 1 or nil) in the buffer located entirely before - the origin of the search; correspondingly with COUNT negative. - -Search case-sensitivity is determined by the value of the variable -`case-fold-search', which see. + doc: /* Search backward from point for regular expression REGEXP. +This function is almost identical to `re-search-forward', except for +that by default it searches backward instead of forward, and the sign +of COUNT also indicates exactly the opposite searching direction. -See also the functions `match-beginning', `match-end', `match-string', -and `replace-match'. */) +See `re-search-forward' for details. */) (Lisp_Object regexp, Lisp_Object bound, Lisp_Object noerror, Lisp_Object count) { return search_command (regexp, bound, noerror, count, -1, 1, 0); @@ -2286,21 +2272,25 @@ DEFUN ("re-search-forward", Fre_search_forward, Sre_search_forward, 1, 4, "sRE search: ", doc: /* 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 -`case-fold-search', which see. +The optional second argument BOUND is a buffer position that bounds + the search. 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. +The optional third argument NOERROR indicates how errors are handled + when the search fails. If it is nil or omitted, emit an error; if + it is t, simply return nil and do nothing; if it is neither nil nor + t, move to the limit of search and return nil. +The optional fourth argument COUNT is a number that indicates the + search direction and the number of occurrences to search for. If it + is positive, search forward for COUNT successive occurrences; if it + is negative, search backward, instead of forward, for -COUNT + occurrences. A value of nil means the same as 1. +With COUNT positive/negative, the match found is the COUNTth/-COUNTth + one in the buffer located entirely after/before the origin of the + search. + +Search case-sensitivity is determined by the variable +`case-fold-search'. See also the functions `match-beginning', `match-end', `match-string', and `replace-match'. */) -- 2.1.4 From debbugs-submit-bounces@debbugs.gnu.org Tue Dec 13 01:27:24 2016 Received: (at 25193) by debbugs.gnu.org; 13 Dec 2016 06:27:25 +0000 Received: from localhost ([127.0.0.1]:40029 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cGgYd-0001En-GU for submit@debbugs.gnu.org; Tue, 13 Dec 2016 01:27:23 -0500 Received: from mail-pf0-f196.google.com ([209.85.192.196]:36559) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cGgYc-0001Ea-Ce for 25193@debbugs.gnu.org; Tue, 13 Dec 2016 01:27:22 -0500 Received: by mail-pf0-f196.google.com with SMTP id c4so5506709pfb.3 for <25193@debbugs.gnu.org>; Mon, 12 Dec 2016 22:27:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=BSDgvVgSQiYtLorCSE1YFVr36zrJUSNozh8G/vzeC14=; b=0f+sXm05J/oYmkOS6uMAjXrYaKM65zLLncJL5NIBvVUJrFly9FB9fjYZnj2pPl0RXd ecBAVusxXLuJM96znJPh67wF+KySbheZ1mnchtCoCgFDISvfkiO07pwvLSxjg5r6bzIt mW7Gtx1iZ+3FxMA+UhZd0Pr8pS4Pr7jwa783HOfebqo2JxE8mB5V3YW+r+vhH559HqIE 4qcp4jiQ2koWS6GCdIeEZXtiT4Tvoz9xeaShPf1m//XZm2zGnib4VR2iVbiGGnIF8jcv BXABFwHeGPHJtx/AWMrbKuhuXNWsyS/wfrZdGW5lMdJ4m4ZL64hrDeo46MttsSx+sXrr 59xQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=BSDgvVgSQiYtLorCSE1YFVr36zrJUSNozh8G/vzeC14=; b=LIEI+RdoroyTJ/8W/0jxjHc9chbXEXEC1Y2OUFZI0CBLXKC/s+DrkvWViU7Yos92du 8Bu8r/9yiUHp8LWXHElt16RK2WAuDaP1TeE9JEU9XhirJIjqe5pPwzgewPSA+7c0/JBR SVZHEkR2HMldVoWcvQqRJoHwvHG3PzPYuhRqE5np3n/HRDOqaUOBukn0+p0J122ZtJt8 V54fXYF0F1blvoDXtrM9+p/cyTZRxOyXfbCjCEv6KIvRl9XH5bcmOg+xldWelN+CRpD5 aSHZkrx5xGXq+DR/poBqQmfM8fvaQL1Y84QXqikAB5Gx/8d3R4ldK5A1/w2WvrlXmHr6 lQBA== X-Gm-Message-State: AKaTC01JuNcdHOJUq4/L5BD2l+Un+zycCBI5ho6sCifb8fcg57Klt6dq2V4w8M1CKvjcPg== X-Received: by 10.98.76.8 with SMTP id z8mr100177319pfa.167.1481610436466; Mon, 12 Dec 2016 22:27:16 -0800 (PST) Received: from calancha-pc (177.192.218.133.dy.bbexcite.jp. [133.218.192.177]) by smtp.gmail.com with ESMTPSA id y15sm79383583pgc.43.2016.12.12.22.27.14 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 12 Dec 2016 22:27:15 -0800 (PST) From: Tino Calancha To: Hong Xu Subject: Re: bug#25193: [PATCH] Improve the doc of re-search-forward and re-search-backward. References: <1481599231-19381-1-git-send-email-hong@topbug.net> Date: Tue, 13 Dec 2016 15:27:03 +0900 In-Reply-To: <1481599231-19381-1-git-send-email-hong@topbug.net> (Hong Xu's message of "Mon, 12 Dec 2016 19:20:31 -0800") Message-ID: <87mvg0pcnc.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 25193 Cc: tino.calancha@gmail.com, 25193@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: -0.7 (/) Hong Xu writes: > * search.c (Fre_search_forward, Fre_search_backward): Improve doc. > --- > src/search.c | 58 ++++++++++++++++++++++++---------------------------------- > 1 file changed, 24 insertions(+), 34 deletions(-) > > diff --git a/src/search.c b/src/search.c > index 9f55d728362a..81edc27ecdc8 100644 > --- a/src/search.c > +++ b/src/search.c > @@ -2257,26 +2257,12 @@ See also the functions `match-beginning', `match-end' and `replace-match'. */) > > DEFUN ("re-search-backward", Fre_search_backward, Sre_search_backward, 1, 4, > "sRE search backward: ", > - doc: /* Search backward from point for match for regular expression REGEXP. > -Set point to the beginning of the occurrence found, and return point. > -An optional second argument bounds the search; it is a buffer position. > - The match found must not begin before that position. A value of nil > - means search to the beginning 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, position at 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 > - forward, instead of backward, for -COUNT occurrences. A value of > - nil means the same as 1. > -With COUNT positive, the match found is the COUNTth to last one (or > - last, if COUNT is 1 or nil) in the buffer located entirely before > - the origin of the search; correspondingly with COUNT negative. > - > -Search case-sensitivity is determined by the value of the variable > -`case-fold-search', which see. > + doc: /* Search backward from point for regular expression REGEXP. > +This function is almost identical to `re-search-forward', except for > +that by default it searches backward instead of forward, and the sign > +of COUNT also indicates exactly the opposite searching direction. > > -See also the functions `match-beginning', `match-end', `match-string', > -and `replace-match'. */) > +See `re-search-forward' for details. */) Thanks for the report. You could refer for details to the manual, maybe providing a link to the proper node; but you don't want to refer to the doc string of another function 'B' to document the arguments of the current function 'A'. IMO the doc string of 'A' must introduce all its arguments. Otherwise, i am worry you could go an step further, f.i. `search-forward'/ `search-backward' share the same optional arguments, so: 1) doc string `re-search-backward': See the doc string of `re-search-forward' for details. 2) doc string `re-search-forward': See the doc string of `search-backward' for details. 3) doc string `search-backward': See the doc string of `search-forward' for details. 4) doc string `search-forward': Wow, you are are very persistent user! Please see the manual for details, i am a very busy doc string. (Reminds me the paperwork in some public agencies). From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 02 00:41:40 2017 Received: (at 25193) by debbugs.gnu.org; 2 Apr 2017 04:41:40 +0000 Received: from localhost ([127.0.0.1]:56279 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cuXKe-0003P5-D1 for submit@debbugs.gnu.org; Sun, 02 Apr 2017 00:41:40 -0400 Received: from mail-io0-f195.google.com ([209.85.223.195]:34487) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cuXKd-0003Ou-Mt for 25193@debbugs.gnu.org; Sun, 02 Apr 2017 00:41:40 -0400 Received: by mail-io0-f195.google.com with SMTP id n76so9363344ioe.1 for <25193@debbugs.gnu.org>; Sat, 01 Apr 2017 21:41:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=c0X/ojUK2VflvUsqCibxdD7SJO+hOTy2O+2duu/EGTY=; b=alWhVn8OoUBYecec6rt9c7Pw0bS+CY9ZpTNx1pnoVFMHfLU2uGpsOzR3xFh7mM+mh4 1onML/JVrSOrRbquGnkBuAxPk9ezLw5XVfl9Y63DisYCksCt5KKxWRytL5nFwqxYk5/M t7Z2QPQgzt4TW1aFL0SRlp6eARpIPxHRDdQ16hrqc0BuEtqTCK7401U10p305f61xuQR nTxdYeGlK0ZKQ2k9CyZf0Mk8TQmEAbYHOFGo6sy6ElPq7JRPVpVYXP/4Rp4Af8NzWveF kt6tLPpZzDQUNxFf3Two3xPbqGE7I7VN4ynkg3GyGakiIDLLY/3r6iGLpHdVA5ZYnFiS Ko/g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=c0X/ojUK2VflvUsqCibxdD7SJO+hOTy2O+2duu/EGTY=; b=soyr33TgG7gP9/VZQthD4Ux8erNAW8Qd0qsmVzLrZyrTvv/v87vdD+Zsr8IpH4XKxB 9KGuiKb5d/andZYjL90whMyoEl7/5RS/BFA42sZQLNUiBpGdcGhgKVQagdA1gkHRMVSj FBbsBECOprEBYXxeM9rbN/ieGXnJscL4qIH/9+rq9ptvBLSJLc1RK9nmkQ6NLPlT0PSt FaPQ06AMse+j54akufJGON5HU8mwLrNrwbIXyAVyXiO0uGVIkdLwVRJpWGntspqr9UVz V5ju2/IdvXnK/NX9Bl7u2pAvG1TIO5QgerGYjuAZ7sPrPF7VW37oWXKKBr0GvgPpOiLO 1Jkw== X-Gm-Message-State: AFeK/H3rDEGne5/V8mCXkImyEaEB/6nzDqiix/GgCXie5aDYx4DP3mwS1xyo/HnmeGYBoQ== X-Received: by 10.107.35.211 with SMTP id j202mr11123223ioj.158.1491108094225; Sat, 01 Apr 2017 21:41:34 -0700 (PDT) Received: from zony ([45.2.7.65]) by smtp.googlemail.com with ESMTPSA id o97sm5760221ioi.53.2017.04.01.21.41.32 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 01 Apr 2017 21:41:33 -0700 (PDT) From: npostavs@users.sourceforge.net To: Tino Calancha Subject: Re: bug#25193: [PATCH] Improve the doc of re-search-forward and re-search-backward. References: <1481599231-19381-1-git-send-email-hong@topbug.net> <87mvg0pcnc.fsf@gmail.com> Date: Sun, 02 Apr 2017 00:42:57 -0400 In-Reply-To: <87mvg0pcnc.fsf@gmail.com> (Tino Calancha's message of "Tue, 13 Dec 2016 15:27:03 +0900") Message-ID: <87o9wfxvvy.fsf@users.sourceforge.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.1 (--) X-Debbugs-Envelope-To: 25193 Cc: 25193@debbugs.gnu.org, Hong Xu 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.1 (--) Tino Calancha writes: > Thanks for the report. > You could refer for details to the manual, maybe providing a link to the > proper node; but you don't want to refer to the doc string of another > function 'B' to document the arguments of the current function 'A'. > IMO the doc string of 'A' must introduce all its arguments. > > Otherwise, i am worry you could go an step further, f.i. > `search-forward'/ `search-backward' share the same optional arguments, so: I think it's okay to point to other functions, as long as we keep the chain to length 1. > 1) doc string `re-search-backward': See the doc string of `re-search-forward' > for details. > 2) doc string `re-search-forward': See the doc string of > `search-backward' for details. > 3) doc string `search-backward': See the doc string of > `search-forward' for details. > 4) doc string `search-forward': Wow, you are are very persistent > user! Please see the manual for details, i am a very busy doc string. :D But if all of `re-search-backword', re-search-forward', `search-backward', would say "see doc string of `search-forward'" I think it would be okay. From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 02 00:57:12 2017 Received: (at 25193) by debbugs.gnu.org; 2 Apr 2017 04:57:12 +0000 Received: from localhost ([127.0.0.1]:56288 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cuXZg-0003kz-Is for submit@debbugs.gnu.org; Sun, 02 Apr 2017 00:57:12 -0400 Received: from mail-pg0-f66.google.com ([74.125.83.66]:34824) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cuXZe-0003km-Ak for 25193@debbugs.gnu.org; Sun, 02 Apr 2017 00:57:10 -0400 Received: by mail-pg0-f66.google.com with SMTP id g2so23633194pge.2 for <25193@debbugs.gnu.org>; Sat, 01 Apr 2017 21:57:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:date:to:cc:subject:in-reply-to:message-id:references :user-agent:mime-version; bh=6w10KdxNHlnpqQtosgRbDByt90LoYy9+qfO55g2RYQI=; b=UO7E1W+dqns1Q/0dBNLYjn+UfnnHQk+7rq7pp/05cNe07mrStL6LVDpQH78hPvdP0C wGfbm6on7/0g1VgNZmflTPr5mCn6V6EJ33o+riOilYcnXDv+5hc1rvMApXrBRJspX8OC pgehnC07Ow4N7/76NTxJX3xir73KszS4ZhZOvo8yXfQS+Nuds1O1IBuBK0RfkANbHCW2 oz6q6/ZY8O5/5SbNeRYFo0NBTv9EVNW/UGeqV6B4KJ/WXxG3AIc230LreYphFCb1o301 677AY6APtGvgQ1Eoo7cZquiYIfv8RiS5G9bVD47XIANyqWOftUG7E6avnzCWZMmMYIQD r0xw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:date:to:cc:subject:in-reply-to:message-id :references:user-agent:mime-version; bh=6w10KdxNHlnpqQtosgRbDByt90LoYy9+qfO55g2RYQI=; b=m8PWyfZai+vjUUzQHjPukoRQf4uCcA7WwrvrdLXKaLprsu3n1egQaoPSRq0Wt82Kpo 9XEx+Is8G1a2u6nwqx6EhYgcgk45rhu7n2cMqgwjOHj+2ZQIo7JuVS/LkdLVnRK209sI lXqzZH3PP33qCNeNiSvXq/qlLmRtRfZWhfmNdILbSPtIL4uVD5qPaulK053kNUfT22Na haYP6bcRFxE0689JcyXCRl/49rqQb+ze4AEEnOPa8lChyxKwXgE0dra4/ZPGRT4atJ6Z IE+96BsqRQo79+WQIJz3ReklPzC+u3pMEdYHK+DUkscfgfuiea4LimjIee9ID8BQNGqc y82A== X-Gm-Message-State: AFeK/H1PSQioufWqd/QIgAa3osAmPg49AbgZD+x2SNVcZ1Nkxor1I0gFoFOFWD82wB00xA== X-Received: by 10.98.160.194 with SMTP id p63mr10454108pfl.72.1491109024375; Sat, 01 Apr 2017 21:57:04 -0700 (PDT) Received: from calancha-pc (234.204.100.220.dy.bbexcite.jp. [220.100.204.234]) by smtp.gmail.com with ESMTPSA id i15sm18455654pfj.51.2017.04.01.21.57.02 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 01 Apr 2017 21:57:03 -0700 (PDT) From: Tino Calancha X-Google-Original-From: Tino Calancha Date: Sun, 2 Apr 2017 13:57:00 +0900 (JST) X-X-Sender: calancha@calancha-pc To: npostavs@users.sourceforge.net Subject: Re: bug#25193: [PATCH] Improve the doc of re-search-forward and re-search-backward. In-Reply-To: <87o9wfxvvy.fsf@users.sourceforge.net> Message-ID: References: <1481599231-19381-1-git-send-email-hong@topbug.net> <87mvg0pcnc.fsf@gmail.com> <87o9wfxvvy.fsf@users.sourceforge.net> User-Agent: Alpine 2.20 (DEB 67 2015-01-07) MIME-Version: 1.0 Content-Type: text/plain; format=flowed; charset=US-ASCII X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 25193 Cc: Hong Xu , 25193@debbugs.gnu.org, Tino Calancha 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 Sun, 2 Apr 2017, npostavs@users.sourceforge.net wrote: > Tino Calancha writes: > >> Thanks for the report. >> You could refer for details to the manual, maybe providing a link to the >> proper node; but you don't want to refer to the doc string of another >> function 'B' to document the arguments of the current function 'A'. >> IMO the doc string of 'A' must introduce all its arguments. >> >> Otherwise, i am worry you could go an step further, f.i. >> `search-forward'/ `search-backward' share the same optional arguments, so: > > I think it's okay to point to other functions, as long as we keep the > chain to length 1. Maybe OK (see below for the rest of my answer, like in my example :) >> 1) doc string `re-search-backward': See the doc string of `re-search-forward' >> for details. >> 2) doc string `re-search-forward': See the doc string of >> `search-backward' for details. >> 3) doc string `search-backward': See the doc string of >> `search-forward' for details. >> 4) doc string `search-forward': Wow, you are are very persistent >> user! Please see the manual for details, i am a very busy doc string. > > :D > > But if all of `re-search-backword', re-search-forward', > `search-backward', would say "see doc string of `search-forward'" I > think it would be okay. OK for me if it's just 1 jump, but i slightly prefer self-contained docstrings. Don't know what Eli or John might think about it. From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 02 02:21:49 2017 Received: (at 25193) by debbugs.gnu.org; 2 Apr 2017 06:21:49 +0000 Received: from localhost ([127.0.0.1]:56369 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cuYtZ-0002yq-AJ for submit@debbugs.gnu.org; Sun, 02 Apr 2017 02:21:49 -0400 Received: from eggs.gnu.org ([208.118.235.92]:50174) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cuYtX-0002yd-93 for 25193@debbugs.gnu.org; Sun, 02 Apr 2017 02:21:47 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cuYtO-0002F2-IC for 25193@debbugs.gnu.org; Sun, 02 Apr 2017 02:21:42 -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,HTML_MESSAGE, RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:55462) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cuYt8-0001tm-1i; Sun, 02 Apr 2017 02:21:22 -0400 Received: from [109.253.207.101] (port=2230 helo=[10.163.190.48]) by fencepost.gnu.org with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1cuYt6-0003jh-RX; Sun, 02 Apr 2017 02:21:21 -0400 Date: Sun, 02 Apr 2017 09:21:16 +0300 Subject: =?US-ASCII?Q?Re:_bug#25193:_[PATCH]_Improve_the_doc_of?= =?US-ASCII?Q?_re-search-forward_and=0D_=09re-search-backward.?= Importance: normal From: eliz To: Tino Calancha , npostavs@users.sourceforge.net MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="--_com.samsung.android.email_60398298422890" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] Message-ID: X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 25193 Cc: Hong Xu , 25193@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: -5.0 (-----) ----_com.samsung.android.email_60398298422890 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: base64 Ci0tLS0tLS0tINeU15XXk9ei15Qg157Xp9eV16jXmdeqIC0tLS0tLS0t157XkNeqOiBUaW5vIENh bGFuY2hhIDx0aW5vLmNhbGFuY2hhQGdtYWlsLmNvbT4g16rXkNeo15nXmjogMi40LjIwMTcgIDA3 OjU3ICAoR01UKzAyOjAwKSDXkNecOiBucG9zdGF2c0B1c2Vycy5zb3VyY2Vmb3JnZS5uZXQg16LX ldeq16c6IDI1MTkzQGRlYmJ1Z3MuZ251Lm9yZywgVGlubyBDYWxhbmNoYSA8dGluby5jYWxhbmNo YUBnbWFpbC5jb20+LCBIb25nIFh1IDxob25nQHRvcGJ1Zy5uZXQ+INeg15XXqdeQOiBidWcjMjUx OTM6IFtQQVRDSF0gSW1wcm92ZSB0aGUgZG9jIG9mIHJlLXNlYXJjaC1mb3J3YXJkIGFuZAogCXJl LXNlYXJjaC1iYWNrd2FyZC4gCk9uIFN1biwgMiBBcHIgMjAxNywgbnBvc3RhdnNAdXNlcnMuc291 cmNlZm9yZ2UubmV0IHdyb3RlOgoKPj4gVGlubyBDYWxhbmNoYSA8dGluby5jYWxhbmNoYUBnbWFp bC5jb20+wqAKPj4gOkQKPj4KPj4gQnV0IGlmIGFsbCBvZiBgcmUtc2VhcmNoLWJhY2t3b3JkJywg cmUtc2VhcmNoLWZvcndhcmQnLAo+PiBgc2VhcmNoLWJhY2t3YXJkJywgd291bGQgc2F5ICJzZWUg ZG9jIHN0cmluZyBvZiBgc2VhcmNoLWZvcndhcmQnIiBJCj4+IHRoaW5rIGl0IHdvdWxkIGJlIG9r YXkuCj5PSyBmb3IgbWUgaWYgaXQncyBqdXN0IDEganVtcCwgYnV0IGkgc2xpZ2h0bHkgcHJlZmVy IHNlbGYtY29udGFpbmVkCj5kb2NzdHJpbmdzLsKgIERvbid0IGtub3cgd2hhdCBFbGkgb3IgSm9o biBtaWdodCA+dGhpbmsgYWJvdXQgaXQuCgoKT25lIGhvcCBpcyBmaW5lIHdpdGggbWUsIHRoYW5r cy4KCgo= ----_com.samsung.android.email_60398298422890 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: base64 PGh0bWw+PGhlYWQ+PG1ldGEgaHR0cC1lcXVpdj0iQ29udGVudC1UeXBlIiBjb250ZW50PSJ0ZXh0 L2h0bWw7IGNoYXJzZXQ9VVRGLTgiPjwvaGVhZD48Ym9keSBkaXI9ImF1dG8iPjxkaXY+PGJyPjwv ZGl2PjxkaXYgc3R5bGU9ImZvbnQtc2l6ZToxMDAlO2NvbG9yOiMwMDAwMDAiIGRpcj0icnRsIj48 IS0tIG9yaWdpbmFsTWVzc2FnZSAtLT48ZGl2Pi0tLS0tLS0tINeU15XXk9ei15Qg157Xp9eV16jX mdeqIC0tLS0tLS0tPC9kaXY+PGRpdj7XnteQ16o6IFRpbm8gQ2FsYW5jaGEgJmx0O3Rpbm8uY2Fs YW5jaGFAZ21haWwuY29tJmd0OyA8L2Rpdj48ZGl2Pteq15DXqNeZ15o6IDIuNC4yMDE3ICAwNzo1 NyAgKEdNVCswMjowMCkgPC9kaXY+PGRpdj7XkNecOiBucG9zdGF2c0B1c2Vycy5zb3VyY2Vmb3Jn ZS5uZXQgPC9kaXY+PGRpdj7XoteV16rXpzogMjUxOTNAZGViYnVncy5nbnUub3JnLCBUaW5vIENh bGFuY2hhICZsdDt0aW5vLmNhbGFuY2hhQGdtYWlsLmNvbSZndDssIEhvbmcgWHUgJmx0O2hvbmdA dG9wYnVnLm5ldCZndDsgPC9kaXY+PGRpdj7XoNeV16nXkDogYnVnIzI1MTkzOiBbUEFUQ0hdIElt cHJvdmUgdGhlIGRvYyBvZiByZS1zZWFyY2gtZm9yd2FyZCBhbmQKIAlyZS1zZWFyY2gtYmFja3dh cmQuIDwvZGl2PjxkaXY+PGJyPjwvZGl2PjwvZGl2Pk9uIFN1biwgMiBBcHIgMjAxNywgbnBvc3Rh dnNAdXNlcnMuc291cmNlZm9yZ2UubmV0IHdyb3RlOjxiciBkaXI9ImF1dG8iPjxiciBkaXI9ImF1 dG8iPiZndDsmZ3Q7IFRpbm8gQ2FsYW5jaGEgJmx0O3Rpbm8uY2FsYW5jaGFAZ21haWwuY29tJmd0 OyZuYnNwOzxiciBkaXI9ImF1dG8iPiZndDsmZ3Q7IDpEPGJyIGRpcj0iYXV0byI+Jmd0OyZndDs8 YnIgZGlyPSJhdXRvIj4mZ3Q7Jmd0OyBCdXQgaWYgYWxsIG9mIGByZS1zZWFyY2gtYmFja3dvcmQn LCByZS1zZWFyY2gtZm9yd2FyZCcsPGJyIGRpcj0iYXV0byI+Jmd0OyZndDsgYHNlYXJjaC1iYWNr d2FyZCcsIHdvdWxkIHNheSAic2VlIGRvYyBzdHJpbmcgb2YgYHNlYXJjaC1mb3J3YXJkJyIgSTxi ciBkaXI9ImF1dG8iPiZndDsmZ3Q7IHRoaW5rIGl0IHdvdWxkIGJlIG9rYXkuPGJyIGRpcj0iYXV0 byI+Jmd0O09LIGZvciBtZSBpZiBpdCdzIGp1c3QgMSBqdW1wLCBidXQgaSBzbGlnaHRseSBwcmVm ZXIgc2VsZi1jb250YWluZWQ8YnIgZGlyPSJhdXRvIj4mZ3Q7ZG9jc3RyaW5ncy4mbmJzcDsgRG9u J3Qga25vdyB3aGF0IEVsaSBvciBKb2huIG1pZ2h0ICZndDt0aGluayBhYm91dCBpdC48YnIgZGly PSJhdXRvIj48YnIgZGlyPSJhdXRvIj48YnIgZGlyPSJhdXRvIj5PbmUgaG9wIGlzIGZpbmUgd2l0 aCBtZSwgdGhhbmtzLjxiciBkaXI9ImF1dG8iPjxiciBkaXI9ImF1dG8iPjxiciBkaXI9ImF1dG8i PjwvYm9keT48L2h0bWw+ ----_com.samsung.android.email_60398298422890-- From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 02 10:57:29 2017 Received: (at control) by debbugs.gnu.org; 2 Apr 2017 14:57:29 +0000 Received: from localhost ([127.0.0.1]:57617 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cugwb-0002RI-9x for submit@debbugs.gnu.org; Sun, 02 Apr 2017 10:57:29 -0400 Received: from mail-io0-f180.google.com ([209.85.223.180]:36557) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cugwX-0002R2-Pv for control@debbugs.gnu.org; Sun, 02 Apr 2017 10:57:26 -0400 Received: by mail-io0-f180.google.com with SMTP id l7so62325771ioe.3 for ; Sun, 02 Apr 2017 07:57:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:subject:date:message-id:mime-version; bh=nf2N6p0RAtpPQCbD1uUz7/l6wff4IouG5XLm3kMmpjg=; b=dzHRfcnM7WE/l+vylN4AMO/W7AcSyEJ6sETsivnd028gQWcllMmy5SooOwDtg4UJsN xitETHdk9fNSAPoCyrHelmTNq24DCev9mQiSjyH3nlvJPtSWyCiqWIWnkN392HPaX2gS Zlj+Yzu0LHMHBmtI3iT0ezIQAAGxE+kdgUWbdpuL3dmGHJny0BoBgYQmIYtDTwCjNoQR yke5RZpzU2iZJF3dtKe/3Mp6pvax0wSawmpkDqhPVA5LS1AcnHuAyRlKQy6ew9DFBXzU c+c9eSQ6J50IEFn7vnlH9xKkz9jF4EMHjQyZ+ltRe23AUAbgXcibkQSc0rgzP46qgMeX RgRg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:subject:date:message-id :mime-version; bh=nf2N6p0RAtpPQCbD1uUz7/l6wff4IouG5XLm3kMmpjg=; b=snxvv6Byr1gj+vpZKuAHuHorwS4vjbpVckuE48VS1jLRrE3QKjOtLcL5jtGWvtSB9U nw2PuYeLUweEpTLWjqOioT7OvZM0kkqKXmYb7SA9R+mj6uAzsMdStUEKan+uuCPrwUoB 4yYDdgekVdRcbaFx8KmcueCHFQxssZcJhmQs4A5y1fNkRJEGP61sgGlwQYrNrugDOOgc MB/8YnlRgC8m4XKLcM6aQ/SD0xL1VZ8+862JOxGAGA62/dtAXLKP8BeMZZYX5Q5q67OG kpnris6NjkrgLCDgoxvZJZLd6Wh6HbZoDNnuEHPLDx5bdHbb5XeiUflTwnS7gYYgMaNu FvIw== X-Gm-Message-State: AFeK/H0I+XcoIob2qnZyUqvLYIrgJbebLZjuJGTWWqNp8A4WmszFUMP/+lPZ6yqdPpXE9A== X-Received: by 10.107.14.69 with SMTP id 66mr13667989ioo.88.1491145040298; Sun, 02 Apr 2017 07:57:20 -0700 (PDT) Received: from zony ([45.2.7.65]) by smtp.googlemail.com with ESMTPSA id e91sm292847itd.17.2017.04.02.07.57.19 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sun, 02 Apr 2017 07:57:19 -0700 (PDT) From: npostavs@users.sourceforge.net To: control@debbugs.gnu.org Subject: control message for bug #19948 Date: Sun, 02 Apr 2017 10:58:42 -0400 Message-ID: <8760imyhy5.fsf@users.sourceforge.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.1 (--) X-Debbugs-Envelope-To: control 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.1 (--) merge 19948 25193 quit From debbugs-submit-bounces@debbugs.gnu.org Thu Apr 06 19:18:15 2017 Received: (at 25193) by debbugs.gnu.org; 6 Apr 2017 23:18:15 +0000 Received: from localhost ([127.0.0.1]:35442 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cwGfP-0006Ww-KU for submit@debbugs.gnu.org; Thu, 06 Apr 2017 19:18:15 -0400 Received: from mail-io0-f196.google.com ([209.85.223.196]:36795) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cwGfO-0006Wd-6j; Thu, 06 Apr 2017 19:18:14 -0400 Received: by mail-io0-f196.google.com with SMTP id 68so5955449ioh.3; Thu, 06 Apr 2017 16:18:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=D31yC4wsmKZ61jg5mVhPO/ucimI28iOFQ0Q0psP8HgI=; b=OKsAftIgtd9qiLWHZmRMEdYCvZf4CnPywHH7K5u2kVqKoNKmoxfl+egXlNAT8jcWLI TSXMI5uXjT6ThM24jMr5tsr0E6nTQCJ7CVmUN7mBtF7fpoCNv+sbdY0rqUjE4uEcTstu gJisKbEX5a7fCJ9uEWA6/8tTQc8a+LDDYMQ9aCLudXPcPSxAkVq002h2FkA/YTxCrb51 /Amcxiyh03lKNJP8MQoSrD5iUNoJ2Mc2t1G7oKurv2JWVQfhOqXWllqbLeYzrwat/0Rm MJw1mFiAoyN0pNYFwVvHEp/XCiBpXW5CbmmaajGTDl03wVH8ATCCZTgszjtxYC08XQNV VUvw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=D31yC4wsmKZ61jg5mVhPO/ucimI28iOFQ0Q0psP8HgI=; b=F2Zkv3Bs7O6tbEjqPCe8+ZMguHQ7cTkzIRxV2hTBXBgze8rniGNAr+Q79nnOrmhiGn VR4R95tfsLRgaxOQKjD2XR80Wu5ouGzAMmmTXSD3j+SGkE18eKRe1BY0FW59FCkSBlEZ 5azfklaOr9ijv4bDls3Or5DzOy06UKgsx8kHOc+MKONSCs1Q+bpjQglltQGfg1yADc3Y V6V5e5mofm1ypfz07wgeF4KcHZYTEC+TQg0UVRSSq8lJx36ZGqK++6b3aA/Xr3MeYng0 +gpZGgGVnFrBP/RFjoAEqy1AY7iD0/0uhnHyJsPqJzfP5wiKMMRrS3vx8LdhLbigUNC0 j6mg== X-Gm-Message-State: AFeK/H1wtmxPpIMSQK7DQ9Xd86XZOYxQWqCnzI/Fj74VAKl0KZhW2oOE4j6Bm/p8dm4GVw== X-Received: by 10.107.138.14 with SMTP id m14mr39173327iod.235.1491520688688; Thu, 06 Apr 2017 16:18:08 -0700 (PDT) Received: from zony ([45.2.7.65]) by smtp.googlemail.com with ESMTPSA id y203sm1667943iod.11.2017.04.06.16.18.07 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Thu, 06 Apr 2017 16:18:07 -0700 (PDT) From: npostavs@users.sourceforge.net To: eliz Subject: Re: bug#25193: [PATCH] Improve the doc of re-search-forward and re-search-backward. References: <1481599231-19381-1-git-send-email-hong@topbug.net> Date: Thu, 06 Apr 2017 19:19:32 -0400 In-Reply-To: (eliz@gnu.org's message of "Sun, 02 Apr 2017 09:21:16 +0300") Message-ID: <87lgrdunsr.fsf@users.sourceforge.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.1 (--) X-Debbugs-Envelope-To: 25193 Cc: Hong Xu , 25193@debbugs.gnu.org, Tino Calancha 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.1 (--) tags 25193 fixed close 25193 25.2 quit eliz writes: >>> >>> But if all of `re-search-backword', re-search-forward', >>> `search-backward', would say "see doc string of `search-forward'" I >>> think it would be okay. >>OK for me if it's just 1 jump, but i slightly prefer self-contained >>docstrings. Don't know what Eli or John might >think about it. > > One hop is fine with me, thanks. Okay, pushed to emacs-25. From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 14 11:13:09 2017 Received: (at 25193) by debbugs.gnu.org; 14 Apr 2017 15:13:09 +0000 Received: from localhost ([127.0.0.1]:47335 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cz2uL-0003jI-6Y for submit@debbugs.gnu.org; Fri, 14 Apr 2017 11:13:09 -0400 Received: from petton.fr ([89.234.186.68]:59677) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cz2uJ-0003iq-Iw for 25193@debbugs.gnu.org; Fri, 14 Apr 2017 11:13:08 -0400 From: Nicolas Petton To: Hong Xu , 25193@debbugs.gnu.org Subject: Re: bug#25193: [PATCH] Improve the doc of re-search-forward and re-search-backward. In-Reply-To: <1481599231-19381-1-git-send-email-hong@topbug.net> References: <1481599231-19381-1-git-send-email-hong@topbug.net> Date: Fri, 14 Apr 2017 17:12:56 +0200 Message-ID: <87vaq7f2fb.fsf@petton.fr> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=petton.fr; s=mail; t=1492182780; bh=yyV8alh/zjo5kzcwzJHvckIcIAJ8hUf5h27qs4vweP8=; h=From:To:Subject:In-Reply-To:References:Date:Message-ID:MIME-Version:Content-Type; b=KOIb4hE9kSlNLZkvpsEBiLsiwxaoSJxUfDhb+HkvgERVeCS/0wqDgGIfnSz1GKD7MZKRx6afTg7XU/2KiS5LT7TZ5kVceBlMHkopamStEeNz8uKV/B3F8XY5WRq3FMz13JnDrA3sAgMY06SxaDEM4PINgaUQbhTboTKlARyvmm4= X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 25193 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.0 (/) --=-=-= Content-Type: text/plain Hong Xu writes: Hi Hong, Thanks for the patch. > * search.c (Fre_search_forward, Fre_search_backward): Improve > doc. Could you in the future add the path of files in commit messages? Your commit message would have looked like this: * src/search.c (Fre_search_forward, Fre_search_backward): Improve doc. We use commit messages to generate changelog files, and keep the etc/AUTHORS file up-to-date. Cheers, Nico --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQEcBAEBCAAGBQJY8Ob4AAoJECM1h6R8IHkQw2gIAIKnAQwbn6gPIIiobVrqAJ8t UE3CLjqLgJYBCG9LQ+3r/GHL5N0KVfyroO1+XUyC0NmAQI6qoF6t/HBsL6UTD6B0 L2nhuiCAiFGR5YBmEk39MFFxLs9++ynjMQBCFy/C5t0LwBY0RD/GYFmljaEU4em6 tWhQ7+4Nq6gC8c9cozqUbIdiuQoWovyRL1mOUpcPc63BdVqLMYTjFs908IqlShGi Tfh9JeAWb/YvddnSLEphZ4lOUuZO62+EEGfK0qXxql4ayPk/NIV5NjN62mNxnlUY USAlwuxLLALTQrZ5IWrsk18atK9Qii9kDmq8QjW3UdPvFQPu8HM6dRZCUmFARLo= =n3Ti -----END PGP SIGNATURE----- --=-=-=-- From unknown Mon Aug 18 08:50:55 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 13 May 2017 11:24:05 +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