On 2022-10-28 09:32:10 +0300, Eli Zaretskii wrote: > > Date: Fri, 28 Oct 2022 02:53:17 +0200 > > From: Vincent Lefevre <[email protected]> > > > > 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 <[email protected]> - 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)
