Re: FAQ question

From: Loki Harfagr (lars.hummigeret_at_yahuu.no)
Date: 04/27/05


Date: Wed, 27 Apr 2005 12:24:01 +0200

Le Tue, 26 Apr 2005 23:03:29 -0500, Ed Morton a écrit :

> Here is hopefully the final version of this proposed FAQ update. Speak
> now or forever hold your peace....

So I'll try and speak now, no peace for the restless !-)

No problem in the content, as far as I could see, remember, check.

Just a remark, a proposal on readability, like in most documents dealing
with vars, names, arrays, strings and all the fishes.

Wouldn't it be good to use the quoting `...' for quotations or emphasis
like in :

> A) Short answer = either of these, where "svar" is a shell variable
> and "avar" is an awk variable:

So it'd read :

> A) Short answer = either of these, where `svar' is a shell variable
> and `avar' is an awk variable:

Thus making easier to read without mixing up every symbol, just after :
>
> awk -v avar="$svar" '... avar ...' file
> awk 'BEGIN{avar=ARGV[1];ARGV[1]=""}... avar ...' "$svar" file

Or, later, in the list :
> If you wanted to find all lines in a given file that match text
> stored in a shell variable "svar" then you could use one of the
> following:
>
> a) awk -v avar="$svar" '$0 == avar' file
...

Reading this is easier for me with :

> If you wanted to find all lines in a given file that match text
> stored in a shell variable `svar' then you could use one of the
> following:
...

And
> 1) Old awk only works with forms "c" and "g", both of which have
> problems.

is clearer with :

> 1) Old awk only works with forms `c' and `g', both of which have
> problems.

Or is it I have read too much sendmail doc, conf and mc files ?-D)