[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#6821: Documentation: `insert' needs refilled
From: |
MON KEY |
Subject: |
bug#6821: Documentation: `insert' needs refilled |
Date: |
Sun, 15 Aug 2010 16:28:56 -0400 |
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\