aboutsummaryrefslogtreecommitdiffstats
path: root/admin
diff options
context:
space:
mode:
authorStefan Monnier2026-01-07 10:55:11 -0500
committerStefan Monnier2026-01-07 10:55:11 -0500
commitba7c2debefdaf3faabd464694059438bbb510fa8 (patch)
tree22c679f7b8654a4e5bfa522523ca8b73940a863b /admin
parent68b6137eb028f692869a2722b5c9f297f9fd1c64 (diff)
downloademacs-ba7c2debefdaf3faabd464694059438bbb510fa8.tar.gz
emacs-ba7c2debefdaf3faabd464694059438bbb510fa8.zip
* admin/notes/elpa.md: Update to match current reality
* admin/notes/elpa: Rename to `elpa.md`. * admin/notes/elpa.md: Rename from `elpa`, adjust to recently changed repository location, mention the "new" NonGNU repository.
Diffstat (limited to 'admin')
-rw-r--r--admin/notes/elpa35
-rw-r--r--admin/notes/elpa.md43
2 files changed, 43 insertions, 35 deletions
diff --git a/admin/notes/elpa b/admin/notes/elpa
deleted file mode 100644
index afcda71d1dd..00000000000
--- a/admin/notes/elpa
+++ /dev/null
@@ -1,35 +0,0 @@
1NOTES ON THE EMACS PACKAGE ARCHIVE
2
3The GNU Emacs package archive, at elpa.gnu.org, is managed using a Git
4repository named "elpa", hosted on Savannah. To check it out:
5
6 git clone https://git.savannah.gnu.org/git/emacs/elpa
7 cd elpa
8 make setup
9
10That leaves the elpa/packages directory empty; you must check out the
11ones you want.
12
13If you wish to check out all the packages into the packages directory,
14you can run the command:
15
16 make worktrees
17
18You can check out a specific package <pkgname> into the packages
19directory with:
20
21 make packages/<pkgname>
22
23
24Changes to this repository propagate to elpa.gnu.org via a
25"deployment" script run daily. This script generates the content
26visible at https://elpa.gnu.org/packages.
27
28A new package is released as soon as the "version number" of that
29package is changed. So you can use 'elpa' to work on a package
30without fear of releasing those changes prematurely. And once the
31code is ready, just bump the version number to make a new release of
32the package.
33
34It is easy to use the elpa branch to deploy a "local" copy of the
35package archive. For details, see the README file in the elpa branch.
diff --git a/admin/notes/elpa.md b/admin/notes/elpa.md
new file mode 100644
index 00000000000..791f0dec677
--- /dev/null
+++ b/admin/notes/elpa.md
@@ -0,0 +1,43 @@
1# NOTES ON THE EMACS PACKAGE ARCHIVE
2
3The Emacs package archives at `elpa.gnu.org` (GNU ELPA and NonGNU ELPA)
4are managed using two Git repositories named `gnu.git` and `nongnu.git`
5hosted in the `elpa` group on Savannah.
6To check them out:
7
8 git clone https://git.savannah.gnu.org/git/elpa/gnu.git
9 cd gnu
10 make setup
11
12resp.
13
14 git clone https://git.savannah.gnu.org/git/elpa/nongnu.git
15 cd nongnu
16 make setup
17
18That leaves the `(non)gnu/packages` directory empty; you must check out the
19ones you want.
20
21If you wish to check out all the packages into the packages directory,
22you can run the command:
23
24 make worktrees
25
26You can check out a specific package <pkgname> into the packages
27directory with:
28
29 make packages/<pkgname>
30
31Changes to this repository propagate to `elpa.gnu.org` via a
32"deployment" script run daily. This script generates the content
33visible at https://elpa.gnu.org/packages and https://elpa.nongnu.org/nongnu
34
35A new package is released as soon as the "version number" of that
36package is changed (as found in the `;; Version:` header of the main
37ELisp file of the package). So you can use `elpa/(non)gnu.git` to work
38on a package without fear of releasing those changes prematurely.
39And once the code is ready, just bump the version number to make a new
40release of the package.
41
42It is easy to use these repositories to deploy a "local" copy of the
43package archive. For details, see the README file after cloning them.