From unknown Mon Jun 23 18:29:37 2025 X-Loop: help-debbugs@gnu.org Subject: bug#15529: paste documentation tweak Resent-From: karl@freefriends.org (Karl Berry) Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Fri, 04 Oct 2013 23:35:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 15529 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 15529@debbugs.gnu.org X-Debbugs-Original-To: bug-coreutils@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.138092966928602 (code B ref -1); Fri, 04 Oct 2013 23:35:01 +0000 Received: (at submit) by debbugs.gnu.org; 4 Oct 2013 23:34:29 +0000 Received: from localhost ([127.0.0.1]:54882 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VSEtA-0007RF-Bp for submit@debbugs.gnu.org; Fri, 04 Oct 2013 19:34:29 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40209) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VSEt8-0007R8-Bk for submit@debbugs.gnu.org; Fri, 04 Oct 2013 19:34:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VSEt2-0007Eq-PV for submit@debbugs.gnu.org; Fri, 04 Oct 2013 19:34: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=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:48092) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VSEt2-0007Em-Mh for submit@debbugs.gnu.org; Fri, 04 Oct 2013 19:34:20 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:41901) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VSEsx-0007cM-JD for bug-coreutils@gnu.org; Fri, 04 Oct 2013 19:34:20 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VSEss-0007C7-SE for bug-coreutils@gnu.org; Fri, 04 Oct 2013 19:34:15 -0400 Received: from frenzy.freefriends.org ([66.54.153.139]:53635 helo=freefriends.org) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VSEss-0007C1-LL for bug-coreutils@gnu.org; Fri, 04 Oct 2013 19:34:10 -0400 X-Envelope-From: karl@freefriends.org X-Envelope-To: Received: from freefriends.org (localhost [127.0.0.1]) by freefriends.org (8.14.6/8.14.6) with ESMTP id r94NY9PY031288 for ; Fri, 4 Oct 2013 17:34:09 -0600 Received: (from nobody@localhost) by freefriends.org (8.14.6/8.14.6/submit) id r94NY97k031287; Fri, 4 Oct 2013 23:34:09 GMT Date: Fri, 4 Oct 2013 23:34:09 GMT Message-Id: <201310042334.r94NY97k031287@freefriends.org> X-Authentication-Warning: frenzy.freefriends.org: nobody set sender to karl@freefriends.org using -f From: karl@freefriends.org (Karl Berry) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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 (-----) I suggest the following small change to the paste node in the documentation. Sorry I don't have the git-fu to give you the patch in that format. 2013-10-04 Karl Berry * coreutils.texi (paste invocation): Move synopsis to above existing example; add second example for standard input. --- ORIG/coreutils.texi 2013-02-11 01:37:28.000000000 -0800 +++ coreutils.texi 2013-10-04 16:31:13.602509258 -0700 @@ -5963,3 +5963,9 @@ -For example: +Synopsis: + +@example +paste [@var{option}]@dots{} [@var{file}]@dots{} +@end example + +Example: @@ -5979,8 +5985,2 @@ -Synopsis: - -@example -paste [@var{option}]@dots{} [@var{file}]@dots{} -@end example - The program accepts the following options. Also see @ref{Common options}. @@ -6019,2 +6019,10 @@ +Here is another example, to paste together consecutive lines from +standard input, with a delimiter of a space: + +@example +$ cat num2 | paste -d"" - - +1 2 +@end example + @exitstatus Diff finished at Fri Oct 4 16:31:15 From unknown Mon Jun 23 18:29:37 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: karl@freefriends.org (Karl Berry) Subject: bug#15529: closed (Re: bug#15529: paste documentation tweak) Message-ID: References: <524F7F3A.4000208@draigBrady.com> <201310042334.r94NY97k031287@freefriends.org> X-Gnu-PR-Message: they-closed 15529 X-Gnu-PR-Package: coreutils Reply-To: 15529@debbugs.gnu.org Date: Sat, 05 Oct 2013 02:54:03 +0000 Content-Type: multipart/mixed; boundary="----------=_1380941643-14380-1" This is a multi-part message in MIME format... ------------=_1380941643-14380-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #15529: paste documentation tweak which was filed against the coreutils package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 15529@debbugs.gnu.org. --=20 15529: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D15529 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1380941643-14380-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 15529-done) by debbugs.gnu.org; 5 Oct 2013 02:53:51 +0000 Received: from localhost ([127.0.0.1]:55089 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VSI06-0003jW-BZ for submit@debbugs.gnu.org; Fri, 04 Oct 2013 22:53:50 -0400 Received: from mail1.vodafone.ie ([213.233.128.43]:36149) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VSI04-0003jO-Mc for 15529-done@debbugs.gnu.org; Fri, 04 Oct 2013 22:53:49 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ApMBAOt9T1JtTdZy/2dsb2JhbAANTMUrgSyDGQEBAQQyAUYQCw0LCRYPCQMCAQIBRQYNAQUCAQGxQZMcj1EHhCMDnl2OSA Received: from unknown (HELO [192.168.1.79]) ([109.77.214.114]) by mail1.vodafone.ie with ESMTP; 05 Oct 2013 03:53:47 +0100 Message-ID: <524F7F3A.4000208@draigBrady.com> Date: Sat, 05 Oct 2013 03:53:46 +0100 From: =?ISO-8859-1?Q?P=E1draig_Brady?= User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130110 Thunderbird/17.0.2 MIME-Version: 1.0 To: Karl Berry Subject: Re: bug#15529: paste documentation tweak References: <201310042334.r94NY97k031287@freefriends.org> In-Reply-To: <201310042334.r94NY97k031287@freefriends.org> X-Enigmail-Version: 1.5.2 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 15529-done Cc: 15529-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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 (/) On 10/05/2013 12:34 AM, Karl Berry wrote: > I suggest the following small change to the paste node in the > documentation. Sorry I don't have the git-fu to give you the patch in > that format. > > 2013-10-04 Karl Berry > > * coreutils.texi (paste invocation): Move synopsis to > above existing example; add second example for standard input. > > --- ORIG/coreutils.texi 2013-02-11 01:37:28.000000000 -0800 > +++ coreutils.texi 2013-10-04 16:31:13.602509258 -0700 > @@ -5963,3 +5963,9 @@ > > -For example: > +Synopsis: > + > +@example > +paste [@var{option}]@dots{} [@var{file}]@dots{} > +@end example > + > +Example: > > @@ -5979,8 +5985,2 @@ > > -Synopsis: > - > -@example > -paste [@var{option}]@dots{} [@var{file}]@dots{} > -@end example > - > The program accepts the following options. Also see @ref{Common options}. > @@ -6019,2 +6019,10 @@ > > +Here is another example, to paste together consecutive lines from > +standard input, with a delimiter of a space: > + > +@example > +$ cat num2 | paste -d"" - - > +1 2 > +@end example > + > @exitstatus > > Diff finished at Fri Oct 4 16:31:15 Yes the `paste` examples could be better. This might be a bit more instructive: $ seq 4 | paste -d ' ' - - 1 2 3 4 Also this might be good for comparison: $ seq 4 | paste -s -d ' ' 1 2 3 4 I'll push something like that in the morning. thanks, Pádraig. ------------=_1380941643-14380-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 4 Oct 2013 23:34:29 +0000 Received: from localhost ([127.0.0.1]:54882 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VSEtA-0007RF-Bp for submit@debbugs.gnu.org; Fri, 04 Oct 2013 19:34:29 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40209) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VSEt8-0007R8-Bk for submit@debbugs.gnu.org; Fri, 04 Oct 2013 19:34:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VSEt2-0007Eq-PV for submit@debbugs.gnu.org; Fri, 04 Oct 2013 19:34: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=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:48092) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VSEt2-0007Em-Mh for submit@debbugs.gnu.org; Fri, 04 Oct 2013 19:34:20 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:41901) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VSEsx-0007cM-JD for bug-coreutils@gnu.org; Fri, 04 Oct 2013 19:34:20 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VSEss-0007C7-SE for bug-coreutils@gnu.org; Fri, 04 Oct 2013 19:34:15 -0400 Received: from frenzy.freefriends.org ([66.54.153.139]:53635 helo=freefriends.org) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VSEss-0007C1-LL for bug-coreutils@gnu.org; Fri, 04 Oct 2013 19:34:10 -0400 X-Envelope-From: karl@freefriends.org X-Envelope-To: Received: from freefriends.org (localhost [127.0.0.1]) by freefriends.org (8.14.6/8.14.6) with ESMTP id r94NY9PY031288 for ; Fri, 4 Oct 2013 17:34:09 -0600 Received: (from nobody@localhost) by freefriends.org (8.14.6/8.14.6/submit) id r94NY97k031287; Fri, 4 Oct 2013 23:34:09 GMT Date: Fri, 4 Oct 2013 23:34:09 GMT Message-Id: <201310042334.r94NY97k031287@freefriends.org> X-Authentication-Warning: frenzy.freefriends.org: nobody set sender to karl@freefriends.org using -f From: karl@freefriends.org (Karl Berry) To: bug-coreutils@gnu.org Subject: paste documentation tweak X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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 (-----) I suggest the following small change to the paste node in the documentation. Sorry I don't have the git-fu to give you the patch in that format. 2013-10-04 Karl Berry * coreutils.texi (paste invocation): Move synopsis to above existing example; add second example for standard input. --- ORIG/coreutils.texi 2013-02-11 01:37:28.000000000 -0800 +++ coreutils.texi 2013-10-04 16:31:13.602509258 -0700 @@ -5963,3 +5963,9 @@ -For example: +Synopsis: + +@example +paste [@var{option}]@dots{} [@var{file}]@dots{} +@end example + +Example: @@ -5979,8 +5985,2 @@ -Synopsis: - -@example -paste [@var{option}]@dots{} [@var{file}]@dots{} -@end example - The program accepts the following options. Also see @ref{Common options}. @@ -6019,2 +6019,10 @@ +Here is another example, to paste together consecutive lines from +standard input, with a delimiter of a space: + +@example +$ cat num2 | paste -d"" - - +1 2 +@end example + @exitstatus Diff finished at Fri Oct 4 16:31:15 ------------=_1380941643-14380-1--