From: Raymond T. <toy...@gm...> - 2025-07-20 21:15:38
|
On 7/20/25 10:33 AM, Robert Dodier wrote: > On Sun, Jul 20, 2025 at 7:25 AM Raymond Toy<toy...@gm...> wrote: >> In Integration.texi.m4, we have this block: >> >> @c ===beg=== >> @c f_1 (a) := integrate (x^3, x, 1, a); >> @c ev (f_1 (7), nouns); >> @c /* Note parentheses around integrate(...) in f_2 */ f_2 (a) := ''(integrate (x^3, x, 1, a)); >> @c f_2 (7); >> @c ===end=== > Probably a better approach is to just bring the comment out and make > it part of the text. I think that's better in general anyway. In this > case something like: > > Note parentheses around @code{integrate(...)} in code{f_2}. > > @c ===beg=== > [code, sans comment, goes here] > @c ===end=== Yes, that's a perfectly reasonable solution. > I suppose the use of quote-quote is questionable -- it is easy to > misunderstand what it does -- but that's apart from the formatting > problem. Yeah, I'm not generally trying to fix any of those things. I'm just basically running update_examples over the whole file and doing some minor tweaks on assumptions and such, if needed. ​ |