Re: Is there a way to do large block of source code comments

["G.B." <bauhaus@futureapps.invalid>]

On 04.09.14 14:46, robin.vowels@gmail.com wrote:
> On Thursday, September 4, 2014 5:20:49 PM UTC+10, Georg Bauhaus wrote:
>> On 04.09.14 04:37, r.nospam@gmail.com wrote:
>>
>>> Um, comments highlighted in a different color from the code
>>
>>> make it clear which is commented.
>>
>>
>>
>> But highlighting doesn't make it clear what the "commented" text
>> is about,
>
> Just read the comment.

It is an onerous job of a programmer to spend payed time on
guessing the reasons that some lazy (or deprived) typist
has had when turning a large part of source text into a
"comment". More guesswork for both the IDE and the compiler,
in the presence of the usual pitfalls of multiline comment
indicators, will not help.  But, since you were switching use
cases ...

>> the current reader (human debugger, reviewer, successor) frequently
>> needs to understand it. (*)
>
> Knowledge of English would help.

... to natural language comments... Why was having YX ...PROSE
... YX technically superior for writing natural language comments?

>> Using comment indicators for disabling some source text is
>> the original sin.
>>
>> However, since the practice of "quickly disabling" a part of
>> the source text during coding is commonplace,
>
> And, I might add, during program testing, and in finding bugs in the compiler.

Oh. Now back to use case "disabled source text"... Where you
said that XY ... XY is convenient. Not for the team, as outlined.


I'd agree that "elegance" is subjective and makes the Rationale
sound like marketing jargon in "combining elegance with safety"
when addressing rather primitive aspects of comment syntax.
That still does not invalidate its technical arguments.