[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: document bugs
Re: document bugs
Wed, 27 Feb 2019 10:56:16 -0800
Mozilla/5.0 (Windows NT 6.1; WOW64; rv:38.0) Gecko/20100101 Thunderbird/38.5.0
I think the poster is trying to improve the documentation. That is good.
As Eric said, it could only be evaluated with a specific patch.
To my understanding, the post suggests replacing "while" with "wereas"
somewhere. But "wereas" is not a word, nor (usually) a while synonym. :(
It seems that "despite of" or "in contrast of" are also suggested as
alternatives to "while". However, "despite of" and "in contrast of" are
*not* grammatically correct English. :( Nor are they anything close to a
synonym for "while" or "until".
Take the sentence "While I was studying the m4 while command, my brain
exploded." :) It would be difficult to replace "while" with a good
equivalent. "As I was studying the m4 while command, my brain exploded"
is close. The literal would be "During the time I was studying the m4
while command, my brain exploded."
Or take "Until I studied the m4 until command, I was sane". :) The only
alternative seems "Before the time I studied the m4 until command, I was
IMO, the downside of the poster's good idea outweigh the upsides.
PS - The suggestion to expunge "while" and "until" from m4 docs (other
than as a command) reminds me a bit of some "constrained" novels. In one
example, "Gadsby" (not "The Great Gatsby"), no words containing the
letter "e" were used. :) Pretty challenging! In another example,
"Eunoia", each chapter only contains words with a single vowel. So there
might be a sentence like "Hassan can, at a handclap, call a vassal at
hand and ask that all staff plan a bacchanal". :)
On 2/27/2019 7:09 AM, Eric Blake wrote:
[I'm not sure why the original mail didn't seem to hit the list]
On 2/26/19 1:34 PM, HaimMelamed wrote:
after reading, maybe its better to change words like "while" with "wereas"
or "despite of" or "in contrast of" ......
because the confusion of known operational commands like "ifelse" or
"forloop" or "while" or "until".
Rather than a vague suggestion, it's easier to evaluate this if you can
propose an actual patch (showing both the before and after of a sentence
you find confusing without your rewording).
"despite of" and "in contrast of" are not idiomatic English; while I
don't mind helping you come up with grammar that matches a native
speaker's expectations, it's hard to do that without having an actual
sentence being changed, rather than just a couple of words from an