From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Krystian Samp Newsgroups: gmane.emacs.bugs Subject: bug#72961: Possible documentation improvement: Clarification for package installation Date: Thu, 5 Sep 2024 09:44:14 +0200 Message-ID: References: <86r0a28dpd.fsf@gnu.org> <87ikvdgabf.fsf@posteo.net> <86o7524nx4.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="000000000000aebc2806215a7513" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="12758"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 72961@debbugs.gnu.org, philipk@posteo.net To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Sep 05 10:25:06 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1sm7nd-00038i-RZ for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 05 Sep 2024 10:25:06 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sm7nW-0003TR-N1; Thu, 05 Sep 2024 04:24:58 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sm7nV-0003Pb-QY for bug-gnu-emacs@gnu.org; Thu, 05 Sep 2024 04:24:57 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sm7nV-00037x-I2 for bug-gnu-emacs@gnu.org; Thu, 05 Sep 2024 04:24:57 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=Date:From:In-Reply-To:References:MIME-Version:To:Subject; bh=W6DvoI4ARm4WVb9lhzk3FOk+AwN8f5aFSgfEQsAQZRg=; b=tYiaz1Jr6vBCdBIiMNjhZxx09jQGXwhJ/kBBalshws9noi4uGOAInjiCTebjF0nUosBD+lcGWTgnNk0bwa/0CLWbvAZfnh8+QyNAjBLM3U/0sJ899FvV76CGYhW/ykX3B/axL9EUW5c4oBdMqxZAnscQjmFIviYSIzMRZ87yGFVEb4D545VRCDt5EPxfdG9GMnCPJgUzyh/MYOG42SnyAniV+4rQf8mr1klL6zsbC7Jl5XsKu1iGgIlL9HYVgH6rquc1tySF4LBiOI0l6mX5crjhFWzrWZSjX745PE1ZI2XJ18q8dJCLmmUnnje0WH6qE82A+q1ZJLx0gSLGjFXy1Q==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sm7oX-0002zb-U2 for bug-gnu-emacs@gnu.org; Thu, 05 Sep 2024 04:26:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Krystian Samp Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 05 Sep 2024 08:26:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72961 X-GNU-PR-Package: emacs Original-Received: via spool by 72961-submit@debbugs.gnu.org id=B72961.172552472011363 (code B ref 72961); Thu, 05 Sep 2024 08:26:01 +0000 Original-Received: (at 72961) by debbugs.gnu.org; 5 Sep 2024 08:25:20 +0000 Original-Received: from localhost ([127.0.0.1]:36086 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sm7nr-0002xA-7D for submit@debbugs.gnu.org; Thu, 05 Sep 2024 04:25:20 -0400 Original-Received: from mail-pf1-f181.google.com ([209.85.210.181]:52707) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sm7CO-0008WT-I1 for 72961@debbugs.gnu.org; Thu, 05 Sep 2024 03:46:37 -0400 Original-Received: by mail-pf1-f181.google.com with SMTP id d2e1a72fcca58-7143ae1b48fso300639b3a.1 for <72961@debbugs.gnu.org>; Thu, 05 Sep 2024 00:45:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725522266; x=1726127066; darn=debbugs.gnu.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=W6DvoI4ARm4WVb9lhzk3FOk+AwN8f5aFSgfEQsAQZRg=; b=E9heCE5wFk5f+pFt282hncJqLGvMG05XMp1LwbX05wH+sRP9tfY455DYs7elVUb9vA 9ib3hRTA/dvJMRyEWDZ085qtB2wZzG1tivsm9ogloNSFVSKZtspNsTGYFbGeJ+VgnOpC GzD4Aoqt7uxEnyJKVNN1q8T78OIlhd6DHxzuXd9lxCzheyehccsCX7ZVdxC9+vvt2xvk QTzEec0JaSth9UTR00SQ9vBzIVT/e+YVPfGsRUC6BjDvO0fNUj5lfRXT0eFU/7LzgZQQ YcSe5V+XGDcsHbmlVp6owgUSOwXFkM+tz3IWKbst1gC8nYEixGsS6zFcrNqnk+mKS9uJ Gqfw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725522266; x=1726127066; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=W6DvoI4ARm4WVb9lhzk3FOk+AwN8f5aFSgfEQsAQZRg=; b=SSoRGUYZVTPoBCVM5tj8WuF/fQSufUhWQydKDOr+cWPQQA1BTw9x4bCkBrUrxC/Nf6 IRWhVc8mkH6xU62ZK4GgSaw40vG+4mA15NgeGGaFwdrAWA6d/5bqrQEFyZy0oB/NqE0F 01BzA3TUEOIGFIVogsfECDlifdMi9ad9hVH0fytdz2gh8Iad6qfCRLuiZusj1tllWaaL hXcdOBejH2L+JNIRrVrgk0WjE9s/D49bUYPbb10E6twkEj5TNbmZUaLFp0One3+7HTA6 FDrY4gmoW5bI7rNHdPRDrv9Loi06XQlPtD5Ig1cmsM3tJDCJ5RwLxxN15D47gLZUVWcn xBAg== X-Forwarded-Encrypted: i=1; AJvYcCWP27k7zfC8pgX1o4jJj5HZNQKiTtu8tkztNhv6H9543JY0BDOpd66+pzu7JhqeQwbg6ex0Cg==@debbugs.gnu.org X-Gm-Message-State: AOJu0Yx6k0m8d5hXfbFW7MSkWyxs3NlpsB7RpFf/cGavSmPJqlO5cCVY nbjGQJEETI+QBTEltcY7WTmuoUnoiKAT21y3q4jxEUn7Bt8hQf+cFui8RcYs3P7ok3GbszcZFWe HjNXtlDFZMcQP/Sho3o+DyZchqRw= X-Google-Smtp-Source: AGHT+IG/PyL1XzbIeIs0BpMTUOtVtsTN4R8E4ON7WpVKyPOH+lu3VAD8kFsVvnQgQUQROf419lCILRX90oalEuoS+o8= X-Received: by 2002:a05:6a21:6b0c:b0:1c3:b1e2:f826 with SMTP id adf61e73a8af0-1cece5d1548mr16808553637.35.1725522265420; Thu, 05 Sep 2024 00:44:25 -0700 (PDT) In-Reply-To: <86o7524nx4.fsf@gnu.org> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:291232 Archived-At: --000000000000aebc2806215a7513 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Thanks, imho it'd be also useful to add there that Emacs will make the installed packages available automatically at startup. Now it reads that Emacs will add them to `load-path` but I wouldn't infer from this that Emacs will also make these packages available. And right after that we say that "... making the above manual customizations unnecessary for such packages" which specifically refers to loading, not only adding to `load-path`. Just two cents, K On Thu, 5 Sept 2024 at 08:25, Eli Zaretskii wrote: > > From: Krystian Samp > > Date: Wed, 4 Sep 2024 23:52:15 +0200 > > Cc: Eli Zaretskii , 72961@debbugs.gnu.org > > > > I'd propose to make a simple change in 28.8 that is consistent with 49.= 3: > > > > Original: > > "Note that installing a package using package-install (see Package > Installation) takes care of placing the > > package's Lisp files in a directory where Emacs will find it, and also > writes the necessary initialization code into > > your init files, making the above manual customizations unnecessary" > > > > Proposed: > > > > =E2=80=9CNote that installing a package using package-install (see Pack= age > Installation) takes care of placing the > > package=E2=80=99s Lisp files in a directory where Emacs will find it. I= nstalled > packages are automatically made available > > by Emacs in all subsequent sessions, making the above manual > customizations unnecessary.=E2=80=9D > > Thanks, I modified the text slightly differently. > --000000000000aebc2806215a7513 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Thanks,

imho it'd be also useful to= add there that Emacs will make the installed packages available automatica= lly at startup. Now it reads that Emacs will add them to `load-path` but I = wouldn't infer from this that Emacs will also make these packages avail= able. And right after that we say that "...=C2=A0making the above manual cu= stomizations unnecessary for such packages" which specifically refers = to loading, not only adding to `load-path`. Just two cents,
K

= On Thu, 5 Sept 2024 at 08:25, Eli Zaretskii <eliz@gnu.org> wrote:
> From: Krystian Samp <samp.krystian@gmail.com>
> Date: Wed, 4 Sep 2024 23:52:15 +0200
> Cc: Eli Zaretskii <eliz@gnu.org>, 72961@debbugs.gnu.org
>
> I'd propose to make a simple change in 28.8 that is consistent wit= h 49.3:
>
> Original:
> "Note that installing a package using package-install (see Packag= e Installation) takes care of placing the
> package's Lisp files in a directory where Emacs will find it, and = also writes the necessary initialization code into
> your init files, making the above manual customizations unnecessary&qu= ot;
>
> Proposed:
>
> =E2=80=9CNote that installing a package using package-install (see Pac= kage Installation) takes care of placing the
> package=E2=80=99s Lisp files in a directory where Emacs will find it. = Installed packages are automatically made available
> by Emacs in all subsequent sessions, making the above manual customiza= tions unnecessary.=E2=80=9D

Thanks, I modified the text slightly differently.
--000000000000aebc2806215a7513--