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