From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: David Masterson Newsgroups: gmane.emacs.devel Subject: Re: use-package documentation Date: Thu, 05 Jan 2023 22:03:57 -0800 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19556"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Cc: emacs-devel@gnu.org To: Richard Stallman Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Jan 06 07:28:33 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 1pDgDP-0004tf-R6 for ged-emacs-devel@m.gmane-mx.org; Fri, 06 Jan 2023 07:28:32 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pDgCm-0007IL-R7; Fri, 06 Jan 2023 01:27:52 -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 1pDfpn-0001jX-0g for emacs-devel@gnu.org; Fri, 06 Jan 2023 01:04:07 -0500 Original-Received: from mail-mw2nam10olkn2013.outbound.protection.outlook.com ([40.92.42.13] helo=NAM10-MW2-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pDfpk-0000Yk-Da; Fri, 06 Jan 2023 01:04:06 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GiA5LgcFSMi9Df+favH8nh389MXweM9BDvOcf+em/TGC9xqK5csQKk8jKd2pgQh0LCv4xsp1W45jcTSEhNyF+0OCpfRGQGZqUJtm3Dk2UtduQiOKTmNdddTU7w1asKyvqR86e4EcB5ndn04v4yWmWVvQTTiewiOMWWc2q2QofLGjQBoek0gMLfFeziq76JIVtD0/HueF2oEHEvHnpzBnEJbj70x/s4grvQ+/b6aU5ByowhWu5H5X6wJXUFuU7H9DDeCypEAjOkB8gUSmzuIYaQkt6oTWanrykWDK0ehQ+bqtnmyj0kVCcW56HzfulSNgRZRy9rCJMVqRv8kCf2YQPA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=NIFOhv8UFnzNsVT9iv0sxiRrtrro1LuMrKHAFILILjE=; b=PddtwyXi1xwRUZe/Ij54lkOzc9tyg2eCihKu/3zQD3kw7rrMx9ai5BzRjUueLIZbWQdtSHcxjuGbzzRV89Hi77t+RxFqikompJsydlKCTwlYv9qnIaL6hA0AV9RLgnXeSFCgseHWmGOh95BheNPQxibJ4zlKAzdP3eHsJXnAWbMaPWOBZGjGdw8hPzmQBlmp44y7xzHJGJcxXNFw0Q16YhvJjxZkyAe3yMxYZ39f3k1+jYbQ59DSBvYnBTDWrLB37iS8jaMhoZZacitBco4Cdhq3o6bUqxyMjCA9yoldRtEJCVtyZjM33p8dg14kJX3AG5zEb4tHhqeL1rijWx/Xug== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NIFOhv8UFnzNsVT9iv0sxiRrtrro1LuMrKHAFILILjE=; b=fTRt8zXBBNh4rGh0RpvXhX6OFgE+5XEzMi+vIbnT1Tk5Ss58UbJ3JlJxaPx0wVkJGP3rzV+7nee0emOjzDy4fZwkVViPqs5nQ+gu4XTeM14Kvxf17q6V10yTsnGnilTm2WGVNOifJZW29iqHoqoWAvtWqoldh7M2XO6BmC2YFk12or9yS/K8ttH9Cmuhd6b5N1rKYK4kTt6UXgmjUIyC8m3eetHLbFddp4W+iz2ZFsf7iwxfUN/YGVQ+NIkYJCG0dop0VvafJTORmMr4fuypcFbDoLfJ67FNc1qTLcPt9g718uNEHBgIYoFvgqafGZCsv86Zf47oEX2ixLN2YE1YLQ== Original-Received: from SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) by SJ0PR03MB5694.namprd03.prod.outlook.com (2603:10b6:a03:2da::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5944.19; Fri, 6 Jan 2023 06:04:00 +0000 Original-Received: from SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::e016:84f7:daad:916e]) by SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::e016:84f7:daad:916e%4]) with mapi id 15.20.5944.019; Fri, 6 Jan 2023 06:03:59 +0000 In-Reply-To: (Richard Stallman's message of "Thu, 29 Dec 2022 23:03:43 -0500") X-TMN: [RT9dyEDUNuC7VV7MZAm1QT+PryhYSjjfUglxbT/4qXSRnUswDwzM/wFvM+8DnLby] X-ClientProxiedBy: SJ0PR13CA0045.namprd13.prod.outlook.com (2603:10b6:a03:2c2::20) To SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) X-Microsoft-Original-Message-ID: <87y1qgmc6q.fsf@penguin> X-MS-Exchange-MessageSentRepresentingType: 2 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR03MB5455:EE_|SJ0PR03MB5694:EE_ X-MS-Office365-Filtering-Correlation-Id: b31ac329-24e6-4e7a-2647-08daefabcdb9 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: QJ4tcy5zogildmeC4D8UTSaQDE4QB3X5nexxAaeF4rxEPEGNO2kZ65ChnWmB/FmBhyEEHAE1ljTN4Xn4cqTPJ7hb4AYV/H8VqCRP1JSIg4ko02jq4uBBeP6jnT3Pr5QpTYCnPljg7C4jtmzSH4oyrPOg9qmZ6RneH/aPVXABdTTJtohsuSgeHdrD5oZIwf+zEbtnt7yYP2NXqLcjHDO4wNCoovv/uWbbW5VuSwHn44D7ij9+aigY4iWYgwrpNV3HcMYVrooZWZVartV+YTRrIb9o0GpXokdsmjR0t9KJa7zB375lgv4JrPvzMzr44eJRQXeAkua/sNBvr3NKnnFRoZF/AmHWd30V0CaP8S1GIXQCnGvcljxgIXXs1JcU9g4TxUjcqBqIE9rtUZjA1p/VLOY+mz92dGZ4yWungsufFzpR8VJd+rZ9a19CaSX6QwByeGWMHGp9v5AEbfOZ2y252Jz2wysPgPoG7PN54M8oAYOoStTL5eyJwz/wPNXacRmSmQAMLpJxuVEa1uf9qP5OQ44aWg2Ul90YLTjGkvs6vTCSUJ5yCo/n0h0Gh57GXjLlzF292aCmHypqe5V89vTB1oQIzjEVFnsxIfiyOXH/cKLjaJ3DKUaqhrKbcMLR3vQJ3eqCe+63bPZfG4sRaokd3Pgjp/fzgQ80dNXiTwOC+No= X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?a7D02dMQOjEUDWbBE+CcejektY2SkUpQ/41yjI3PelOXs+oVamuqLng0kLLX?= =?us-ascii?Q?GrfqOC97iOAaO8JYVy4SI22P3EH3R9qIwneZo+Wox++lPOWR3djc00RY66Vq?= =?us-ascii?Q?cJgJArt6TzhSs1Qf8ZbPBWbpTkxbRwpwdVj4NOUNvoKzG20QPzoUcxWc2beb?= =?us-ascii?Q?h12SjRi/SClUvssF/pGdlQj3naIPyb0lIRLn/g8Ef30M3F3PKkAsrJudtdrt?= =?us-ascii?Q?gB6V1q4adLCvbEfddL8J2+IVbDN81fPSGiZkDGQAoL1JJAByj7cYT71yG5Kv?= =?us-ascii?Q?qs/tHjZjuO9ullh6ZDps8etTWEozwU9psiTQAoo1sxJ2xaKT6IAtkoVTpQEo?= =?us-ascii?Q?4wxFcz4+heE+Kt/0tIesYyKQsaQUXY6jDMVSR+AkP925f5DHf01WK92ge3oR?= =?us-ascii?Q?x5/9NB0kO0KlA7l6PXtiRvhA8eBdncuNuHG32lSKvw/XsBHBd98VAbP9zZtl?= =?us-ascii?Q?rMF59AmbQylr899RiLCYWDGZBZvOf5Zc0p6uB1bxaA6Qg9nPnyOGcuMtX7KU?= =?us-ascii?Q?ttKSjiZidOYIGQuGle2+3OnSfq7JwmMcCZnBmx9JG+HTjNDi6m6d/K8rlvBL?= =?us-ascii?Q?z/ryYJXRCDI4CLs4ZU87gja6XjoqxNqRjW0H/3HQ8hgzEH+4yVfP8VW12UGy?= =?us-ascii?Q?+u X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: b31ac329-24e6-4e7a-2647-08daefabcdb9 X-MS-Exchange-CrossTenant-AuthSource: SJ0PR03MB5455.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Jan 2023 06:03:59.8924 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR03MB5694 Received-SPF: pass client-ip=40.92.42.13; envelope-from=outlook_98C99531806B1C22@outlook.com; helo=NAM10-MW2-obe.outbound.protection.outlook.com X-Spam_score_int: 6 X-Spam_score: 0.6 X-Spam_bar: / X-Spam_report: (0.6 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FORGED_GMAIL_RCVD=1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, NML_ADSP_CUSTOM_MED=0.9, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Fri, 06 Jan 2023 01:27:51 -0500 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:302246 Archived-At: Richard Stallman writes: > [[[ 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. ]]] > > Should the documentation of use-package be merged into the Emacs Lisp > Reference Manual? Question: is it too early to "integrate" use-package documentation in standard Emacs documents when there are other variants of use-package (quelpa, straight, etc.) out there that may enhance or replace it? Personally, I could see use-package (or variant) be the standard tool for providing a standard structure to an init file and, so, talking about that structure and how use-package helps facilitate it would belong in the "Customization" section of the Emacs manual. This would be for new users graduating from push button setup (M-x customize) into the next level of "programming" Emacs to fit the environment they want. References could point to the Elisp manual to go beyond the basics of "initialization" (setq, setup functions, etc.) to full programming for really special customization. -- David Masterson