Re: Add hints to documentation of car and cdr for (e)lisp newcomers - take 2

[Stefan Monnier]

> The danger of going overboard is exactly what bothers me.  Which is
> why I think examples in doc strings should be used in exceptional
> cases, where they are absolutely necessary.  Not as a "why not?"
> addition.

I don't think docstring should come with examples.  Examples should be
provided separately for use by shortdoc.el and friends.
Then `C-h f` can also show those examples, but it can place them
elsewhere (e.g. hidden by default with a button to show them or
something like that).


        Stefan