Re: Grammar issues

[arnold]

Hi Alan.

It's great that you're going through the manual.  I will review
these and fix things up.

I have a request though. It's easier for me to deal with stuff like
this if I get it in a big batch instead of in bits and drabs. So by
all means, please do continue going through the documentation, but
please just send me one big report at the end.

If you wish to submit your suggested changes as a diff to
doc/gawktexi.in, that'd be even better!

To summarize: (a) this is great, keep up the good work, but (b) please
send any future stuff as one big report.

Thanks!

Arnold

Alan Welsh via "Bug reports only for gawk." <bug-gawk@gnu.org> wrote:

> Greetings,
>
> [Section 
> 4.1.1](https://www.gnu.org/software/gawk/manual/gawk.html#Read-Timeout) says,
>
> "Assigning a timeout value prevents read operations from blocking
> indefinitely. But bear in mind that there are other ways gawk can stall
> waiting for an input device to be ready. A network client can sometimes
> take a long time to establish a connection before it can start reading
> any data, or the attempt to open a FIFO special file for reading can
> block indefinitely until some other process opens it for writing."
>
> BUT,
>
> The verb "block" cannot be used intransitively here, since that meaning is
> inappropriate. Moreover, as a transitive verb, the read operation doesn't
> block anything. Instead, it gets blocked by some other mechanism. In
> other words, the read operation is the object of the verb, not the
> subject. This mistake occurs twice in the example paragraph.
>
> ########################################################################
>
> Section "[How to 
> Contribute](https://www.gnu.org/software/gawk/manual/gawk.html#How-To-Contribute)"
>  says,
>
> "In the hopes of doing something more broad, I acquired the awklang.org
> domain. Late in 2017, a volunteer took on the task of managing it.
> 
> If you have written an interesting awk program, that you would like to
> share with the rest of the world, please see http://www.awklang.org and
> use the “Contact” link."
>
> BUT,
>
> The comparative of "broad" is "broader", not "more broad". Also,
> the following is a restrictive clause, so the preceding comma should
> be deleted:
>
> "that you would like to share with the rest of the world"
>
> Cheers,
>
> Alan
>
> Sent with [ProtonMail](https://protonmail.com/) secure email.