From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: use-package documentation Date: Sat, 31 Dec 2022 22:04:23 -0500 Message-ID: References: <83bknl6zan.fsf@gnu.org> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="28093"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jan 01 04:04:47 2023 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 1pBoeU-00075J-18 for ged-emacs-devel@m.gmane-mx.org; Sun, 01 Jan 2023 04:04:46 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pBoe9-00068M-D2; Sat, 31 Dec 2022 22:04:25 -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 ) id 1pBoe7-00063j-Ul for emacs-devel@gnu.org; Sat, 31 Dec 2022 22:04:23 -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 ) id 1pBoe7-0007yA-NB for emacs-devel@gnu.org; Sat, 31 Dec 2022 22:04:23 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=r6Ywi9xOPfd9qT/6BaRWK1MYnlpISubVpm6Ih74ATeU=; b=IYwmSqp+HDdB Cg/lmIr2g0Xbw/zMj1Ka6uPQXCnAyMMLxNu9TLFGn5NE4RokuNWBM68hX+e5c5ARAKPWsFTRZSQ4f 5zNxuxDERTC1RiFXCz2nD0PBjl5dU0IGB8t/lzhXzjR2J0AW2AGc0WFN8yYHXm2RGPb//M+eWxwfB 8Z1lwRtPL6tLDUxbqRNc21Qzy4MZblDFMjViX99iua1EaT2D/g5FV2152JzNjV6G9J4oaDwkngBqk 4gJVu0dm69ZaVLMscTezE3s/boJaLQ8sOCkHUnG5LC9l1m6rp82NuTRWqscSYgu2ZsZSZ2BzI7gby Z+jQcXVR4j5XEuc3ATj4vQ==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1pBoe7-0004rn-C9; Sat, 31 Dec 2022 22:04:23 -0500 In-Reply-To: <83bknl6zan.fsf@gnu.org> (message from Eli Zaretskii on Fri, 30 Dec 2022 11:01:04 +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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:302171 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > 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. People expect the Emacs Lisp Reference Manual to tell all about Emacs Lisp except for things that are somewhat obscure. People have said that use-package is much more convenient than `require' for the .emacs file. If that is so, we can expect it to become widely used if we make the community aware of it. This argues that at least the most important/most widely used features of `use-package' should be described in the Emacs Lisp Reference Manual. The rest of the could be left in a separate manual. Where in the Emacs Lisp Reference Manual should those aspects of `use-package' go? Perhaps in the node, The Init File. Or in a new node, added just after that one, to contain "useful things to use in your init file". -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)