bug#6821: Documentation: `insert' needs refilled

[MON KEY]

On Sat, Aug 14, 2010 at 7:25 PM, Chong Yidong <cyd@stupidchicken.com> wrote:
>> "Point and before-insertion markers move forward to end up
>>    after the inserted text."
>
> Docstrings in Emacs have used this kind of indentation for ages.
> It's idiosyncratic, but there's no harm keeping in.
>

OK.
Out of curiosity is there a particular reason/rationale for why this
type of BOL offset appears for only _some_ docstrings?

Also, what is threshold for determining when it _is_ reasonable to
notify that a doc needs refilled?

I ask because I have the impression that Emacs 23.2 seems to have more
occurrences of these "idiosyncratic"
indentations than previous versions (though this impression may be do
to increased familiarity w/ the docs.)

Indeed, w/ some docstring instances the anomalous indentation occurs
across multiple lines to an extent that it  can impede/hinder ones
ability to grok the doc.

--
/s_P\