enforce/automate docstring correctnes (was: Re: docstrings)

[Emanuel Berg]

Instead of relying on humans not forgetting anything and also
getting the order and CAPS of the args the right way in the
docstrings, possibly after having (checkdoc-current-buffer t)
telling them about it - and incal yanking it on
gmane.emacs.help - it could be both enforced and automated
like this:

(defun (f "Advanced Functional Programming function") ((a "AFA Doku")
                                                       (o "Omega Supreme") )
  (+ a o) )

Because then, not providing docstrings everywhere would not
eval and `help-mode' would display it the correct way
including order. It'd be a Lisp OO thing; and Emacs' claim to
be "self-documenting" would ring not true but truer.

...

Why, you think the code looks too bad that way?

Compare

(defun f (a o)
"This is an Advanced Functional Programming function.

A is AFA Doku.

O is Omega Supreme."
  (+ a o) )

See? Not by much!

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