From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Jean-Christophe Helary Newsgroups: gmane.emacs.bugs Subject: bug#26925: Improve /doc/lispref/strings.texi (split-string) documentation Date: Fri, 19 May 2017 21:23:57 +0900 Message-ID: <7F0AE9BE-93FF-4CF7-8F76-AE1BD0CFDDDC@gmail.com> References: <93AB3C85-27C1-48FF-8C3D-B90B4CF33670@gmail.com> <83o9up2hli.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1495196716 31290 195.159.176.226 (19 May 2017 12:25:16 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 19 May 2017 12:25:16 +0000 (UTC) Cc: 26925-done@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri May 19 14:25:09 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 1dBgxw-0007sg-6o for geb-bug-gnu-emacs@m.gmane.org; Fri, 19 May 2017 14:25:08 +0200 Original-Received: from localhost ([::1]:58526 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dBgy0-0003J2-1t for geb-bug-gnu-emacs@m.gmane.org; Fri, 19 May 2017 08:25:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40533) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dBgxu-0003HT-1k for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 08:25:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dBgxq-0005QB-In for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 08:25:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51837) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dBgxq-0005Q7-Eu for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 08:25:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1dBgxq-0000ER-5h for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 08:25:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Jean-Christophe Helary Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 19 May 2017 12:25:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 26925 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 26925-done@debbugs.gnu.org id=D26925.1495196646820 (code D ref 26925); Fri, 19 May 2017 12:25:02 +0000 Original-Received: (at 26925-done) by debbugs.gnu.org; 19 May 2017 12:24:06 +0000 Original-Received: from localhost ([127.0.0.1]:54513 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dBgww-0000DA-Mx for submit@debbugs.gnu.org; Fri, 19 May 2017 08:24:06 -0400 Original-Received: from mail-pf0-f173.google.com ([209.85.192.173]:33053) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dBgwv-0000Cg-B8 for 26925-done@debbugs.gnu.org; Fri, 19 May 2017 08:24:05 -0400 Original-Received: by mail-pf0-f173.google.com with SMTP id e193so39256755pfh.0 for <26925-done@debbugs.gnu.org>; Fri, 19 May 2017 05:24:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=OjFEWkUrJpRn5WYpSWh5FsCfYCn+QnWttnHr27x3J+A=; b=IhBb9tH6mYH368FK2hFiMSiyY49z7ouVD/OASvkb88ETGiFf/3lnN/XZSHhk1xzSPL P11JWWCD2HBg/4uw/HafeS+QnObdoP0vdar2Rn3/I7ORQZcLHPcknsOQLEly8Pu5/KjW Lv/E03AGOq3lyyv7BTd5htBEiF+lz0pWIWSKpa4wXll6Oy+ycNjD2NJhDUpsyu7nx12V M5dHSnwxT1mGgFfnYesgZeQp7+MaUjwyxoREfmp2r8Zjxedxbo7fHu0oJlCJG1jhZvTk nsB37FHgtfYsNpU+qatwJEzbkV9A1Wd0Zb3/XbvV7F/OaZSi/diQDu32Mcld6BEv8jOb XFbw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=OjFEWkUrJpRn5WYpSWh5FsCfYCn+QnWttnHr27x3J+A=; b=eDG1uy4hIS5BjPpklrJ82k9f8skVIUhbfGIGNjjVfdIADK8Dg2uwO0CfNnCyx5andB +Lt5vmHK5PFTrGQtJEqhEMR0C5KpxzkKi4UYWsx+ywrsfWRSq0eKZYgCUwv29WDXBZZz fY3xCAYPDJo7lXIZgnOWySIIaPkCGpy7oKBH6Ndl49RZbySE99TlM9mY3zQnt9VVzIew nZIevBf/rgNW5rKHPl6+dfYFg884vKi7HAt9u/ZopDbW+uEufWbdpnx0ZfXIQdNeS9Dz 2f7sWrwSxks+01oqEuw6u/M6kaIF5C8pWU8BuNN1Pfoxm40Yc5Moz8VFmy46nt6bw5X8 3CSA== X-Gm-Message-State: AODbwcBbHHymyS976VQCeUf2tygWPYzDHDdAEtPddSV37tFCSw3qVoaI JlUfjruU324FAw== X-Received: by 10.98.156.29 with SMTP id f29mr9960774pfe.82.1495196639472; Fri, 19 May 2017 05:23:59 -0700 (PDT) Original-Received: from [192.168.24.54] (pl25298.ag0304.nttpc.ne.jp. [133.232.153.210]) by smtp.gmail.com with ESMTPSA id n65sm17414010pga.8.2017.05.19.05.23.57 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 19 May 2017 05:23:58 -0700 (PDT) In-Reply-To: <83o9up2hli.fsf@gnu.org> X-Mailer: Apple Mail (2.3273) 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:132636 Archived-At: >> =========================== >> 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. Thank you Eli. So the function name should have been quoted in both occurrences? >> =========================== >> Improve documentation of 'split-string' >> >> * /doc/lispref/strings.texi 'split-string': change paragraph >> order to improve readability. >> =========================== JC