[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [elpa] externals/vertico-posframe 39dbdfe 6/7: Fix checkdoc warn.
|
From: |
Eli Zaretskii |
|
Subject: |
Re: [elpa] externals/vertico-posframe 39dbdfe 6/7: Fix checkdoc warn. |
|
Date: |
Fri, 29 Oct 2021 16:57:29 +0300 |
> From: Stefan Monnier <monnier@iro.umontreal.ca>
> Cc: emacs-devel@gnu.org, tumashu@163.com
> Date: Fri, 29 Oct 2021 09:42:14 -0400
>
> > Many times people don't reference the arguments there because they are
> > unaware of our style conventions, or because they cannot find the
> > wording which would mention the arguments and still stay within the
> > 80-char limitation.
>
> Hmm... AFAIK this warning is unrelated to the first line or the 80
> columns conventions. It just says things like:
>
> Argument ‘prompt’ should appear (as PROMPT) in the doc string
People sometimes give up mentioning the arguments because they cannot
find good words to describe them. This pressure is higher for the
first line.