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: Tue, 6 Jun 2017 06:24:18 +0900 Message-ID: <3BB3B4B8-2D33-4254-B7BB-09D218CE91BB@gmail.com> References: <93AB3C85-27C1-48FF-8C3D-B90B4CF33670@gmail.com> <83o9up2hli.fsf@gnu.org> <7F0AE9BE-93FF-4CF7-8F76-AE1BD0CFDDDC@gmail.com> <83inkx2eeu.fsf@gnu.org> <87vaoxoty1.fsf@rosalinde> <3D9A3600-CF3D-4DD9-866C-CBEE8F692B25@gmail.com> <83o9u5bde1.fsf@gnu.org> <12A8E2CE-F2F5-4DB9-88DE-BCD40513EEBA@gmail.com> <83h8zxb02p.fsf@gnu.org> <98B33B3E-AB18-4BDB-A012-5270F3FCD7C2@gmail.com> <83bmq4bhpv.fsf@gnu.org> <87efv09oqj.fsf@detlef> <83a85nc0tu.fsf@gnu.org> <5D1082E3-48E6-4A39-B831-55BA992C7CC9@gmail.com> <8337bfbvs0.fsf@gnu.org> <83r2yz9mnb.fsf@gnu.org> <8EB2DE67-3233-4E0F-9AAB-6CE34885536A@gmail.com> <83o9u2a2t8.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=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1496697912 6699 195.159.176.226 (5 Jun 2017 21:25:12 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 5 Jun 2017 21:25:12 +0000 (UTC) Cc: 26925@debbugs.gnu.org, stephen.berman@gmx.net, michael.albinus@gmx.de To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jun 05 23: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 1dHzUp-0001Sn-LK for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Jun 2017 23:25:07 +0200 Original-Received: from localhost ([::1]:35233 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dHzUu-00035H-NU for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Jun 2017 17:25:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44572) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dHzUo-000340-He for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 17:25:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dHzUk-0006vc-JP for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 17:25:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:55478) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dHzUk-0006vW-Gk for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 17:25:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1dHzUk-0005mc-7x for bug-gnu-emacs@gnu.org; Mon, 05 Jun 2017 17: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: Mon, 05 Jun 2017 21: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-submit@debbugs.gnu.org id=B26925.149669786922181 (code B ref 26925); Mon, 05 Jun 2017 21:25:02 +0000 Original-Received: (at 26925) by debbugs.gnu.org; 5 Jun 2017 21:24:29 +0000 Original-Received: from localhost ([127.0.0.1]:58155 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dHzUC-0005lh-SI for submit@debbugs.gnu.org; Mon, 05 Jun 2017 17:24:29 -0400 Original-Received: from mail-pf0-f194.google.com ([209.85.192.194]:33732) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dHzUA-0005lT-2y for 26925@debbugs.gnu.org; Mon, 05 Jun 2017 17:24:27 -0400 Original-Received: by mail-pf0-f194.google.com with SMTP id f27so21997966pfe.0 for <26925@debbugs.gnu.org>; Mon, 05 Jun 2017 14:24:26 -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=Tj5cnU/ZgkAZJB/cVqaTvo5cq2nN2twJIDnpRFGYwp4=; b=EUYBfZ41fJviV1WQHZlIkGYx0qTVrs52vKu+p5PFgcfdi/2YYVaxRI26Y5M3B+3V5V Q7PqgXFvGI50Az12snEy9pSQdiMPeS7u74kWbYTu1Jzk2WVl5zfeseyh6t4myXADDbGV QfW0QRMliH/XGx59eJ1u8ILsDU7FgLlqEGIqv8ikrUCXKJ3CvpB178Uaf87zlR/Fj9KG uUpHsEydQJYOd4fbzowZOd8FBkUdxrzWSOPcD8uujAydgHU1Rl30u1DW0qQ/bYK9gw8Z Jmkl0eF5khdROQ1Pkb6ZIA2ZpSfMt9gvRP9oCGpaIuaC74U/Gvm/FRmT57j8eT11OUsU /S+w== 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=Tj5cnU/ZgkAZJB/cVqaTvo5cq2nN2twJIDnpRFGYwp4=; b=SbmgMi4p/OP0B2kaZpTlvfVfaaLBre1upjaJPHPtrWxia2My/oonNtEVp+zjGY6WgO BxhJgl1wgBFpYG18RJscVTa16hCe+RllLygP0nUmkN0qAfC009yIDLW6PKkC46KDEDLw YzKmYNf1ZR4LM9l2GIbhK0A+W4HEXd+pQzSofs4sR5yW7JOAJwXgCUVQceXBSgEUohLB mzJArQxncDLQSkR+TRzr3ykj7St0Wr2NLFm7nfC47vMu9eskhKqfUFzNDxzb32zcN1TJ mlAdUhrCcWigoLFMnQoSRb0zs0bS+zps16bPK8CSFL7aBMbAJbBvHoXW4wyPte7FUeb8 GM9g== X-Gm-Message-State: AODbwcCRpbe8xLMm+ZcDC+rpbZeb7llT/AXduCHpr+53xStv3OkoXF+R a6wWVQOqwJaYTg== X-Received: by 10.99.96.81 with SMTP id u78mr16792745pgb.101.1496697860299; Mon, 05 Jun 2017 14:24:20 -0700 (PDT) Original-Received: from [192.168.24.55] (pl2587.ag0304.nttpc.ne.jp. [128.53.196.27]) by smtp.gmail.com with ESMTPSA id h28sm61581921pfd.55.2017.06.05.14.24.18 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 05 Jun 2017 14:24:19 -0700 (PDT) In-Reply-To: <83o9u2a2t8.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:133323 Archived-At: > 2017/06/06 0:09=E3=80=81Eli Zaretskii =E3=81=AE=E3=83=A1=E3= =83=BC=E3=83=AB: >=20 > In general, yes. But it isn't a mechanical replacement. Reading the strings, I had already figured that out :) I'll keep in mind your comment below when I work. And I'll stop using = this thread for this issue. Jean-Christophe=20 > For > starters, functions which get optional arguments from the prefix arg > don't need to state explicitly that this argument is optional, since > the reference to the prefix argument already does that. Some strings > say "nil or omitted", which is good enough. And in some cases > inserting "optional" would require more thorough rewrite of the doc > string, because the current style doesn't allow a simple insertion. >=20 > Thanks in advance for working on this.