GNU bug report logs - #37195
sed documentation improvement suggestion

Message received at submit <at> debbugs.gnu.org:

Received: (at submit) by debbugs.gnu.org; 26 Aug 2019 23:28:31 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Aug 26 19:28:31 2019
Received: from localhost ([127.0.0.1]:47334 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1i2OPX-00005J-Gn
	for submit <at> debbugs.gnu.org; Mon, 26 Aug 2019 19:28:31 -0400
Received: from lists.gnu.org ([209.51.188.17]:52054)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <yangshuai@HIDDEN>) id 1i2ONW-0008Sx-8A
 for submit <at> debbugs.gnu.org; Mon, 26 Aug 2019 19:26:26 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:57207)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <yangshuai@HIDDEN>) id 1i2ONV-0000Dl-8F
 for bug-sed@HIDDEN; Mon, 26 Aug 2019 19:26:26 -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,FREEMAIL_FROM,
 HTML_MESSAGE autolearn=disabled version=3.3.2
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <yangshuai@HIDDEN>) id 1i2ONU-0007Ba-Dn
 for bug-sed@HIDDEN; Mon, 26 Aug 2019 19:26:25 -0400
Received: from mail-io1-xd2e.google.com ([2607:f8b0:4864:20::d2e]:38951)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <yangshuai@HIDDEN>) id 1i2ONU-0007BP-5q
 for bug-sed@HIDDEN; Mon, 26 Aug 2019 19:26:24 -0400
Received: by mail-io1-xd2e.google.com with SMTP id l7so41768060ioj.6
 for <bug-sed@HIDDEN>; Mon, 26 Aug 2019 16:26:23 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=mime-version:from:date:message-id:subject:to;
 bh=n+/bDZwrxrLQDTVLcVNQA413Tsz0sqlALhzoHMMyr2Y=;
 b=Nif324u0qZG9XuP87DxXDhS8dFJHjZdeYOexc+J6yoV56SsTJa51g9Cu+XXBonyxMI
 XWw/Xf9nS/oCgJ1B+tTM6s5fQNCgFfoevFbA1qcPWR1et0GhyDF+ByMMOuyCyP9Vc+YJ
 E0GD4vlJpVb+IeIXTGSGRj8PapLq/oQ0n3dtEQmBqUlRobokzWtSAPb9bPFPRPJ5oCfN
 JljULYkWBYYRZKmUfp/wY2sDI5umLHMdAqRi97iwykOkvFhXjJg6zOetzmIweZ+0T4Vh
 iKZF+yC2VQfggZTGxH8b9OercXde3prd7VVaTQQRgo86Tpjut5k5GI/ac08uTL6tYM/g
 u58Q==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:mime-version:from:date:message-id:subject:to;
 bh=n+/bDZwrxrLQDTVLcVNQA413Tsz0sqlALhzoHMMyr2Y=;
 b=HGqit/A2/uAa2UbB3BYpt+S3Dfb8Pqh2yaEe/GQny9V0ojflIRG8BtbwzAGhv4Atb9
 tZKer3mnfhk3Kx+fnB+pL6vE1tZ3WT7eanVBbJcgVP9rZXjUBD3jost6U5ia/c4BkojF
 jNnewLnmdFUMbycc302MygAjfmJ+HuUHEykANsG3z1pbgTKRk0ic0UsuxIxArf6EuX7q
 PITo6fQDhP7NnpQDQhpNLNTnKOf4HV/ahUA4kC37CQiEnqOUN2NTPZuIEh+2d39XYiMP
 cCwFxLGLhRr4JerZOhkljCkmEhp2ubj1QztvdsUoFW8YbLxPOGk8iGuarj3d9pEt1pmt
 bF6A==
X-Gm-Message-State: APjAAAXY8wtcurhgcp29pCk9P+1dB4ei0RgLrrAiGXVvVt3IboVrF7x4
 mUZy5rXfKTBJAJbiNdKm0HNuccTpEepGlJzwmIgVvzY=
X-Google-Smtp-Source: APXvYqzEgufOWU7p451tNpjzzGnDGADkxtdmHlP8HfWK/hZtdtIT5Ue257wMC1pFaNR2m05KKUNWu7AlgpukGguROu8=
X-Received: by 2002:a5d:8452:: with SMTP id w18mr64140ior.193.1566861983263;
 Mon, 26 Aug 2019 16:26:23 -0700 (PDT)
MIME-Version: 1.0
From: is a <yangshuai@HIDDEN>
Date: Tue, 27 Aug 2019 07:26:12 +0800
Message-ID: <CABVfmbbK9bwZgGFOHxKz8B-DXQJw4beVQ=jw6i4dGJfrT6PSAQ@HIDDEN>
Subject: sed documentation improvement suggestion
To: bug-sed@HIDDEN
Content-Type: multipart/alternative; boundary="000000000000ecb5fd05910d7be4"
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
 recognized.
X-Received-From: 2607:f8b0:4864:20::d2e
X-Spam-Score: -1.3 (-)
X-Debbugs-Envelope-To: submit
X-Mailman-Approved-At: Mon, 26 Aug 2019 19:28:28 -0400
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.3 (--)

--000000000000ecb5fd05910d7be4
Content-Type: text/plain; charset="UTF-8"

Hi,

The sed 4.2.2 document states:

i \

       text   Insert text, which has each embedded newline preceded by a
backslash.


I suggest improving the wording here. We have the pattern space, the hold
space, the output stream, the error stream etc. Where are we insert the
text? The POSIX standard states that the text will be inserted into the
output stream. We'd better make it clear here.

Thanks,
Yang Shuai

--000000000000ecb5fd05910d7be4
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div class=3D"gmail_default" style=3D"font-family:georgia,=
serif;font-size:large">Hi,</div><div class=3D"gmail_default" style=3D"font-=
family:georgia,serif;font-size:large"><br></div><div class=3D"gmail_default=
" style=3D"font-family:georgia,serif;font-size:large">The sed 4.2.2 documen=
t states:</div><div class=3D"gmail_default" style=3D"font-family:georgia,se=
rif;font-size:large"><br></div><blockquote style=3D"margin:0 0 0 40px;borde=
r:none;padding:0px"><div class=3D"gmail_default" style=3D"font-family:georg=
ia,serif;font-size:large"><font color=3D"#674ea7">i \</font></div><div clas=
s=3D"gmail_default" style=3D"font-family:georgia,serif;font-size:large"><fo=
nt color=3D"#674ea7"><br></font></div><div class=3D"gmail_default" style=3D=
"font-family:georgia,serif;font-size:large"><font color=3D"#674ea7">=C2=A0 =
=C2=A0 =C2=A0 =C2=A0text =C2=A0 Insert text, which has each embedded newlin=
e preceded by a backslash.</font></div></blockquote><div class=3D"gmail_def=
ault" style=3D"font-family:georgia,serif;font-size:large"><br></div><div cl=
ass=3D"gmail_default" style=3D"font-family:georgia,serif;font-size:large">I=
 suggest improving the wording here. We have the pattern space, the hold sp=
ace, the output stream, the error stream etc. Where are we insert the text?=
 The POSIX standard states that the text will be inserted into the output s=
tream. We&#39;d better make it clear here.=C2=A0</div><div class=3D"gmail_d=
efault" style=3D"font-family:georgia,serif;font-size:large"><br></div><div =
class=3D"gmail_default" style=3D"font-family:georgia,serif;font-size:large"=
>Thanks,</div><div class=3D"gmail_default" style=3D"font-family:georgia,ser=
if;font-size:large">Yang Shuai</div></div>

--000000000000ecb5fd05910d7be4--