[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Silence checkdoc for symbols designating major and minor modes
From: |
Stefan Monnier |
Subject: |
Re: Silence checkdoc for symbols designating major and minor modes |
Date: |
Fri, 30 Jul 2021 17:47:16 -0400 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) |
Philip Kaludercic [2021-07-27 21:50:43] wrote:
> an issue I have been having when documenting code is that checkdoc wants
> me to disambiguate symbols referring to major or minor modes. That
> usually means adding "function", "command" "variable", "option" or
> "symbol" but in my experience these usually do not fit.
I think it's a problem in checkdoc, which wants to impose a style which
is not usually followed in Emacs (and which `describe-symbol` makes
even less important).
Stefan