admin/notes/hydra

   1 -*- outline -*-
   2
   3 Copyright (C) 2013-2014 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 \f
  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/>.