GNU bug report logs - #28014
Join Documentation Error

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 28014 in the body.
You can then email your comments to 28014 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Phlosioneer <mattmdrr2 <at> gmail.com>
To: bug-coreutils <at> gnu.org
Subject: Join Documentation Error
Date: Tue, 8 Aug 2017 07:31:19 -0400

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

Looking at the official coreutils documentation for join: at
https://www.gnu.org/software/coreutils/manual/html_node/join-invocation.html

The result of the example is incorrect.
It should read:

$ join file1 file2
a 1 X
e 5 Y

If this is the incorrect place to report a documentation bug, please let me
know and point me to the correct place. The introduction of the coreutils
manual does not specify where to send documentation errors.

[Message part 2 (text/html, inline)]

Message #8 received at 28014 <at> debbugs.gnu.org (full text, mbox):

From: Assaf Gordon <assafgordon <at> gmail.com>
To: Phlosioneer <mattmdrr2 <at> gmail.com>, 28014 <at> debbugs.gnu.org
Subject: Re: bug#28014: Join Documentation Error
Date: Tue, 8 Aug 2017 10:27:03 -0600

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

Hello,

On 08/08/17 05:31 AM, Phlosioneer wrote:
> Looking at the official coreutils documentation for join: at
> https://www.gnu.org/software/coreutils/manual/html_node/join-invocation.html
> 
> The result of the example is incorrect.
> It should read:
> 
> $ join file1 file2
> a 1 X
> e 5 Y

Thank you for the report.

The attached patch should fix it.

I'll push it soon if there are no objections.

regards,
 - assaf

[0001-doc-fix-join-example.patch (text/x-patch, attachment)]

Message #11 received at 28014 <at> debbugs.gnu.org (full text, mbox):

From: Phlosioneer <mattmdrr2 <at> gmail.com>
To: Assaf Gordon <assafgordon <at> gmail.com>
Cc: 28014 <at> debbugs.gnu.org
Subject: Re: bug#28014: Join Documentation Error
Date: Tue, 8 Aug 2017 17:46:30 -0400

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

Yup, looks good to me!

On Tue, Aug 8, 2017 at 12:27 PM, Assaf Gordon <assafgordon <at> gmail.com> wrote:

> Hello,
>
> On 08/08/17 05:31 AM, Phlosioneer wrote:
> > Looking at the official coreutils documentation for join: at
> > https://www.gnu.org/software/coreutils/manual/html_node/
> join-invocation.html
> >
> > The result of the example is incorrect.
> > It should read:
> >
> > $ join file1 file2
> > a 1 X
> > e 5 Y
>
> Thank you for the report.
>
> The attached patch should fix it.
>
> I'll push it soon if there are no objections.
>
> regards,
>  - assaf
>
>
>
>

[Message part 2 (text/html, inline)]

Message #14 received at 28014 <at> debbugs.gnu.org (full text, mbox):

From: Assaf Gordon <assafgordon <at> gmail.com>
To: Phlosioneer <mattmdrr2 <at> gmail.com>
Cc: 28014 <at> debbugs.gnu.org
Subject: Re: bug#28014: Join Documentation Error
Date: Tue, 8 Aug 2017 22:09:53 -0600

tag 28014 fixed
close 28014
stop

Hello,

On 08/08/17 05:31 AM, Phlosioneer wrote:
> Looking at the official coreutils documentation for join: at
>
>  https://www.gnu.org/software/coreutils/manual/html_node/join-invocation.html
>
> The result of the example is incorrect.

Fix pushed here:
https://git.savannah.gnu.org/cgit/coreutils.git/commit/?id=8e2929a29ba

regards,
 - assaf

Previous Next

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