GNU bug report logs - #15529
paste documentation tweak

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: karl <at> freefriends.org (Karl Berry)
Subject: bug#15529: closed (Re: bug#15529: paste documentation tweak)
Date: Sat, 05 Oct 2013 02:54:03 +0000

[Message part 1 (text/plain, inline)]

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 <at> debbugs.gnu.org.

-- 
15529: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=15529
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Pádraig Brady <P <at> draigBrady.com>
To: Karl Berry <karl <at> freefriends.org>
Cc: 15529-done <at> debbugs.gnu.org
Subject: Re: bug#15529: paste documentation tweak
Date: Sat, 05 Oct 2013 03:53:46 +0100

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  <karl <at> gnu.org>
> 
> 	* 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.

[Message part 3 (message/rfc822, inline)]

From: karl <at> freefriends.org (Karl Berry)
To: bug-coreutils <at> gnu.org
Subject: paste documentation tweak
Date: Fri, 4 Oct 2013 23:34:09 GMT

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  <karl <at> gnu.org>

	* 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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.