Subject: Re: bug#59662: 29.0.50; [PATCH] Add treesit--indent-defun

From: Dmitry Gutov <[email-masked]>
Date: Fri, 9 Dec 2022 22:30:55 +0200

On 09/12/2022 22:20, Eli Zaretskii wrote:

>> +(defun prog-fill-reindent-defun (&optional argument)
>> +  "Refill paragraph or reindent the definition that the point is on.
>> +
>> +If the point is in a string, or in a comment, or there is a
>> +comment on the current line, fill the paragraph that the point is
>> +in or is on the same line.
> 
> I don't understand the difference between "point is in a string, or in
> a comment" and "there is a comment on the current line".

The comment may start after point.

>> +Otherwise, reindent the definition around or below point."
> 
> Likewise this one is confusing.

The intent was to describe the behavior that follows 'mark-defun'. Which 
has this in its docstring:

   Put mark at end of this defun, point at beginning.
   The defun marked is the one that contains point or follows point.