[debbugs-tracker] bug#15529: closed (paste documentation tweak)

[GNU bug Tracking System]

Your message dated Sat, 05 Oct 2013 03:53:46 +0100
with message-id <address@hidden>
and subject line Re: bug#15529: paste documentation tweak
has caused the debbugs.gnu.org bug report #15529,
regarding paste documentation tweak
to be marked as done.

(If you believe you have received this mail in error, please contact
address@hidden)


-- 
15529: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=15529
GNU Bug Tracking System
Contact address@hidden with problems
> --- Begin Message ---
>
>
>
> 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  <address@hidden>
>
>         * 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:
> +
> address@hidden
> +paste address@hidden@dots{} address@hidden@dots{}
> address@hidden example
> +
> +Example:
>  
> @@ -5979,8 +5985,2 @@
>  
> -Synopsis:
> -
> address@hidden
> -paste address@hidden@dots{} address@hidden@dots{}
> address@hidden 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:
> +
> address@hidden
> +$ cat num2 | paste -d"" - -
> +1 2
> address@hidden example
> +
>  @exitstatus
>
> Diff finished at Fri Oct  4 16:31:15
>
>
>
> --- End Message ---
> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: bug#15529: paste documentation tweak
>
>
>
>
> Date: 
>
> Sat, 05 Oct 2013 03:53:46 +0100
>
>
>
>
> User-agent: 
>
> Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130110 Thunderbird/17.0.2
>
>
>
>
> 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  <address@hidden>
> > 
> >       * 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:
> > +
> > address@hidden
> > +paste address@hidden@dots{} address@hidden@dots{}
> > address@hidden example
> > +
> > +Example:
> >  
> > @@ -5979,8 +5985,2 @@
> >  
> > -Synopsis:
> > -
> > address@hidden
> > -paste address@hidden@dots{} address@hidden@dots{}
> > address@hidden 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:
> > +
> > address@hidden
> > +$ cat num2 | paste -d"" - -
> > +1 2
> > address@hidden 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.
>
>
> --- End Message ---