From 99f47ede413ea8c04ad1f1ca8f1a678f7942578c Mon Sep 17 00:00:00 2001 From: Karl Fogel Date: Mon, 10 Jan 2022 13:20:29 -0600 Subject: [PATCH] Document external maintenance of some packages Document the fact that some packages in Emacs are externally maintained, and specifically document Org Mode's external maintenance. For more context, see the thread that starts here: https://lists.gnu.org/archive/html/emacs-devel/2021-12/msg00366.html From: Karl Fogel To: Emacs Devel Subject: Improving documentation of Org Mode integration into Emacs. Date: Sat, 04 Dec 2021 15:14:59 -0600 Message-ID: <87zgpgax7w.fsf@red-bean.com> --- CONTRIBUTE | 16 ++++++++++++++++ admin/MAINTAINERS | 17 +++++++++++++++++ 2 files changed, 33 insertions(+) diff --git a/CONTRIBUTE b/CONTRIBUTE index 7c3421ed75a..614afa27db7 100644 --- a/CONTRIBUTE +++ b/CONTRIBUTE @@ -366,6 +366,22 @@ reasons. These should be marked by including something like "Do not merge to master" or anything that matches gitmerge-skip-regexp (see admin/gitmerge.el) in the commit message. +** Some packages in Emacs are maintained externally + +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 sometimes need to deal with that package at its upstream +source. + +In the section "Externally maintained packages" in "admin/MAINTAINERS" +we maintain a list of such packages. + ** GNU ELPA This repository does not contain the Emacs Lisp package archive diff --git a/admin/MAINTAINERS b/admin/MAINTAINERS index c26206baf64..092978f6d2c 100644 --- a/admin/MAINTAINERS +++ b/admin/MAINTAINERS @@ -318,6 +318,23 @@ Modus themes doc/misc/modus-themes.org etc/themes/modus*.el +Org Mode + Home Page: https://orgmode.org/ + Maintainer: Org Mode developers + Repository: git://git.sv.gnu.org/emacs/org-mode.git + Mailing list: emacs-orgmode@gnu.org + Bug Reports: M-x org-submit-bug-report + Notes: Org Mode is maintained as a separate project that is + periodically merged into Emacs. To view or participate in + Org Mode development, please go to https://orgmode.org/ and + follow the instructions there. + + lisp/org/*.el + etc/org/* + etc/refcards/orgcard.tex + doc/misc/org.org + doc/misc/org-setup.org + ;;; Local Variables: ;;; coding: utf-8 -- 2.39.2