From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Albinus Newsgroups: gmane.emacs.devel Subject: Re: Improving documentation of Org Mode integration into Emacs. Date: Wed, 05 Jan 2022 15:17:30 +0100 Message-ID: <87r19m5ksl.fsf@gmx.de> References: <87zgpgax7w.fsf@red-bean.com> <834k7n5zfu.fsf@gnu.org> <87fsq5tnni.fsf@red-bean.com> <87ee5mlvyc.fsf@red-bean.com> <83lezu9tv1.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="17307"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: Karl Fogel , emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Jan 05 15:50:58 2022 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 1n57cu-0004L0-Ra for ged-emacs-devel@m.gmane-mx.org; Wed, 05 Jan 2022 15:50:56 +0100 Original-Received: from localhost ([::1]:53642 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n57ct-0002zg-RC for ged-emacs-devel@m.gmane-mx.org; Wed, 05 Jan 2022 09:50:55 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:56562) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n576k-0004HH-6j for emacs-devel@gnu.org; Wed, 05 Jan 2022 09:17:42 -0500 Original-Received: from mout.gmx.net ([212.227.17.21]:49141) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n576i-0008Qf-3q; Wed, 05 Jan 2022 09:17:41 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1641392253; bh=GsjRft0rTRJeFx6/2QtCJhj9WUh7jpEawDi9Gbp3vzk=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=QjwygCAlQ68DfQBJRM80K2cpaMpY8hZ2ktpXNyrT8vBL4me1pvC7VOBNwYyMiJI0S aOBlM/RzhsGyaCvdSeq2WJxk3/mh9NxyhliRsWJwyX8g1aeaPavGlkalyegvNpBXkT X/ogszFH2mGfmw8BHXi6Un9arB/PPksgf5qBj+oQ= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from gandalf.gmx.de ([79.140.124.237]) by mail.gmx.net (mrgmx104 [212.227.17.168]) with ESMTPSA (Nemesis) id 1M89L1-1n10dL324h-005Ins; Wed, 05 Jan 2022 15:17:32 +0100 In-Reply-To: <83lezu9tv1.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 05 Jan 2022 15:48:02 +0200") X-Provags-ID: V03:K1:9qmNRIxiH4WTGnRhwVf8Mbs97n42aU6nPL3b9JwUtmO6XkJFiIE WOMFXyQ7mb/rGmlKR6MhAnIPdxD8fVIuFLdtPsnazRNCZr3xRRMA4q8DEy+XAW5M2lQVJGM eDZlRgXIL6qWcdUiIUx/OCp+IShwzEkJ1R2v77z3/qnDmQneVpvIC1pVnMbSv1Z0EBBVIcR KmHasAIy/zl0xacEgYk8A== X-UI-Out-Filterresults: notjunk:1;V03:K0:BzuF5fgf0YE=:K2NvlKcFfEzaRrL3TBC9gQ n/8x4KkitGEDZmNIGPGf5cZ1Q5s5jf1+5HiEyGqBS+dkpWrQLxHRTTWLjFfqCdwTwJ60lWbd7 FrpiI1nXrp20TilXOoh6axMnofeoVElynQBCroqIpGAjdzZkcwtHy3kmSGFgaLo8Z30z/Orfo iTNOCcJF3vgQGcdPPDmYBHnxfWd/wGvSLt+toFoRLESlsQu7C3H2NSv5YTYneIBJ5KmLw/BeK 6KFB8io2sbWN4+5o3SP8kpZMD7WtR6QvCaU4VCh6P7GE+ZmhTRV8brHzmh4jVP7cYMRVVsQn8 fCyB8bu49n0owehL8hL51dpP2o87Tz7px1Y9DyrszBu0+XSvcL0n8fMKJVbZ03fBj36meuQOz pZOew/ForsqiokajpbX4KOi19YcQFOd0uto1CQiaaCMAiuGvUArm4A8a9GOxXQHh1X089sOoi R/GDeiwRcyeGHICme6N7NW1zNCe1zK2d1JTLHGcVTfm/uUNLWwXjPh6RHr9ooZuk26DOcE+j6 xSIEzfosiCLhIxY4RTF0+0j5ym6+q9mblj8rY4rOx7hhXPGkTS7cYt2c0BPTiP3OgKt6Tkpoi ZDLRhcVX+gjTJwOsk6jCMsUEnz6ChdhfmD/CUV1y2cuvKNYlu/yt4oCiFGyk7fYWyZKSUOqFj LoUBPQKntrbG706+a0xnRKHAzmdD7s6qE1BaJnnuJlYK/fhznVLiCFAnA07YOg2IcX8OTIU16 5yRWoIvijxMucgB7bt2pkQWLm8OopEkuCu7v2EyHERsG8O9LZPdNJX1f2SYMFhgYe30rEE6H Received-SPF: pass client-ip=212.227.17.21; envelope-from=michael.albinus@gmx.de; helo=mout.gmx.net X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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:284241 Archived-At: Eli Zaretskii writes: Hi Eli, > I think we should explain the issue concisely, and then provide > specific instructions. This text is IMO enough for the first part: > > +Sometimes a package that ships as part of GNU Emacs is maintained as a > +separate project, with its own upstream repository, its own maintainer > +group, its own development conventions, etc. The upstream project's > +code is periodically merged into Emacs (exactly when and how such > +merges happen depends on the package). > + > +So when you are making a contribution -- such as fixing a bug or > +proposing an enhancement -- to one of these externally maintained > +packages, you often need to deal with that package at its upstream > +source. > > Following that, we should provide a full, exhaustive list of all such > packages in Emacs core, each one with a corresponding URL (mailing > list, upstream repository with an issue tracker, etc.). It might be a > good idea to have this list on a separate file, perhaps in etc/, and > only have CONTRIBUTE point to that file. We have already admin/MAINTAINERS, which could easily be extended for this. I, for example, am mentioned there as responsible for Tramp. Adding the Tramp relevant URLs would be easy, and so for all other external maintained packages. > Thanks. Best regards, Michael.