bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Texinfo manual: typos and English usage


From: Eli Zaretskii
Subject: Re: Texinfo manual: typos and English usage
Date: Fri, 28 Oct 2022 09:32:10 +0300

> 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} [...]



reply via email to

[Prev in Thread] Current Thread [Next in Thread]