Re: Explanations with an EQN User Guide

2023-05-23 Thread Damian McGuckin
On Tue, 23 May 2023, Douglas McIlroy wrote: The new wording in groff(7) seems to explain everything--a great improvement. But knowing how it works is not the same as knowing how to use it. I agree. In the absence of any useful examples, I think a hazard warning in the user guide is preferabl

Re: Explanations with an EQN User Guide

2023-05-23 Thread G. Branden Robinson
Hi Tadziu, At 2023-05-23T13:20:43+0200, Tadziu Hoffmann wrote: > Eqn makes troff assemble a string named "10", and at the end > of its output this string is interpolated: > > \*(10 Thanks for the reminder of another task for my GNU eqn(1) man page rewrite queue: *roff name space impact When

Re: Explanations with an EQN User Guide

2023-05-23 Thread G. Branden Robinson
Hi Doug, At 2023-05-23T11:07:46-0400, Douglas McIlroy wrote: > The new wording in groff(7) seems to explain everything--a great > improvement. But knowing how it works is not the same as knowing how > to use it. True! groff(7) isn't, and isn't intended to be, good at that. > In the absence of a

Re: Explanations with an EQN User Guide

2023-05-23 Thread Douglas McIlroy
The new wording in groff(7) seems to explain everything--a great improvement. But knowing how it works is not the same as knowing how to use it. In the absence of any useful examples, I think a hazard warning in the user guide is preferable to an explanatory essay. Maybe tabs in eqn should be off

Re: Explanations with an EQN User Guide

2023-05-23 Thread Tadziu Hoffmann
> The tab is passed to groff as \t\, man 7 groff says \t is > "uninterpreted", yet the tab skips to a tab stop set by .ta. > This leaves me totally confused, because groff apparently > ignores \t when it doesn't come from eqn. If, as i believe, > eqn doesn't know about .ta and groff doesn't know

Re: Explanations with an EQN User Guide

2023-05-22 Thread G. Branden Robinson
Hi Doug, At 2023-05-22T20:04:53-0400, Douglas McIlroy wrote: > > Basically, [if] a tab occurs within braces, it will be rejected. This statement of mine was, alas, too general. A tab within braces will be rejected (diagnosed and ignored) if the braces are necessary to disambiguate the input. >

Re: Explanations with an EQN User Guide

2023-05-22 Thread Damian McGuckin
Sadly Doug, I am nowhere near as economical with words as you! On Mon, 22 May 2023, Douglas McIlroy wrote: Basically, [if] a tab occurs within braces, it will be rejected. Running eqn standalone, I got identical outputs from these two inputs .EQ ab .EN .EQ {ab} .EN The tab is passed to g

Re: Explanations with an EQN User Guide

2023-05-22 Thread Douglas McIlroy
> Basically, [if] a tab occurs within braces, it will be rejected. Running eqn standalone, I got identical outputs from these two inputs .EQ ab .EN .EQ {ab} .EN The tab is passed to groff as \t\, man 7 groff says \t is "uninterpreted", yet the tab skips to a tab stop set by .ta. This leaves me

Re: Explanations with an EQN User Guide

2023-05-22 Thread G. Branden Robinson
[Sorry--my previous email was a botch.] At 2023-05-22T15:46:15+1000, Damian McGuckin wrote: > I am resurrecting my re-write of the EQN User Guide which was itself > an elaboration of Ted Harding's User Guide. I have used many examples > from BrianK's and LorindaC's original 2nd Edition EQN documen

Explanations with an EQN User Guide

2023-05-21 Thread Damian McGuckin
I am resurrecting my re-write of the EQN User Guide which was itself an elaboration of Ted Harding's User Guide. I have used many examples from BrianK's and LorindaC's original 2nd Edition EQN document because I wanted backwards continuity in the examples. Ted also addresses MM which I have