RE: redisplay-dont-pause is not mentioned in the Emacs manual

[Drew Adams]

    >> I'm not certain it should be, as I'm not clear on how this
    >> user option works.
    >
    > I don't think it should be: it's not for users.  It's for Lisp
    > programs that need special attention from the display engine.

    Really?  I have it enabled for all my Emacs installations because I
    cannot stand the way buffer contents are updated during scrolling if
    it is not.  I'd appreciate it to become a defcustom.

I'd like to understand what it's for and how it works. That is my main
point: please enhance the doc a bit. Thx.