> From: Ihor Radchenko <[email protected]>
> Cc: Sean Whitton <[email protected]>, Eli Zaretskii <[email protected]>,
>  [email protected], [email protected], [email protected]
> Date: Fri, 26 Jun 2026 18:07:44 +0000
> 
> > Not all regions make sense, indeed.  It's the responsibility of the
> > caller of `fill-region-as-paragraph` to make sure the region is indeed
> > "a (fillable) paragraph".  Usually this is done by calling
> > `fill-forward-paragraph` to determine the bounds of the region.
> 
> Is it? The docstring says
> 
>   "Fill the region as if it were a single paragraph.
> 
> It never hints that the region SHOULD be a single paragraph.
> After all, what is the point of that function if there is fill-paragraph
> already. It ought to do something else.

Feel free to suggest improvements to doc strings.  They are not carved
in stone, and aren't always 110% correct and accurate, let alone clear.

Reply via email to