From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Michael Albinus Newsgroups: gmane.emacs.devel Subject: Re: Some ideas with Emacs Date: Fri, 29 Nov 2019 19:58:21 +0100 Message-ID: <87h82my0fm.fsf@gmx.de> References: <837e3iq0ks.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="91494"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Eli Zaretskii , Stefan Kangas , Anonymous , Emacs developers To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 29 20:09:13 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1ialdg-000Nf8-JO for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 20:09:12 +0100 Original-Received: from localhost ([::1]:34448 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ialdd-0004Hj-BF for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 14:09:10 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42668) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ialTf-0004GR-38 for emacs-devel@gnu.org; Fri, 29 Nov 2019 13:58:55 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ialTc-0000m3-Rd for emacs-devel@gnu.org; Fri, 29 Nov 2019 13:58:50 -0500 Original-Received: from mout.gmx.net ([212.227.17.22]:50579) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ialTc-0000J9-DO; Fri, 29 Nov 2019 13:58:48 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1575053906; bh=Wfvv2TlbhPH/E89MSWN0kWxZITjbT64gqtZWtPW0Y8A=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=D8VptOxyv5hw5Emj3Tldxsih9G8UKUW3kmHVKleTKKMNZc1LN7zYNVw1eLK3q4vju HuVzx5O7S0RRgPgSpHd5ImSek6Jk7jBMP1Vo+drBXul7fMIQDJCRte+ICsnf83Z3Hd xa8J0NEp4nB43JDWe88x40n0CppXAk49aB7gmq8s= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from detlef.gmx.de ([212.91.243.137]) by mail.gmx.com (mrgmx105 [212.227.17.168]) with ESMTPSA (Nemesis) id 1N1wll-1hd7Y83G37-012Fcy; Fri, 29 Nov 2019 19:58:25 +0100 In-Reply-To: (Stefan Monnier's message of "Fri, 29 Nov 2019 10:36:23 -0500") X-Provags-ID: V03:K1:QXPU8YTVcjOKYH5sl1XZfm4WtbJ+qzdWwiCapto6bL4+XHM3CYd sa1yC/nfLCYnLB91RMQbOl58/7zfxO1VJUeks4yvHbDWW/MUUuWiKVBXc/eOi4Q4VYDT0rK qe79tPYQLSv+qyVW7abhXmnGyVTK9cktxR0YIC9QIu0dI1X/ub1TOyM+3YLxWpaCq+koWDo teRb2T9gZMt5BMB5F1Wrg== X-UI-Out-Filterresults: notjunk:1;V03:K0:gBMgCjCeLeE=:SnBOw8/LI29nT5uqj5H6dj lZk4n/JBH9RnDBQsHf0C5pj/zbxQNwEpxlqlt12ZJM6R7YUIo4YDVL8gEJKjyk68ObP/ZTUbr f28Jvpum8SHf9tFLEOcvkFl+DwdcHdOSRLIxLKB+oLtnjcXkK9yuFnwdseolk6prjJBHk4iP7 LikKab9ShtD4903NA+TycX/vMUw/CTZZ69fuv34VERrZHRHzGFa9ZtFeoR228NQKBbgw9z3Zf NxZRUZ4STWJRoe1lVBfvO1Dcwe2IAYvmkPEHfHd12uYoDkYnbDvTnN47Bn9drdbTb7LEOhDjE roHyIh5NQ0757rmSxU9/jmxlY6EiXaIvaMw3Iu1BZrN6X4/Lme3AbVI1w7a+4w4s/YUYMHr2E 5YAfqbNV0+0nmMXoVZdnDie8/Qi5+4t7cBavqjxEvctlMd+Et3fNl1qOK37LKidadex2Omezr yah6VyIsb7I4VfyRjpNMGQi589h6lDroQ6F+piqbLtwO8q0xvqz99Suh1gd9L+6miRniKPLjf kcehSD+8bJxWf1uveGHI4b1fmqImVPOHEY9QE6n9npmc9/Mq9Q8vxBc5AB+oRUtEqf1TVKyyi AyF9hxVLJ0NcoCO9hz2twzYbXnNtdaDh+hMWPWOOpaLdvySoEEIftDqdvK+BKqa5yLyitCKw3 JR7zJrN2AWU2hihh/WLXjpQNMKRTgYXdmPiakESYH6364I+foRU7rMN0KVEZQlEyqzucdJMIu x/yqrIdHMpHRzoAwLjSnpMck5KiKOzI5FmhH2Hns81XKhRP4Uc4bNAxqRg0i/q/4eYKzzL10 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 212.227.17.22 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.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:242884 Archived-At: Stefan Monnier writes: > AFACT, currently we have some examples in the Elisp manual and very > few examples in docstrings. > It might be a good idea to encourage the addition of examples either in > docstrings or in the Elisp manual (or both). 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. But that's my taste, and maybe not the best approach. Don't know. > Stefan Best regards, Michael.