From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#26925: Improve /doc/lispref/strings.texi (split-string) documentation Date: Fri, 19 May 2017 14:47:53 +0300 Message-ID: <83o9up2hli.fsf@gnu.org> References: <93AB3C85-27C1-48FF-8C3D-B90B4CF33670@gmail.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1495194555 12793 195.159.176.226 (19 May 2017 11:49:15 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 19 May 2017 11:49:15 +0000 (UTC) Cc: 26925-done@debbugs.gnu.org To: Jean-Christophe Helary Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri May 19 13:49:12 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dBgP6-00037n-9L for geb-bug-gnu-emacs@m.gmane.org; Fri, 19 May 2017 13:49:08 +0200 Original-Received: from localhost ([::1]:58099 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dBgPB-0002EG-Vk for geb-bug-gnu-emacs@m.gmane.org; Fri, 19 May 2017 07:49:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60007) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dBgP5-0002DW-MA for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 07:49:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dBgP0-0002nT-PJ for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 07:49:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51816) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dBgP0-0002nN-MR for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 07:49:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1dBgP0-00063f-GM for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 07:49:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Fri, 19 May 2017 11:49:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 26925 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Mail-Followup-To: 26925@debbugs.gnu.org, eliz@gnu.org, jean.christophe.helary@gmail.com Original-Received: via spool by 26925-done@debbugs.gnu.org id=D26925.149519449423227 (code D ref 26925); Fri, 19 May 2017 11:49:02 +0000 Original-Received: (at 26925-done) by debbugs.gnu.org; 19 May 2017 11:48:14 +0000 Original-Received: from localhost ([127.0.0.1]:54492 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dBgOD-00062Z-Sg for submit@debbugs.gnu.org; Fri, 19 May 2017 07:48:14 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:40606) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dBgOC-00062N-B7 for 26925-done@debbugs.gnu.org; Fri, 19 May 2017 07:48:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dBgO1-0002Q2-TF for 26925-done@debbugs.gnu.org; Fri, 19 May 2017 07:48:06 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:53176) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dBgO1-0002Pn-Pq; Fri, 19 May 2017 07:48:01 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3529 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dBgO1-0006B4-1P; Fri, 19 May 2017 07:48:01 -0400 In-reply-to: <93AB3C85-27C1-48FF-8C3D-B90B4CF33670@gmail.com> (message from Jean-Christophe Helary on Mon, 15 May 2017 00:45:34 +0900) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:132635 Archived-At: > From: Jean-Christophe Helary > Date: Mon, 15 May 2017 00:45:34 +0900 > > I slightly changed the paragraph order in the documentation to (split-string) to make it more readable. > > Jean-Christophe > > =========================== > Improve documentation of (split-string) > > * /doc/lispref/strings.texi (split-string): change paragraph > order to improve readability. > =========================== Thanks, pushed. One nit: please don't refer to functions with syntax that looks like a function call, as in (split-string) above, or foo() for C sources. The GNU Coding Standards frown on such references, because they look like a call to a function with no arguments, which is not what is meant there. We use 'split-string' and 'foo' instead, i.e. the name of the function in quotes.