Re: docstrings (was: Prefix Argument and optional argument)

[Emanuel Berg]

Christopher Dimech wrote:

>>> The way it is implemented actually the docstring is part
>>> of the body!
>>
>> Which complicates things even more. Why are we getting
>> warnings then!!!
>
> Then we require a minimal test without warnings which would
> be
>
> (defun poke (prefix)
>   "Pokes the prefix argument
> PREFIX in the prefix argument."
>   (interactive "P")
>   (message "poke function"))

1 warning from the byte-compiler
    Warning: Unused lexical argument `prefix'
2 warnings from (checkdoc-current-buffer t)
    First sentence should end with punctuation
    First line is not a complete sentence
130 chars

Rather ...

(defun f (x)
  "X"
  (interactive "P")
  x)

0 warnings
43 chars

-- 
underground experts united
https://dataswamp.org/~incal