Re: Paragraph styles in doc strings

[Clément Pit--Claudel]

On 2016-05-16 16:53, Stefan Monnier wrote:
> If we ever want to refill docstrings automatically (ideally when
> displaying them), then we'll need some stronger hint than a newline.
> So I guess an empty line is not a bad idea, but I would indeed welcome
> some font-lock hack that make those empty lines shorter.

I'm not sure font-lock will work nicely for this. Blank lines are a multi-line 
pattern.

On the other hand, this seems to work OK:

(defvar help-blank-line-height 0.5)
(defvar help-blank-line-regexp "\n\n+")

(with-current-buffer "*Help*"
  (let ((inhibit-read-only t))
    (save-excursion
      (goto-char (point-min))
      (while (re-search-forward help-blank-line-regexp nil t)
        (font-lock-append-text-property
         (match-beginning 0) (match-end 0)
         'font-lock-face `(:height ,help-blank-line-height))))))

Of course, you could use that loop instead to add a font-lock-multiline 
property to the newlines, and then use this:

(with-current-buffer "*Help*"
  (font-lock-add-keywords nil '(("\n\n+" 0 `(face (:height 0.5))))))

But that sounds like more code for no added benefit. The simplest solution is 
probably to change the function that inserts the docstring to insert a string 
with the right properties applied.

Clément.

signature.asc
Description: OpenPGP digital signature