From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eduardo Ochs Newsgroups: gmane.emacs.devel Subject: Re: Add hints to documentation of car and cdr for (e)lisp newcomers - take 2 Date: Thu, 15 Jul 2021 12:52:08 -0300 Message-ID: References: <8735shrl57.fsf@tullinup.koldfront.dk> <83v95c7v3v.fsf@gnu.org> <87bl74evd7.fsf@gnus.org> <87bl74ry2z.fsf@gnus.org> <831r7z7jgl.fsf@gnu.org> <34DECD1C-E6E0-4ED1-965D-2BCFD6ABB565@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25147"; mail-complaints-to="usenet@ciao.gmane.io" Cc: asjo@koldfront.dk, Stefan Kangas , Emacs developers , Stefan Monnier , Lars Ingebrigtsen , Eli Zaretskii To: Yuan Fu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Jul 15 17:54:58 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1m43hS-0006Ls-7V for ged-emacs-devel@m.gmane-mx.org; Thu, 15 Jul 2021 17:54:58 +0200 Original-Received: from localhost ([::1]:40506 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1m43hR-0000kZ-6F for ged-emacs-devel@m.gmane-mx.org; Thu, 15 Jul 2021 11:54:57 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42980) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m43f1-0003dM-U0 for emacs-devel@gnu.org; Thu, 15 Jul 2021 11:52:27 -0400 Original-Received: from mail-pl1-x636.google.com ([2607:f8b0:4864:20::636]:33283) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1m43ey-0002n8-Ry; Thu, 15 Jul 2021 11:52:27 -0400 Original-Received: by mail-pl1-x636.google.com with SMTP id d1so3624235plg.0; Thu, 15 Jul 2021 08:52:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=8M7cft3sljHYEENYeNil/zsfsD5+NXdTRv9RzP08TnI=; b=LnISULfZc1O0uMLN9cUXSGtdNyN4hTyE9i3UJS+UOYkAEC14lJHGOHYIbnxnfSXyfF zyS9VVqf/ZXRqTBNeJm2lqRwba7R2oEwRQKHQB0WYpfmyYsRf+0XuYB9lEgNIl4Kcnnk orCSiryjz79aeDKPaQH8YoRSxckmMGWdjeZPJuaXFtM0S6T47YPS7vfctD/sAaBfoh40 UxgtLaHzDmuyPIw3dJHzB3dZuaCVcIyGMg5nx9ZKn6n347xBfBSf6dlDkllG3rKsX6ZX ibhAW/MQRKDlr66AyHQiRNHh70pwpSpbXl5TJMCnmJcpgS5WnvKByp+/xdqNby2RmexH ySag== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=8M7cft3sljHYEENYeNil/zsfsD5+NXdTRv9RzP08TnI=; b=AZ0rB6SKnPjXYBB8lLIWOtmNoAfYuDpab951UfEErvVO2zclSo3RtUqCnF5bQhmV3c E3RPEgD+m4bpv4THmBjykIWHSrVeBRk5sKP1B8pgP0aGu2lJ9mc5V6OqdfghG/O1JcqW kxgEV9IlXRn9BHO3UHPLpCZOTddAq89VyqlB8NHnx7ncnom1/AQ8nT7/tnIsloezpMtd 5Q8JMEWkgQvHf55h+pUJoPiMbWGctosfqJ/LJ9566otyBJdbuxXfTKzyeHY2zi22wrJX 52PxOU+W9ENVF3lZFGO3sZnSvjpaV/GEZKWSzgAQFmKIs2wa1o7vqEDdIEy/6IOl4k17 umxQ== X-Gm-Message-State: AOAM530+x/UKRzkJVgBtz4kEyjvOoCbHfm/AVsuy6l1VYCvwz8qb3vR6 GAUBQ1z8/pKozl/33GOibkHK41Bfq8ru/6naLKk= X-Google-Smtp-Source: ABdhPJwC0f9IkwznJLDHh6qI882O86rnbY9PuPnOE7IZdPsNhdruUFPodn7zpI8yDkK3J9rTKivfs2a0u22FJ+lod/0= X-Received: by 2002:a17:90a:d58f:: with SMTP id v15mr10638647pju.117.1626364341835; Thu, 15 Jul 2021 08:52:21 -0700 (PDT) In-Reply-To: <34DECD1C-E6E0-4ED1-965D-2BCFD6ABB565@gmail.com> Received-SPF: pass client-ip=2607:f8b0:4864:20::636; envelope-from=eduardoochs@gmail.com; helo=mail-pl1-x636.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:271259 Archived-At: There are some examples here too: http://angg.twu.net/eev-intros/find-elisp-intro.html#2 (This is one of the sandboxed tutorials of eev.) Cheers, Eduardo Ochs http://angg.twu.net/#eev On Thu, 15 Jul 2021 at 12:28, Yuan Fu wrote: > > > > On Jul 15, 2021, at 11:21 AM, Stefan Monnier w= rote: > > Eli Zaretskii [2021-07-15 17:14:18] wrote: > > From: Stefan Kangas > Date: Thu, 15 Jul 2021 13:39:54 +0200 > Cc: Eli Zaretskii , Adam Sj=C3=B8gren , > Emacs developers > In general, I think we should include more examples in our > documentation. shortdoc.el is a step forward here, and it would be > even better if you could see those examples when you pull up the > docstring of a function. > > > IMO, examples are for the manual, not for the doc strings. If some > parts of our manuals could benefit from more examples, patches for > that would be welcome. > > > I think displaying the examples we have in shortdoc.el in the > *Help* buffer would make a lot of sense. > > > > Some one wrote quite a few examples here: https://github.com/xuchunyang/e= lisp-demos > > Yuan