[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa-admin 1ddc741 347/439: * README.org: Prefer org syntax and
From: |
Philip Kaludercic |
Subject: |
[nongnu] elpa-admin 1ddc741 347/439: * README.org: Prefer org syntax and prepare for export. |
Date: |
Sun, 17 Oct 2021 15:48:33 -0400 (EDT) |
branch: elpa-admin
commit 1ddc7419c0e6078d0fca9289d0c6b97d34faee01
Author: Stefan Kangas <stefankangas@gmail.com>
Commit: Stefan Monnier <monnier@iro.umontreal.ca>
* README.org: Prefer org syntax and prepare for export.
---
README.org | 63 +++++++++++++++++++++++++++++++++++++++++++++++---------------
1 file changed, 48 insertions(+), 15 deletions(-)
diff --git a/README.org b/README.org
index 593e9fa..0a4dc40 100644
--- a/README.org
+++ b/README.org
@@ -1,54 +1,70 @@
#+TITLE: NonGNU ELPA README
+#+DATE: 2020-11-28
Copyright (C) 2020 Free Software Foundation, Inc.
See the end of the file for license conditions.
This repository contains the sources, deployment scripts, and auxiliary files
-for NonGNU ELPA (elpa.nongnu.org).
+for [[https://nongnu.elpa.org][NonGNU ELPA]] (=elpa.nongnu.org=).
This file explains the repository layout, how to add and edit packages, and how
-to deploy the archive (either on elpa.nongnu.org, or a local copy for testing
+to deploy the archive (either on =elpa.nongnu.org=, or a local copy for testing
purposes).
+
* Building the archive
To build the archive(s), all it takes is:
- git clone .../nongnu.git
+#+begin_src sh
+ git clone .../nongnu.git $FOO
+#+end_src
which you presumably have done already if you're reading this file.
And then
+#+begin_src sh
cd .../nongnu
make build-all
+#+end_src
-This will build all the tarballs as well as the `archive-contents` file and
-put them into the `archive` and `archive-devel` subdirectories.
+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:
+You can also (re)build a specific package =[PKG]= with:
+#+begin_src sh
make build/[PKG]
+#+end_src
If you want to force a rebuild of a tarball that was already built, you have
to do:
+#+begin_src sh
rm archive/[PKG]-[VERSION].tar; make build/[PKG]
+#+end_src
+
* Using packages in-place
The packages can be installed and used in-place. First you need to make
-sure the package(s) you can about are placed in the `packages` subdirectory,
-e.g. with `make externals`, and then you can to add that `.../packages`
-to your `package-directory-list`. And once that is done you can do:
+sure the package(s) you can about are placed in the =packages= subdirectory,
+e.g. with =make externals=, and then you can to add that =.../packages=
+to your =package-directory-list=. And once that is done you can do:
+#+begin_src sh
make packages/[PKG]
+#+end_src
-to create the [PKG]-pkg.el and [PKG]-autoloads.el file as well as compile
+to create the =[PKG]-pkg.el= and =[PKG]-autoloads.el= file as well as compile
all the ELisp files in that package. You can also do that on all the
packages with:
+#+begin_src sh
make
+#+end_src
+
* Guidance for accepting packages
@@ -164,29 +180,34 @@ packages with:
the users.
-
* Adding a package
-Once it is decided we want to add a [PKG], here's what it takes:
+Once it is decided we want to add a package =[PKG]=, here's what it takes:
- Fetch the upstream code with something like:
+ #+begin_src sh
git fetch [PKGREMOTE]
+ #+end_src
- Let's say the code is now in [PKGBRANCH].
+ Let's say the code is now in =[PKGBRANCH]=.
-- Push that code to nongnu.git:
+- Push that code to =nongnu.git=:
+ #+begin_src sh
git push nongnu [PKGBRANCH]:refs/heads/externals/[PKG]
+ #+end_src
-- Add a corresponding entry to the file `externals-list`.
+- Add a corresponding entry to the file =externals-list=.
- Make sure the resulting tarball looks good and works well.
- Commit and push that change:
+ #+begin_src sh
git commit -m 'New package [PKG]'
git push
+ #+end_src
* License
@@ -204,3 +225,15 @@ GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with NonGNU ELPA. If not, see <http://www.gnu.org/licenses/>.
+
+
+#+STARTUP: showall
+#+OPTIONS: num:1
+#+AUTHOR: NonGNU ELPA Maintainers
+#+EMAIL: emacs-devel@gnu.org
+#+BEGIN_COMMENT
+Local variables:
+paragraph-separate: "[ ]*$"
+time-stamp-pattern: "4/#\\+DATE: %Y-%02m-%02d$"
+end:
+#+END_COMMENT
- [nongnu] elpa-admin 21fc443 349/439: * externals-list ("markdown-mode"): New package, (continued)
- [nongnu] elpa-admin 21fc443 349/439: * externals-list ("markdown-mode"): New package, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin cabb85a 398/439: * elpa-admin.el: Avoid build side-products in the tarball, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 08c448d 400/439: * elpa-admin.el (elpaa--pull): Fix last change, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 21e1b0e 101/439: Sync with yasnippet/master, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 7b7692d 243/439: Merge commit '6dc971269f6f9435e5159c2cfe66fc5e4b296df2', Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 858666e 250/439: * admin/archive-contents.el: Use cl-lib, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin f4e99d9 369/439: * elpa-admin.el (elpaa--make-one-package): Fix thinko, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 8ac87bb 355/439: Fold ert-support.el into elpa-admin.el, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 7fa8f34 399/439: * elpa-admin.el (elpaa--pull): Don't set non-existing upstream, Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 78966fe 348/439: * README.org: Improve introductory paragraphs., Philip Kaludercic, 2021/10/17
- [nongnu] elpa-admin 1ddc741 347/439: * README.org: Prefer org syntax and prepare for export.,
Philip Kaludercic <=
- [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