[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#37063: 26.2.90; Problems with recent CL support in checkdoc
From: |
Damien Cassou |
Subject: |
bug#37063: 26.2.90; Problems with recent CL support in checkdoc |
Date: |
Sat, 17 Aug 2019 13:41:57 +0200 |
In the context of bug#37034, some initial support for CL functions and
methods was added to checkdoc. On my code, the changes make checkdoc
trigger warnings on perfectly valid code IMO. For example,
(cl-defmethod foo ((a list)) "Return A.")
Checkdoc complains that LIST should be described. I disagree with that,
list is a type, not a argument name.
I attach to this bug report a patch introducing test cases to
checkdoc-tests.el. If it's not possible to implement full support for CL
I prefer that checkdoc doesn't complain even if there is a bug in the
docstring rather than checkdoc complains when the docstring is correct.
Best,
--
Damien Cassou
http://damiencassou.seasidehosting.st
"Success is the ability to go from one failure to another without
losing enthusiasm." --Winston Churchill
0001-checkdoc-CL-tests.patch
Description: Text Data
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- bug#37063: 26.2.90; Problems with recent CL support in checkdoc,
Damien Cassou <=