diff options
| author | Stefan Monnier | 2026-01-07 10:55:11 -0500 |
|---|---|---|
| committer | Stefan Monnier | 2026-01-07 10:55:11 -0500 |
| commit | ba7c2debefdaf3faabd464694059438bbb510fa8 (patch) | |
| tree | 22c679f7b8654a4e5bfa522523ca8b73940a863b /admin | |
| parent | 68b6137eb028f692869a2722b5c9f297f9fd1c64 (diff) | |
| download | emacs-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/elpa | 35 | ||||
| -rw-r--r-- | admin/notes/elpa.md | 43 |
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 @@ | |||
| 1 | NOTES ON THE EMACS PACKAGE ARCHIVE | ||
| 2 | |||
| 3 | The GNU Emacs package archive, at elpa.gnu.org, is managed using a Git | ||
| 4 | repository 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 | |||
| 10 | That leaves the elpa/packages directory empty; you must check out the | ||
| 11 | ones you want. | ||
| 12 | |||
| 13 | If you wish to check out all the packages into the packages directory, | ||
| 14 | you can run the command: | ||
| 15 | |||
| 16 | make worktrees | ||
| 17 | |||
| 18 | You can check out a specific package <pkgname> into the packages | ||
| 19 | directory with: | ||
| 20 | |||
| 21 | make packages/<pkgname> | ||
| 22 | |||
| 23 | |||
| 24 | Changes to this repository propagate to elpa.gnu.org via a | ||
| 25 | "deployment" script run daily. This script generates the content | ||
| 26 | visible at https://elpa.gnu.org/packages. | ||
| 27 | |||
| 28 | A new package is released as soon as the "version number" of that | ||
| 29 | package is changed. So you can use 'elpa' to work on a package | ||
| 30 | without fear of releasing those changes prematurely. And once the | ||
| 31 | code is ready, just bump the version number to make a new release of | ||
| 32 | the package. | ||
| 33 | |||
| 34 | It is easy to use the elpa branch to deploy a "local" copy of the | ||
| 35 | package 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 | |||
| 3 | The Emacs package archives at `elpa.gnu.org` (GNU ELPA and NonGNU ELPA) | ||
| 4 | are managed using two Git repositories named `gnu.git` and `nongnu.git` | ||
| 5 | hosted in the `elpa` group on Savannah. | ||
| 6 | To check them out: | ||
| 7 | |||
| 8 | git clone https://git.savannah.gnu.org/git/elpa/gnu.git | ||
| 9 | cd gnu | ||
| 10 | make setup | ||
| 11 | |||
| 12 | resp. | ||
| 13 | |||
| 14 | git clone https://git.savannah.gnu.org/git/elpa/nongnu.git | ||
| 15 | cd nongnu | ||
| 16 | make setup | ||
| 17 | |||
| 18 | That leaves the `(non)gnu/packages` directory empty; you must check out the | ||
| 19 | ones you want. | ||
| 20 | |||
| 21 | If you wish to check out all the packages into the packages directory, | ||
| 22 | you can run the command: | ||
| 23 | |||
| 24 | make worktrees | ||
| 25 | |||
| 26 | You can check out a specific package <pkgname> into the packages | ||
| 27 | directory with: | ||
| 28 | |||
| 29 | make packages/<pkgname> | ||
| 30 | |||
| 31 | Changes to this repository propagate to `elpa.gnu.org` via a | ||
| 32 | "deployment" script run daily. This script generates the content | ||
| 33 | visible at https://elpa.gnu.org/packages and https://elpa.nongnu.org/nongnu | ||
| 34 | |||
| 35 | A new package is released as soon as the "version number" of that | ||
| 36 | package is changed (as found in the `;; Version:` header of the main | ||
| 37 | ELisp file of the package). So you can use `elpa/(non)gnu.git` to work | ||
| 38 | on a package without fear of releasing those changes prematurely. | ||
| 39 | And once the code is ready, just bump the version number to make a new | ||
| 40 | release of the package. | ||
| 41 | |||
| 42 | It is easy to use these repositories to deploy a "local" copy of the | ||
| 43 | package archive. For details, see the README file after cloning them. | ||