From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Some ideas with Emacs Date: Sun, 01 Dec 2019 01:04:56 -0500 Message-ID: References: <837e3iq0ks.fsf@gnu.org> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="24852"; mail-complaints-to="usenet@blaine.gmane.org" Cc: eliz@gnu.org, stefan@marxist.se, c4droid@foxmail.com, emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 01 07:05:28 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 1ibIMI-0006JZ-Ju for ged-emacs-devel@m.gmane.org; Sun, 01 Dec 2019 07:05:26 +0100 Original-Received: from localhost ([::1]:40970 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ibIMG-0004q2-Oj for ged-emacs-devel@m.gmane.org; Sun, 01 Dec 2019 01:05:24 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35531) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ibILy-0004pm-SO for emacs-devel@gnu.org; Sun, 01 Dec 2019 01:05:07 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:45050) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ibILu-0006Nw-R4; Sun, 01 Dec 2019 01:05:02 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1ibILo-0002F7-JV; Sun, 01 Dec 2019 01:04:56 -0500 In-Reply-To: (message from Stefan Monnier on Fri, 29 Nov 2019 10:36:23 -0500) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:242934 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > It might be a good idea to encourage the addition of examples either in > docstrings or in the Elisp manual (or both). The general intention is to make doc strings somewhat terse, and speak at greater length in the manual. So the place for these examples is the manual, not the doc strings. -- Dr Richard Stallman Founder, Free Software Foundation (https://gnu.org, https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)