Eli Zaretskii writes: > The doc strings are still not specific enough, sorry for being unclear > in what I meant. Let's take an example: > >> +(define-minor-mode comint-fl-mode >> + "Enable input fontification. > > The first line should say something like > > Enable input fontification in comint buffers. > >> +(defun comint--fl-off () >> + "Disable input fontification for the current buffer." > > Similarly here: > > Disable input fontification in the current comint buffer. > >> +(defun comint--fl-fontify-region (fun beg end verbose) >> + "Around advice for `font-lock-fontify-region-function'. > > Likewise here: mention comint in the first line. > >> +(defcustom shell-highlight-undef-aliases nil >> + "List of commands to highlight as a command alias." > > Here, the doc string should mention shell command aliases, otherwise > it's too general ("command alias" doesn't necessarily imply a shell). > > Please go over the doc strings with this criterion in mind, and see > what else needs to be fixed in the same way. Thanks for feedback, revised patches attached. I hope I've clarified the doc strings this time. I've also made a minor code simplification in the fourth patch. Best regards.