[Top][All Lists]

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

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

From: Stefan Monnier
Subject: Re: Add hints to documentation of car and cdr for (e)lisp newcomers - take 2
Date: Fri, 16 Jul 2021 09:22:23 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux)

Jean-Christophe Helary [2021-07-16 11:08:42] wrote:
>> On Jul 16, 2021, at 9:22, Stefan Monnier <monnier@iro.umontreal.ca> wrote:
>>> 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.
> Do you have a list of "friends"? 

I don't have many friends, I'm afraid, no ;-)

> What is the way to add examples to the shordoc display ?

I think currently you need to add them to shortdoc.el.

>> 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).
> So, that mechanism does not exist yet, correct ?



reply via email to

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