bug#81512: [PATCH] Add command `outline-occur'

 >> But I'm not 100% convinced
 >>
 >> - that we really never want to set this buffer-locally or globally
 >
 > Indeed, I see no reason to warn against setting it
 > buffer-locally or globally by a package.

It would give people yet another rope to hang themselves.  Appropriately
set, they can defy any ACTION argument specified via 'display-buffer'.

 >> - and we consequently should name it differently.
 >
 > Maybe by naming it as internal: display-buffer--alist?
 > Or if it's too confusing, then maybe display-buffer-internal-alist?

But we want to advertise it in the manual and we usually don't do that
for internal variables.

martin