From: Stephen Leake <stephen_leake@stephe-leake.org>
To: emacs-devel@gnu.org
Subject: ELPA notes, README
Date: Sun, 10 Jan 2021 15:05:18 -0800 [thread overview]
Message-ID: <86wnwks89d.fsf_-_@stephe-leake.org> (raw)
In-Reply-To: <867dphmt73.fsf@stephe-leake.org> (Stephen Leake's message of "Wed, 16 Dec 2020 11:44:48 -0800")
[-- Attachment #1: Type: text/plain, Size: 666 bytes --]
I'm starting to work on documenting how to bundle Gnu ELPA packages in
the Emacs distribution tarball.
As a first step, I checked out the current documentation, and I have
some suggested improvements even without the bundling option.
In Emacs admin/notes/elpa: see attached elpa_notes.diff. This reflects
recent changes to elpa.
In ELPA README: see attached elpa_readme.diff. This moves 'make
packages/<pkgname>' to the "getting the source" section, and documents
the need for 'make setup'.
Ok to commit?
Next step: I'll go thru the recent thread and compile the policy and
process info into emacs/admin/notes/elpa (without committing anything).
--
-- Stephe
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: notes_elpa.diff --]
[-- Type: text/x-patch, Size: 1827 bytes --]
diff --git a/admin/notes/elpa b/admin/notes/elpa
index ea6c132fe1..1e9e7a9f52 100644
--- a/admin/notes/elpa
+++ b/admin/notes/elpa
@@ -5,17 +5,31 @@ repository named "elpa", hosted on Savannah. To check it out:
git clone git://git.sv.gnu.org/emacs/elpa
cd elpa
- git remote set-url --push origin git+ssh://git.sv.gnu.org/srv/git/emacs/elpa
- [create task branch for edits, etc.]
+ make setup
-Changes to this branch propagate to elpa.gnu.org via a "deployment" script run
-daily. This script (which is kept in elpa/admin/update-archive.sh) generates
-the content visible at https://elpa.gnu.org/packages.
+That leaves the elpa/packages directory empty; you must check out the
+ones you want.
-A new package is released as soon as the "version number" of that package is
-changed. So you can use 'elpa' to work on a package without fear of releasing
-those changes prematurely. And once the code is ready, just bump the
-version number to make a new release of the package.
+If you wish to check out all the packages into the packages directory,
+you can run the command:
+
+ make worktrees
+
+You can check out a specific package <pkgname> into the packages
+directory with:
+
+ make packages/<pkgname>
+
+
+Changes to this repository propagate to elpa.gnu.org via a
+"deployment" script run daily. This script generates the content
+visible at https://elpa.gnu.org/packages.
+
+A new package is released as soon as the "version number" of that
+package is changed. So you can use 'elpa' to work on a package
+without fear of releasing those changes prematurely. And once the
+code is ready, just bump the version number to make a new release of
+the package.
It is easy to use the elpa branch to deploy a "local" copy of the
package archive. For details, see the README file in the elpa branch.
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #3: elpa_readme.diff --]
[-- Type: text/x-patch, Size: 1862 bytes --]
diff --git a/README b/README
index d6114a852c..9e77d6c1f3 100644
--- a/README
+++ b/README
@@ -23,6 +23,36 @@ for testing purposes).
Start with source that is cloned directly from Savannah. See [[https://savannah.gnu.org/git/?group=emacs][the Savannah page]]
and look for "ELPA". Using a clone of a clone does not work.
+You must then do some setup:
+#+begin_src shell
+ make setup
+#+end_src
+
+That leaves the =packages= directory empty; you must check out the
+ones you want.
+
+If you wish to check out all the packages into the =packages=
+directory, you can run the command:
+
+#+begin_src shell
+ make worktrees
+#+end_src
+
+You can check out a specific package =<pkgname>= into the =packages=
+directory with this command:
+
+#+begin_src
+ make packages/<pkgname>
+#+end_src
+
+If you already have a =packages/<pkgname>= directory with a previous
+checkout, you can update it like this:
+
+#+begin_src
+ cd packages/PACKAGE
+ git pull
+#+end_src
+
* Directory layout
** =admin/= -- scripts for administering the package archive.
@@ -221,28 +251,6 @@ and push that change to the master branch of =elpa=. After it's added to
the =elpa-packages= file, the package can be maintained just by
pushing changes to the =externals/<pkgname>= branch.
-If you wish to check out all the packages into the =packages=
-directory, you can run the command:
-
-#+begin_src shell
- make worktrees
-#+end_src
-
-You can check out a specific package =<pkgname>= into the =packages=
-directory with these commands:
-
-#+begin_src
- make packages/<pkgname>
-#+end_src
-
-If you already have a =packages/<pkgname>= directory with a previous
-checkout, you can update it like this:
-
-#+begin_src
- cd packages/PACKAGE
- git pull
-#+end_src
-
** Public incubation
If you want to develop a package publicly prior to its first release (to
next prev parent reply other threads:[~2021-01-10 23:05 UTC|newest]
Thread overview: 68+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-12-14 19:59 decision on moving core packages to ELPA; also move to obsolete? Stephen Leake
2020-12-14 20:07 ` Eli Zaretskii
2020-12-14 23:40 ` Stefan Monnier
2020-12-15 5:06 ` Eli Zaretskii
2020-12-15 9:32 ` Daniele Nicolodi
2020-12-15 16:57 ` Eli Zaretskii
2020-12-15 17:03 ` Stefan Monnier
2020-12-15 17:30 ` Glenn Morris
2020-12-15 17:43 ` Glenn Morris
2020-12-15 17:54 ` Glenn Morris
2020-12-15 19:50 ` Stefan Monnier
2020-12-15 18:28 ` Eli Zaretskii
2020-12-15 18:49 ` Stephen Leake
2020-12-15 18:53 ` Stephen Leake
2020-12-15 19:13 ` Eli Zaretskii
2020-12-15 19:54 ` Stefan Monnier
2020-12-15 20:11 ` Eli Zaretskii
2020-12-15 20:55 ` Dmitry Gutov
2020-12-16 15:33 ` Eli Zaretskii
2020-12-16 16:09 ` Dmitry Gutov
2020-12-15 22:01 ` Stefan Monnier
2020-12-16 3:13 ` Tests in core depending on GNU ELPA packages (was: decision on moving core packages to ELPA; also move to obsolete?) Thomas Fitzsimmons
2020-12-16 3:24 ` Tests in core depending on GNU ELPA packages Stefan Monnier
2021-02-19 1:09 ` Thomas Fitzsimmons
2021-02-19 1:15 ` Stefan Monnier
2020-12-16 17:53 ` decision on moving core packages to ELPA; also move to obsolete? Eli Zaretskii
2020-12-16 18:35 ` Stefan Monnier
2020-12-16 19:23 ` Eli Zaretskii
2020-12-16 20:01 ` Stefan Monnier
2020-12-16 20:05 ` Eli Zaretskii
2020-12-16 20:13 ` Stefan Monnier
2020-12-16 19:46 ` Stephen Leake
2020-12-16 20:10 ` Stefan Monnier
2020-12-16 19:21 ` Stephen Leake
2020-12-16 19:56 ` Eli Zaretskii
2020-12-15 19:57 ` Stefan Monnier
2020-12-15 20:16 ` Eli Zaretskii
2020-12-15 22:09 ` Stefan Monnier
2020-12-16 8:29 ` Michael Albinus
2020-12-16 14:20 ` Stefan Monnier
2020-12-16 14:42 ` Michael Albinus
2020-12-16 8:47 ` Andrea Corallo via Emacs development discussions.
2020-12-16 17:56 ` Eli Zaretskii
2020-12-16 18:46 ` Stefan Monnier
2020-12-16 19:28 ` Eli Zaretskii
2020-12-16 20:05 ` Stefan Monnier
2020-12-15 18:33 ` Eli Zaretskii
2020-12-15 20:11 ` Stefan Monnier
2020-12-15 20:29 ` Eli Zaretskii
2020-12-15 22:25 ` Stefan Monnier
2020-12-16 17:59 ` Eli Zaretskii
2020-12-16 18:50 ` Stefan Monnier
2020-12-16 19:32 ` Eli Zaretskii
2020-12-16 20:06 ` Stefan Monnier
2020-12-16 20:19 ` Eli Zaretskii
2020-12-16 21:03 ` Stefan Monnier
2020-12-16 19:44 ` Stephen Leake
2020-12-16 20:01 ` Eli Zaretskii
2021-01-10 23:05 ` Stephen Leake [this message]
2021-01-10 23:14 ` ELPA notes, README Stefan Monnier
2020-12-15 14:05 ` decision on moving core packages to ELPA; also move to obsolete? Stefan Monnier
2020-12-15 17:04 ` Eli Zaretskii
2020-12-15 17:28 ` Stefan Monnier
2020-12-15 5:46 ` Lars Ingebrigtsen
2020-12-15 18:50 ` Stephen Leake
2021-01-07 17:33 ` Stephen Leake
2021-01-07 20:00 ` Stefan Monnier
2021-01-08 17:00 ` Stephen Leake
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=86wnwks89d.fsf_-_@stephe-leake.org \
--to=stephen_leake@stephe-leake.org \
--cc=emacs-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).