GNU bug report logs - #25870
give an example to show what lines join -a and -v are talking about

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 25870 in the body.
You can then email your comments to 25870 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: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: bug-coreutils <at> gnu.org
Subject: give an example to show what lines join -a and -v are talking about
Date: Sat, 25 Feb 2017 21:20:06 +0800

In (info "(coreutils) join invocation")

‘-a FILE-NUMBER’
     Print a line for each unpairable line in file FILE-NUMBER (either
     ‘1’ or ‘2’), in addition to the normal output.

OK but say if we can use both: -a 1 -a 2? (Answer: yes)
And if so how to tell which lines are from which file (Answer: by their content only).

‘-v FILE-NUMBER’
     Print a line for each unpairable line in file FILE-NUMBER (either
     ‘1’ or ‘2’), instead of the normal output.

OK but say if we can use both: -v 1 -v 2?
And if so how to tell which lines are from which file.

And in fact give an example to show what lines -a and -v are talking about!

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

From: Assaf Gordon <assafgordon <at> gmail.com>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 25870 <at> debbugs.gnu.org
Subject: Re: bug#25870: give an example to show what lines join -a and -v are
 talking about
Date: Mon, 27 Feb 2017 02:32:30 -0500

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

Hello Dan,
> On Feb 25, 2017, at 08:20, 積丹尼 Dan Jacobson <jidanni <at> jidanni.org> wrote:
> [...]
> And in fact give an example to show what lines -a and -v are talking about!
> 

Good idea.
Here's a rough draft.

comments welcomed,
 - assaf

[0001-doc-expand-join-section.patch.xz (application/octet-stream, attachment)]

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

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

From: Pádraig Brady <P <at> draigBrady.com>
To: Assaf Gordon <assafgordon <at> gmail.com>,
 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 25870 <at> debbugs.gnu.org
Subject: Re: bug#25870: give an example to show what lines join -a and -v are
 talking about
Date: Mon, 27 Feb 2017 00:35:44 -0800

On 26/02/17 23:32, Assaf Gordon wrote:
> Hello Dan,
>> On Feb 25, 2017, at 08:20, 積丹尼 Dan Jacobson <jidanni <at> jidanni.org> wrote:
>> [...]
>> And in fact give an example to show what lines -a and -v are talking about!
>>
> 
> Good idea.
> Here's a rough draft.

I like how the options are now presented first,
and one can jump to the (improved) examples if needed.

One typo I noticed: s/assumng/assuming/

It might be worth mentioning along with the
existing examples in the "unpaired lines" section
the associated set operations for the mathematically inclined?
  https://www.pixelbeat.org/cmdline.html#sets
I.E. s/print only common lines/&, i.e. the intersection of the files/

thanks!

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

From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: Assaf Gordon <assafgordon <at> gmail.com>
Cc: 25870 <at> debbugs.gnu.org, Pádraig Brady <P <at> draigBrady.com>
Subject: Re: bug#25870: give an example to show what lines join -a and -v are
 talking about
Date: Mon, 27 Feb 2017 18:26:11 +0800

I can't really tell, but it seems at the beginning there still lacks the
most basic "Hi kids, here is the 'join' command. It takes one file with
contents ... and and another file with contents ... and outputs ..."
before you get into any more niceties.

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

From: Assaf Gordon <assafgordon <at> gmail.com>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 25870 <at> debbugs.gnu.org, Pádraig Brady <P <at> draigBrady.com>
Subject: Re: bug#25870: give an example to show what lines join -a and -v are
 talking about
Date: Mon, 27 Feb 2017 16:02:53 -0500

Hello,
Thank you for your good comments.

> On Feb 27, 2017, at 05:26, 積丹尼 Dan Jacobson <jidanni <at> jidanni.org> wrote:
> 
> but it seems at the beginning there still lacks the
> most basic "Hi kids, here is the 'join' command [...] before you get into any more niceties.

I like this approach.
I've added the simplest case at the top.

> On Feb 27, 2017, at 03:35, Pádraig Brady <P <at> draigBrady.com> wrote:
>
> It might be worth mentioning along with the
> existing examples in the "unpaired lines" section
> the associated set operations for the mathematically inclined?
> https://www.pixelbeat.org/cmdline.html#sets

At the risk of being too verbose,
I've added all combinations to the 'unpaired lines' section,
and also added the examples from your website to a new section "Set operations on files".

Comments very welcomed,
 - assaf


P.S.
I'd also like to suggest to few texinfo commands to disable the directed quoting in examples
(which cause single-quote ASCII 0x27 to be rendered as a unicode character).
This makes copy&pasting from the HTML/PDF manual quite annoying.
Because these texinfo command is not available on older versions,
a slightly complicated hack is required, as done in 'sed':
  http://git.savannah.gnu.org/cgit/sed.git/tree/doc/config.texi

If you agree,
I'll add these commands, and wrap some '@examples' with these '@codequotebacktick' commands.

Also,
If anyone has a better solution to disable directed quotes in @examples globally - I'm very happy to use it.

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

From: Assaf Gordon <assafgordon <at> gmail.com>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 25870 <at> debbugs.gnu.org, Pádraig Brady <P <at> draigBrady.com>
Subject: Re: bug#25870: give an example to show what lines join -a and -v are
 talking about
Date: Mon, 27 Feb 2017 23:17:57 -0500

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

> On Feb 27, 2017, at 16:02, Assaf Gordon <assafgordon <at> gmail.com> wrote:
> [...]
> 
> I've added all combinations to the 'unpaired lines' section,
> and also added the examples from your website to a new section "Set operations on files".
> 
> Comments very welcomed,

Sorry, sent without the actual attachment.
Attached now.

[0001-doc-expand-join-section.patch.xz (application/octet-stream, attachment)]

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

From: Pádraig Brady <P <at> draigBrady.com>
To: Assaf Gordon <assafgordon <at> gmail.com>,
 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 25870 <at> debbugs.gnu.org
Subject: Re: bug#25870: give an example to show what lines join -a and -v are
 talking about
Date: Tue, 28 Feb 2017 07:13:33 -0800

On 27/02/17 20:17, Assaf Gordon wrote:
> 
>> On Feb 27, 2017, at 16:02, Assaf Gordon <assafgordon <at> gmail.com> wrote:
>> [...]
>>
>> I've added all combinations to the 'unpaired lines' section,
>> and also added the examples from your website to a new section "Set operations on files".
>>
>> Comments very welcomed,
> 
> Sorry, sent without the actual attachment.
> Attached now.
> 

+1 thanks!

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

From: Pádraig Brady <P <at> draigBrady.com>
To: Assaf Gordon <assafgordon <at> gmail.com>,
 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 25870 <at> debbugs.gnu.org
Subject: Re: bug#25870: give an example to show what lines join -a and -v are
 talking about
Date: Wed, 1 Mar 2017 18:47:13 -0800

forcemerge 25870 25871
close 25870
stop

On 27/02/17 20:17, Assaf Gordon wrote:
> 
>> On Feb 27, 2017, at 16:02, Assaf Gordon <assafgordon <at> gmail.com> wrote:
>> [...]
>>
>> I've added all combinations to the 'unpaired lines' section,
>> and also added the examples from your website to a new section "Set operations on files".
>>
>> Comments very welcomed,
> 
> Sorry, sent without the actual attachment.
> Attached now.

Pushed

cheers

Previous Next

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