emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Some ideas with Emacs


From: Eli Zaretskii
Subject: Re: Some ideas with Emacs
Date: Fri, 29 Nov 2019 22:14:14 +0200

> From: Michael Albinus <address@hidden>
> Cc: address@hidden,  address@hidden,  address@hidden,
>   address@hidden
> Date: Fri, 29 Nov 2019 21:09:18 +0100
> 
> >> Personally, I don't like docstring to be too verbose. Usually, when a
> >> function is documented with both docstrings and a manual, I prefer to
> >> put the examples in the manual.
> >
> > I agree: the examples should be mostly in the manual.  Doc strings
> > should only have examples if it is otherwise very hard to explain
> > something.
> 
> Shall we say something like this in "(elisp) Documentation Tips"?

Not sure I understand what would you like to say there.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]