From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: Some ideas with Emacs
Date: Fri, 29 Nov 2019 15:22:27 +0200
Message-ID: <837e3iq0ks.fsf@gnu.org>
References: <tencent_62132B59F40D0E9645A7AC1AC33FD7724808@qq.com>
 <CADwFkm=PmEhfd=HyUJCyYAuGXYPAwN-9bYsk74eNQkRbWAVYhQ@mail.gmail.com>
Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226";
	logging-data="189048"; mail-complaints-to="usenet@blaine.gmane.org"
Cc: c4droid@foxmail.com, emacs-devel@gnu.org
To: Stefan Kangas <stefan@marxist.se>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 29 15:14:00 2019
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
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 <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1iah20-000n2o-33
	for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 15:14:00 +0100
Original-Received: from localhost ([::1]:59562 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1iah1v-0000Fo-U7
	for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 09:13:57 -0500
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44715)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <eliz@gnu.org>) id 1iagE3-0008Vg-KF
 for emacs-devel@gnu.org; Fri, 29 Nov 2019 08:22:26 -0500
Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:44365)
 by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <eliz@gnu.org>)
 id 1iagDw-0003DF-NU; Fri, 29 Nov 2019 08:22:16 -0500
Original-Received: from [176.228.60.248] (port=4606 helo=home-c4e4a596f7)
 by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
 (Exim 4.82) (envelope-from <eliz@gnu.org>)
 id 1iagDt-0003i9-PI; Fri, 29 Nov 2019 08:22:14 -0500
In-reply-to: <CADwFkm=PmEhfd=HyUJCyYAuGXYPAwN-9bYsk74eNQkRbWAVYhQ@mail.gmail.com>
 (message from Stefan Kangas on Fri, 29 Nov 2019 12:37:31 +0100)
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." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Original-Sender: "Emacs-devel" <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Xref: news.gmane.org gmane.emacs.devel:242873
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/242873>

> From: Stefan Kangas <stefan@marxist.se>
> Date: Fri, 29 Nov 2019 12:37:31 +0100
> Cc: emacs-devel <emacs-devel@gnu.org>
> 
> Anonymous <c4droid@foxmail.com> writes:
> 
> > First, suggest to add more examples of functions in the tutorial,
> > most for Emacs Lisp Reference Manual, which can lower the learning
> > threshold.
> 
> I think this is a fine idea that would make the manual more useful.
> But the elisp manual is also printed on paper, and is from what I
> understand already very long.  Does it make sense to include examples
> in the info manual only?

I think if we want to have an ELisp tutorial, it should be a separate
manual.  The current ELisp manual is a reference manual, and written
as such.