<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE refentry 
  PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="travis-ci-integration">
<refmeta>
  <refentrytitle role="top_of_page" id="travis-ci-integration.top_of_page">Travis CI integration</refentrytitle>
  <refmiscinfo>CUTTER Library</refmiscinfo>
</refmeta>
<refnamediv>
  <refname>Travis CI integration</refname>
</refnamediv>
<refsect1>
  <title>Introduction</title>
  <para>
  This section describes about using Cutter on 
  <ulink url="http://travis-ci.org/">Travis CI</ulink>
  . Travis CI is a hosted continuous integration service for the open source community.
</para>
  <para>
  You can use Travis CI for your open source software. This section only describes about groonga related configuration. See 
  <ulink url="http://about.travis-ci.org/docs/">Travis CI:Documentation</ulink>
    about general Travis CI.
</para>
</refsect1>

<refsect1>
  <title>Configuration</title>
  <para>
  Travis CI is running on 32-bit Ubuntu 11.10. (See 
  <ulink url="http://about.travis-ci.org/docs/user/ci-environment/">Travis CI: About Travis CI Environment</ulink>
  .) You can use apt-line for Ubuntu 11.10 provided by Cutter project to install Cutter on Travis CI.
</para>
  <para>
  You can custom build lifecycle by 
  <code>.travis.yml</code>
  . (See 
  <ulink url="http://about.travis-ci.org/docs/user/build-configuration/">Travis CI: Conifugration your Travis CI build with .travis.yml</ulink>
  .) You can use 
  <code>before_install</code>
   hook or 
  <code>install</code>
   hook. You should use
  <code>before_install</code>
   if your software uses a language that is supported by Travis CI such as Ruby. You should use 
  <code>install</code>
   otherwise.
</para>
  <para>
  Add the following 
  <code>before_install</code>
   configuration to 
  <code>.travisyml</code>
  ::
</para>
  <programlisting>before_install:
  - curl https://raw.github.com/clear-code/cutter/master/data/travis/setup.sh | sh</programlisting>
  <para>
  If you need to use 
  <code>install</code>
   hook instead of 
  <code>before_install</code>
  , you just substitute 
  <code>before_install:</code>
   with 
  <code>install:</code>
  .
</para>
  <para>With the above configuration, you can use Cutter for your build.</para>
</refsect1>

<refsect1>
  <title>Examples</title>
  <para>Here are open source softwares that use Cutter on Travis CI:</para>
  <itemizedlist>
  <listitem>
  <para>
  <ulink url="http://groonga.org/">groonga</ulink>
  
</para>
  <itemizedlist>
  <listitem>
  <para>
  <ulink url="http://travis-ci.org/#!/groonga/groonga">groonga on Travis CI</ulink>
  
</para>
</listitem>
  <listitem>
  <para>
  <ulink url="https://github.com/groonga/groonga/blob/master/.travis.yml">.travis.yml for groonga</ulink>
  
</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</refsect1>
</refentry>
