Re: Some ideas with Emacs

[Eli Zaretskii]

> From: Michael Albinus <address@hidden>
> Cc: address@hidden,  address@hidden,  address@hidden,
>   address@hidden
> Date: Fri, 29 Nov 2019 21:25:48 +0100
> 
> If a function is too complex to explain it in the docstring on, say one
> page of ~24 lines, one shall document it more verbose in the
> manual. Examples, if not necessary for understanding the docstring,
> shall be shown in the manual. In such cases, there shall be a link to
> the manual in the docstring.
> 
> If a function requires an exhaustive docstring, it could be an option
> to break it into several functions.
> 
> Maybe all of this is too restrictive. But you see the intention.

I don't think I'd mind, provided that it's worded as guidelines, not
as rigid rules.