From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: use-package documentation
Date: Fri, 30 Dec 2022 11:01:04 +0200
Message-ID: <83bknl6zan.fsf@gnu.org>
References: <E1pB6cR-0001Fx-KB@fencepost.gnu.org>
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="25703"; mail-complaints-to="usenet@ciao.gmane.io"
Cc: emacs-devel@gnu.org
To: rms@gnu.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Dec 30 10:02:42 2022
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
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 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1pBBHl-0006XX-Bh
	for ged-emacs-devel@m.gmane-mx.org; Fri, 30 Dec 2022 10:02:41 +0100
Original-Received: from localhost ([::1] helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-devel-bounces@gnu.org>)
	id 1pBBGv-00051J-EI; Fri, 30 Dec 2022 04:01:51 -0500
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 <eliz@gnu.org>) id 1pBBGX-0004wx-75
 for emacs-devel@gnu.org; Fri, 30 Dec 2022 04:01:26 -0500
Original-Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@gnu.org>) id 1pBBGW-00010A-Nv
 for emacs-devel@gnu.org; Fri, 30 Dec 2022 04:01:24 -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=Dz4VsXS0wBEtKNbOk9n52J0CO9NO+n/YWAiA76wax8U=; b=AGfrfVO7Abl7
 Ds4+wYF2Im/O4rR8GFj6Emj89m/3rNi+77Vgy+Yko7P4l3+8KfwfmBH4LzxUv6GQUDFiJvJrgNkGv
 NLK9q2DypCpWtRNIodCJ7H55gdNcNn0J7xCXUKRirHLT/Ex4HhwSPDI2zKPmj5XdxzAYw85MfdlXn
 IKfIyqskXqRmZTWY0Lb2fLj6foSGCjVp5/JqrK16X2d3n+iAT42N5DMFG9vZqNqxRFFsrvxHyf4I3
 TUcBTI7b6sFxKnqp2KRe/pLgTX3YYRIRxfIWqSBxzVrMP+pzkVcsi0nMoxaNEzC6nBBWssGXxIumG
 41+zuC0Ti6guMNCVyTUZgg==;
Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7)
 by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@gnu.org>)
 id 1pBBGE-0003C4-Va; Fri, 30 Dec 2022 04:01:11 -0500
In-Reply-To: <E1pB6cR-0001Fx-KB@fencepost.gnu.org> (message from Richard
 Stallman on Thu, 29 Dec 2022 23:03:43 -0500)
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.29
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-mx.org@gnu.org
Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org
Xref: news.gmane.io gmane.emacs.devel:302086
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/302086>

> From: Richard Stallman <rms@gnu.org>
> Date: Thu, 29 Dec 2022 23:03:43 -0500
> 
> Should the documentation of use-package be merged into the Emacs Lisp
> Reference Manual?

It is a relatively large manual (2K lines of Texinfo), so adding it is
somewhat problematic.  It is also half-way between user-level and
Lisp-level, so which manual should mention it is not clear.

I think we should perhaps mention it in both manuals, and leave it as
a separate manual.