admin/make-tarball.txt: Misc small updates/edits

[bpt/emacs.git] / admin / notes / hydra

diff --git a/admin/notes/hydra b/admin/notes/hydra
index 776c1e2..3b6bc87 100644 (file)
--- a/admin/notes/hydra
+++ b/admin/notes/hydra
@@ -1,23 +1,24 @@
 -*- outline -*-
 
-Copyright (C) 2013 Free Software Foundation, Inc.
+Copyright (C) 2013-2014 Free Software Foundation, Inc.
 See the end of the file for license conditions.
 
 NOTES FOR EMACS CONTINUOUS BUILD ON HYDRA
 
-A continuous build for Emacs trunk can be found at
+A continuous build for Emacs can be found at
 http://hydra.nixos.org/jobset/gnu/emacs-trunk
+http://hydra.nixos.org/jobset/gnu/emacs-24
 
-* It builds (and runs ERT tests) on these platforms:
-i686-cygwin
-i686-freebsd
-i686-linux
-x86_64-darwin
-x86_64-linux
+* It builds Emacs on various platforms.
+Sometimes jobs fail due to hydra problems rather than Emacs problems.
+Eg it seems like the cygwin build will never work again.
+http://lists.gnu.org/archive/html/hydra-users/2013-08/msg00000.html
 
 * Mail notifications
-Hydra sends notifications about build breakages in Emacs trunk to
-emacs-buildstatus@gnu.org.
+In addition to the web interface, Hydra can send notifications by
+email when the build status of a project changes—e.g., from
+`SUCCEEDED' to `FAILED'.  It sends notifications about build status in
+Emacs trunk to emacs-buildstatus@gnu.org.
 
 If you want to receive these notifications, please subscribe at
 http://lists.gnu.org/mailman/listinfo/emacs-buildstatus
@@ -25,21 +26,29 @@ http://lists.gnu.org/mailman/listinfo/emacs-buildstatus
 * The Emacs jobset consists of the following jobs:
 
 ** The `tarball' job
-which gets the source tree as input, and is just a `make dist' after
-some autoconf/-make or bootstrap script.
+which gets a checkout from bzr, and does a bootstrap followed
+by running make-dist to create a tarball.  If this job fails, all the
+others will too (because they use the tarball as input).
 
 ** The `build' job
-which gets the result of the tarball job as input, together with
-system identifier, this job basically does a normal make, make check,
-make install.
+which starts from the tarball and does a normal build
 
 ** The 'coverage' job
-is now running `make check'.
+does a gcov build and then runs `make check'.  Fails if any test fails.
 
-* Other GNU packages
+* Nix expressions
+The recipe for GNU Emacs are available via Git:
+http://git.savannah.gnu.org/cgit/hydra-recipes.git/tree/emacs
+
+To modify the build job, email the patch to hydra-users@gnu.org.  The
+build recipes are written in the Nix language.
+
+* Other Information
 For a list of other GNU packages that have a continuous build on
 Hydra, see http://hydra.nixos.org/project/gnu
 
+See http://www.gnu.org/software/devel.html#Hydra for more information.
+
 \f
 This file is part of GNU Emacs.