From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: Some ideas with Emacs Date: Sat, 30 Nov 2019 04:51:11 +0100 Message-ID: References: <837e3iq0ks.fsf@gnu.org> <834kympy6y.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="66178"; mail-complaints-to="usenet@blaine.gmane.org" Cc: Anonymous , Emacs developers To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Nov 30 04:51:34 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 1iatnC-000H5b-Ma for ged-emacs-devel@m.gmane.org; Sat, 30 Nov 2019 04:51:34 +0100 Original-Received: from localhost ([::1]:37086 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iatnB-0004TV-9f for ged-emacs-devel@m.gmane.org; Fri, 29 Nov 2019 22:51:33 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47287) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iatn5-0004TP-4l for emacs-devel@gnu.org; Fri, 29 Nov 2019 22:51:28 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iatn4-00040t-29 for emacs-devel@gnu.org; Fri, 29 Nov 2019 22:51:26 -0500 Original-Received: from mail-pg1-f177.google.com ([209.85.215.177]:33414) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iatn2-0003wa-8d; Fri, 29 Nov 2019 22:51:24 -0500 Original-Received: by mail-pg1-f177.google.com with SMTP id 6so10856916pgk.0; Fri, 29 Nov 2019 19:51:24 -0800 (PST) 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; bh=K1xHHkeFAeyCJmERXmRdJK46ngIyKX/Rg4BH+YLt0l4=; b=jMhtIrnIKAUBxffuXDCm0eGfW8x3WURGHrcx6eQ2NAwOEZwaYKxL0VCy/EXcBY1RMw Beh2q/LIdXuacgCebOl55v9bmltZVFkpmA/5KL6tlMVd8yfzKFhn1xC7+5OArktjMcXi wJas8W7UOKPkF6oAS0izqRSgi8b44F+55OiatnrikGsCZ022hL0WNJQvscXQMMDMqBtJ RB5uX7Zd0GXCckBtXiYaBorw/tWukSG9w1H1jS5MKcS6chQSJzJn63a4O0zNRHQJRhRL mtd9K7ML9TCdlVPwzUz7b9lVIcynQWrvwxbpveXrnKtVwvBJv9O+zDux/m7qIlxiQ6kZ l1cA== X-Gm-Message-State: APjAAAVmWIgr6YF3oJoFJH5wiRzRm8lcqFJpvr3dZNWh3ijwoqwJkHY5 vZ7NYUzOweFHaCJuOSeIhrWcJrtrKIwy6PQ+4wE0CQ== X-Google-Smtp-Source: APXvYqz4NrRfiJDnxoxku5wFtVogajdfTNJ6rRp+4gi3CvgqRZwIlbRjkwz12rdKwo2sbyBaahiWfMv145jte4JxAio= X-Received: by 2002:a63:5f45:: with SMTP id t66mr19489957pgb.198.1575085882849; Fri, 29 Nov 2019 19:51:22 -0800 (PST) In-Reply-To: <834kympy6y.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.85.215.177 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:242903 Archived-At: Eli Zaretskii writes: > > I fail to see why a reference manual can't also include examples. > > I was talking about a tutorial, not about examples. I misunderstood what you meant. Sorry about that. > We already have examples in the ELisp manual, although it isn't > feasible to have an example for each possible use case. We could add > more examples where the description is not self-explanatory enough, > but adding too much of them would be infeasible, I think, due to size > considerations. We will have to consider that on a case by case > basis. Agreed, and thank you for clarifying. That makes sense. Best regards, Stefan Kangas