emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

master 99f47ede41: Document external maintenance of some packages


From: Karl Fogel
Subject: master 99f47ede41: Document external maintenance of some packages
Date: Mon, 10 Jan 2022 14:20:47 -0500 (EST)

branch: master
commit 99f47ede413ea8c04ad1f1ca8f1a678f7942578c
Author: Karl Fogel <kfogel@red-bean.com>
Commit: Karl Fogel <kfogel@red-bean.com>

    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 7c3421ed75..614afa27db 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 c26206baf6..092978f6d2 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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]