Re: Texinfo manual: typos and English usage

[Vincent Lefevre]

On 2022-10-28 09:32:10 +0300, Eli Zaretskii wrote:
> > Date: Fri, 28 Oct 2022 02:53:17 +0200
> > From: Vincent Lefevre <vincent@vinc17.net>
> > 
> > The @code{makeinfo} program automatically determines node pointers
> > for a hierarchically organized document.  For it do to do this, each
> > @code{@@node} command should be followed immediately by a sectioning
> > command such as @code{@@chapter} or @code{@@section} (except that
> > comment lines may intervene).  Finally, you must follow the `Top'
> > [...]
> > 
> > Concerning "For it do to do this", I suppose that the first "do"
> > should not be there. But it is still a bit difficult to parse and
> > it should be simplified, IMHO. Replace it by "To this end"?
> 
> IMO, "To this end" is more abstract, and thus risks losing
> continuity.  I personally find nothing wrong with the original wording
> (except for the redundant "do", of course), but if clarification is
> still desired, my suggestion would be to make it more specific, not
> less specific.  For example:
> 
>   The @code{makeinfo} program can automatically determine node pointers
>   for a hierarchically organized document.  But for @code{makeinfo} to
>   be able to do that, each @code{@@node} command should be followed
>   immediately by a sectioning command such as @code{@@chapter} [...]

Yes, this would look better, IMHO.

-- 
Vincent Lefèvre <vincent@vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / AriC project (LIP, ENS-Lyon)