From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] Package Installation in Tutorial Date: Sat, 04 Dec 2021 18:29:55 +0200 Message-ID: <83lf105o58.fsf@gnu.org> References: <864k7ro07p.fsf@mail.linkov.net> <87pmqdvd1h.fsf@gnus.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="38309"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Daniel Fleischer Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Dec 04 17:31:34 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 1mtXwk-0009pa-6G for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Dec 2021 17:31:34 +0100 Original-Received: from localhost ([::1]:40594 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtXwi-0003Yf-Sl for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Dec 2021 11:31:32 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:36190) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtXvH-0002lF-K5 for emacs-devel@gnu.org; Sat, 04 Dec 2021 11:30:03 -0500 Original-Received: from [2001:470:142:3::e] (port=38404 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtXvH-0002Zh-Bc; Sat, 04 Dec 2021 11:30:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=cDMnX9n6pMaUEgbyavXeWGTYHrYR4rpjIfN1HF6i4VI=; b=ok/gaCrIfR+C l8Gs8ztuJOpg1L+epRrAL243wpVs5Kg+qs4h6JekBRCiug4ihypxNAVcOq/DHtHUJdaCePXEGLjh4 o62nwnEmLDDeKEIOdoplIHlRYlmPREjc9/dCr84nNPKTWCIDIxC0OgsyEAxou5QiR5m7M5mnnwn1m aeyUU9KSsMbH8Ww+1LRwOM5UroJY/88zox79G4FEiHVlEfg+REbkMXVCPlnFcGzmy4YgrF5kc1aZY VVXWRblMlBIQ5j99Mbd7GRfGvRW09cLY4qMGanYTvCDpBItBdLHLItTB/+kW6UZR63gTy63nVfH0W j8gyvs3j8FyI+a+i7UhW3A==; Original-Received: from [87.69.77.57] (port=3954 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtXvH-0004Bt-3u; Sat, 04 Dec 2021 11:30:03 -0500 In-Reply-To: (message from Daniel Fleischer on Sat, 04 Dec 2021 16:15:14 +0200) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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:280925 Archived-At: > From: Daniel Fleischer > Date: Sat, 04 Dec 2021 16:15:14 +0200 > > I want to keep the simple example of installing and deleting a single > package because it's empowering and thanks to completion, this could be > enough for someone to learn how to install, say, clojure-mode. > > I have added the `list-packages' command as a reference, to get more > information about packages. Thanks, but I feel this is too much for a tutorial. Just mentioning list-packages, and having a reference to the manual that describes the rest, should be enough. The tutorial is about the basics, the terminology, and little else. For all the other important topics, it should just help discovering them, not provide detailed instructions. Otherwise it will become unbearably large. In this case, the section "Package Installation" in the Emacs manual presents a much better description of what's involved, and a terse summary in the tutorial can never match it. Package installation is a delicate matter, since it involves installing software that didn't come with the distribution, so omitting details is not a good idea here.