[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa-admin 040972d 342/439: * README.org: Describe how to build
From: |
Philip Kaludercic |
Subject: |
[nongnu] elpa-admin 040972d 342/439: * README.org: Describe how to build the archive and add a package |
Date: |
Sun, 17 Oct 2021 15:48:32 -0400 (EDT) |
branch: elpa-admin
commit 040972d999601a20ec2c45b7f48975d75e62a457
Author: Stefan Monnier <monnier@iro.umontreal.ca>
Commit: Stefan Monnier <monnier@iro.umontreal.ca>
* README.org: Describe how to build the archive and add a package
---
README.org | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 49 insertions(+)
diff --git a/README.org b/README.org
index 02d2f72..38481f9 100644
--- a/README.org
+++ b/README.org
@@ -1,3 +1,28 @@
+* Building the archive
+
+To build the archive(s), all it takes is:
+
+ git clone .../nongnu.git
+
+which you presumably have done already if you're reading this file.
+And then
+
+ cd .../nongnu
+ make build-all
+
+This will build all the tarballs as well as the `archive-contents` file and
+put them into the `archive` and `archive-devel` subdirectories.
+If the archive exists already, it will only build those tarballs that are new.
+
+You can also (re)build a specific package [PKG] with:
+
+ make build/[PKG]
+
+If you want to force a rebuild of a tarball that was already built, you have
+to do:
+
+ rm archive/[PKG]-[VERSION].tar; make build/[PKG]
+
* Guidance for accepting packages
** We don't ask for copyright assignments to include packages in NonGNU ELPA.
@@ -111,3 +136,27 @@
the package, and you can mention fan items that you sell directly to
the users.
+
+
+* Adding a package
+
+Once it is decided we want to add a [PKG], here's what it takes:
+
+- Fetch the upstream code with something like:
+
+ git fetch [PKGREMOTE]
+
+ Let's say the code is now in [PKGBRANCH].
+
+- Push that code to nongnu.git:
+
+ git push nongnu [PKGBRANCH]:refs/heads/externals/[PKG]
+
+- Add a corresponding entry to the file `externals-list`.
+
+- Make sure the resulting tarball looks good and works well.
+
+- Commit and push that change:
+
+ git commit -m 'New package [PKG]'
+ git push
- [nongnu] elpa-admin 0466964 352/439: * README.org (Adding a package): Adjust to use the new `make` targets, (continued)
- [nongnu] elpa-admin 0466964 352/439: * README.org (Adding a package): Adjust to use the new `make` targets, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin a74eed7 366/439: * elpa-admin.el (elpaa--bwrap-args): Add `lib64` for amd64 hosts, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 60ecd84 351/439: * admin/archive-contents.el: Fix construction of index.html, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin dcc3222 396/439: Fix various problems when compiling packages in place, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin d1d1dbd 393/439: * elpa-admin.el (elpaa--build-Info): Fix last change, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 0942ea5 385/439: ; * README.org: Fix typos., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 21cddee 407/439: * elpa-admin.el (elpaa--get-devel-version): Fix regexp substitution, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin ee591c2 379/439: * elpa-admin.el (elpaa--release-email): Cc maintainer, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin d19a5b8 341/439: * README.org: New file, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 5eab162 377/439: * elpa-admin.el: Give read access to Git in `:make`, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 040972d 342/439: * README.org: Describe how to build the archive and add a package,
Philip Kaludercic <=
- [nongnu] elpa-admin 6dcc26f 378/439: * elpa-admin.el (elpaa--make): Fix last change, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 26d341c 391/439: * elpa-admin.el (elpaa--make): Add support for non-make command, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin fd06277 384/439: * elpa-admin.el (elpaa--core-package-sync): Don't presume shape of plist, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin f3fd8c5 387/439: * GNUmakefile (%.tar): New target, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 221c427 350/439: * admin/archive-contents.el: Improve handling of snapshot version numbers, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin c84575d 411/439: * elpa-admin.el (elpaa--get-release-revision): Fix code for :core pkgs, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin e3ca730 420/439: Support LibreJS, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 9e01d93 406/439: * elpa-admin.el (elpaa--prune-old-tarballs): Return resulting oldtarballs, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin fae2e2e 412/439: * elpa-admin.el (elpaa--prune-old-tarballs): Fix computation of .sig name, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 0783750 417/439: * elpa-admin.el (elpaa--sandbox-extra-ro-dirs): New var, Philip Kaludercic, 2021/10/17