Re: Grammatical fixes in gawk manual v.3.1.8

[Ralf Wildenhues]

Hi Peter,

* Peter Axon wrote on Thu, Dec 02, 2010 at 11:14:53PM CET:
> > Peter Axon wrote on Thu, Dec 02, 2010 at 03:11:19AM CET:
> > > address@hidden Regexps}, for a
> > > +See @ref{Computed Regexps}, for a
> 
> Ralf Wildenhues wrote Thu, 2 Dec 2010 08:24:27 +0100:
> > This is better changed into
> >    @xref{...}
> > 
> > because @xref already includes the "See" (or "Note") in some of the
> > various output formats.  See 'info texinfo "Reference Syntax"'.
> 
> Ah I see. I didn't think to check the other output formats. I was
> reading the HTML version however I do remeber having a problem like
> this with Texinfo before. It seems the HTML output has neither `See'
> or `Note'. The sentences in question just start out:
> 
> ``Computed Regexps for a discussion ...''
> 
> Did you want me to change the two @refs to @xrefs and submit a new
> patch?

Sure, why not.  However, please note that I'm not maintaining gawk,
it's Arnold's call whether to take the patch or not, in either form.

> What about the final hunk below?

That looks good to me, sorry for being unclear.

> Are these things annoying? I know they're only small but I just want
> to help if I notice something.

Oh, I have no idea if some software maintainers find such patches
annoying, but I certainly don't, for packages I take care of; on the
contrary, every bit helps.  It might still take me a while to get to
patches, and AFAIK Arnold works in batches too.

Cheers,
Ralf