aboutsummaryrefslogtreecommitdiffstats
path: root/admin/notes
diff options
context:
space:
mode:
Diffstat (limited to 'admin/notes')
-rw-r--r--admin/notes/bzr3
-rw-r--r--admin/notes/elpa25
-rw-r--r--admin/notes/hydra66
3 files changed, 80 insertions, 14 deletions
diff --git a/admin/notes/bzr b/admin/notes/bzr
index 8f7d0d94fa8..d3886abfd69 100644
--- a/admin/notes/bzr
+++ b/admin/notes/bzr
@@ -347,6 +347,9 @@ Runs on commit. Projects can enable it themselves by using `bzr
347config' to set post_commit_to option for a branch. See `bzr help email' 347config' to set post_commit_to option for a branch. See `bzr help email'
348(if you have the plugin installed) for other options. 348(if you have the plugin installed) for other options.
349 349
350The From: address will be that of your Savannah account, rather than
351your `bzr whoami' information.
352
350Note: if you have the bzr-email plugin installed locally, then when 353Note: if you have the bzr-email plugin installed locally, then when
351you commit to the Emacs repository it will also try to send a commit 354you commit to the Emacs repository it will also try to send a commit
352email from your local machine. If your machine is not configured to 355email from your local machine. If your machine is not configured to
diff --git a/admin/notes/elpa b/admin/notes/elpa
index db14456fe32..469a0ca8bd1 100644
--- a/admin/notes/elpa
+++ b/admin/notes/elpa
@@ -1,24 +1,21 @@
1NOTES ON THE EMACS PACKAGE ARCHIVE 1NOTES ON THE EMACS PACKAGE ARCHIVE
2 2
3The GNU Emacs package archive, at elpa.gnu.org, is managed using a Bzr 3The GNU Emacs package archive, at elpa.gnu.org, is managed using a Git
4branch named "elpa", hosted on Savannah. To check it out: 4repository named "elpa", hosted on Savannah. To check it out:
5 5
6 bzr branch bzr+ssh://USER@bzr.savannah.gnu.org/emacs/elpa elpa 6 git clone git://bzr.sv.gnu.org/emacs/elpa
7 cd elpa 7 cd elpa
8 echo "public_branch = bzr+ssh://USER@bzr.savannah.gnu.org/emacs/elpa" >> .bzr/branch/branch.conf 8 git remote set-url --push origin git+ssh://bzr.sv.gnu.org/srv/git/emacs/elpa
9 bzr bind bzr+ssh://USERNAME@bzr.savannah.gnu.org/emacs/elpa
10 [create task branch for edits, etc.] 9 [create task branch for edits, etc.]
11 10
12Changes to this branch propagate to elpa.gnu.org in a semi-manual way. 11Changes to this branch propagate to elpa.gnu.org via a "deployment" script run
13There exists a copy of the elpa branch on that machine. Someone with 12daily. This script (which is kept in elpa/admin/update-archive.sh) generates
14access logs in, pulls the latest changes from Savannah, and runs a 13the content visible at http://elpa.gnu.org/packages.
15"deployment" script. This script (which is itself kept in the Bzr
16branch) generates the content visible at http://elpa.gnu.org/packages.
17 14
18The reason we set things up this way, instead of using the package 15A new package is released as soon as the "version number" of that package is
19upload commands in package-x.el, is to let Emacs hackers conveniently 16changed. So you can use `elpa' to work on a package without fear of releasing
20edit the contents of the "elpa" branch. (In particular, multi-file 17those changes prematurely. And once the code is ready, just bump the
21packages are stored on the branch in source form, not as tarfiles.) 18version number to make a new release of the package.
22 19
23It is easy to use the elpa branch to deploy a "local" copy of the 20It is easy to use the elpa branch to deploy a "local" copy of the
24package archive. For details, see the README file in the elpa branch. 21package archive. For details, see the README file in the elpa branch.
diff --git a/admin/notes/hydra b/admin/notes/hydra
new file mode 100644
index 00000000000..71e35d092c8
--- /dev/null
+++ b/admin/notes/hydra
@@ -0,0 +1,66 @@
1-*- outline -*-
2
3Copyright (C) 2013 Free Software Foundation, Inc.
4See the end of the file for license conditions.
5
6NOTES FOR EMACS CONTINUOUS BUILD ON HYDRA
7
8A continuous build for Emacs can be found at
9http://hydra.nixos.org/jobset/gnu/emacs-trunk
10http://hydra.nixos.org/jobset/gnu/emacs-24
11
12* It builds Emacs on various platforms.
13Sometimes jobs fail due to hydra problems rather than Emacs problems.
14Eg it seems like the cygwin build will never work again.
15http://lists.gnu.org/archive/html/hydra-users/2013-08/msg00000.html
16
17* Mail notifications
18In addition to the web interface, Hydra can send notifications by
19email when the build status of a project changes—e.g., from
20`SUCCEEDED' to `FAILED'. It sends notifications about build status in
21Emacs trunk to emacs-buildstatus@gnu.org.
22
23If you want to receive these notifications, please subscribe at
24http://lists.gnu.org/mailman/listinfo/emacs-buildstatus
25
26* The Emacs jobset consists of the following jobs:
27
28** The `tarball' job
29which gets a checkout from bzr, and does a bootstrap followed
30by running make-dist to create a tarball. If this job fails, all the
31others will too (because they use the tarball as input).
32
33** The `build' job
34which starts from the tarball and does a normal build
35
36** The 'coverage' job
37does a gcov build and then runs `make check'. Fails if any test fails.
38
39* Nix expressions
40The recipe for GNU Emacs are available via Git:
41http://git.savannah.gnu.org/cgit/hydra-recipes.git/tree/emacs
42
43To modify the build job, email the patch to hydra-users@gnu.org. The
44build recipes are written in the Nix language.
45
46* Other Information
47For a list of other GNU packages that have a continuous build on
48Hydra, see http://hydra.nixos.org/project/gnu
49
50See http://www.gnu.org/software/devel.html#Hydra for more information.
51
52
53This file is part of GNU Emacs.
54
55GNU Emacs is free software: you can redistribute it and/or modify
56it under the terms of the GNU General Public License as published by
57the Free Software Foundation, either version 3 of the License, or
58(at your option) any later version.
59
60GNU Emacs is distributed in the hope that it will be useful,
61but WITHOUT ANY WARRANTY; without even the implied warranty of
62MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
63GNU General Public License for more details.
64
65You should have received a copy of the GNU General Public License
66along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.