<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Installing and Using the git version of gtkmm</title>
<link rel="stylesheet" type="text/css" href="style.css">
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="Programming with gtkmm 3">
<link rel="up" href="chapter-working-with-source.html" title="Appendix F. Working with gtkmm's Source Code">
<link rel="prev" href="chapter-working-with-source.html" title="Appendix F. Working with gtkmm's Source Code">
<link rel="next" href="chapter-wrapping-c-libraries.html" title="Appendix G. Wrapping C Libraries with gmmproc">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">Installing and Using the git version of <span class="application">gtkmm</span>
</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="chapter-working-with-source.html"><img src="icons/prev.png" alt="Prev"></a> </td>
<th width="60%" align="center">Appendix F. Working with gtkmm's Source Code</th>
<td width="20%" align="right"> <a accesskey="n" href="chapter-wrapping-c-libraries.html"><img src="icons/next.png" alt="Next"></a>
</td>
</tr>
</table>
<hr>
</div>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="sec-installing-jhbuild"></a>Installing and Using the git version of <span class="application">gtkmm</span>
</h2></div></div></div>
<p>
Once you've configured <span class="application">jhbuild</span> as described
above, building <span class="application">gtkmm</span> should be relatively straightforward. The first
time you run <span class="application">jhbuild</span>, you should run the
following sequence of commands to ensure that
<span class="application">jhbuild</span> has the required tools and verify that
it is set up correctly:
</p>
<pre class="screen">$ jhbuild bootstrap
$ jhbuild sanitycheck</pre>
<p>
</p>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="jhbuild-installing-gtkmm"></a>Installing <span class="application">gtkmm</span> with <span class="application">jhbuild</span>
</h3></div></div></div>
<p>
If everything worked correctly, you should be able to build <span class="application">gtkmm</span> and
all of its dependencies from git by executing <span class="command"><strong>jhbuild
build</strong></span> (or, if you didn't specify <span class="application">gtkmm</span> in the
<code class="varname">modules</code> variable, with the command <span class="command"><strong>jhbuild
build gtkmm</strong></span>).
</p>
<p>
This command will build and install a series of modules and will probably
take quite a long time the first time through. After the first time,
however, it should go quite a bit faster since it only needs to rebuild
files that changed since the last build. Alternatively, after you've
built and installed <span class="application">gtkmm</span> the first time, you can rebuild <span class="application">gtkmm</span> by
itself (without rebuilding all of its dependencies) with the command
<span class="command"><strong>jhbuild buildone gtkmm</strong></span>.
</p>
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="jhbuild-using-gtkmm"></a>Using the git version of <span class="application">gtkmm</span>
</h3></div></div></div>
<p>
After you've installed the git version of <span class="application">gtkmm</span>, you're ready to start
using and experimenting with it. In order to use the new version of
<span class="application">gtkmm</span> you've just installed, you need to set some environment
variables so that your <code class="filename">configure</code> script knows where
to find the new libraries. Fortunately,
<span class="application">jhbuild</span> offers an easy solution to this
problem. Executing the command <span class="command"><strong>jhbuild shell</strong></span> will
start a new shell with all of the correct environment variables set.
Now if you re-configure and build your project just as you usually do,
it should link against the newly installed libraries. To return to your
previous environment, simply exit the <span class="application">jhbuild</span>
shell.
</p>
<p>
Once you've built your software, you'll need to run your program within
the jhbuild environment as well. To do this, you can again use the
<span class="command"><strong>jhbuild shell</strong></span> command to start a new shell with the
<span class="application">jhbuild</span> environment set up. Alternatively,
you can execute a one-off command in the
<span class="application">jhbuild</span> environment using the following
command: <span class="command"><strong>jhbuild run command-name</strong></span>. In this case,
the command will be run with the correct environment variables set, but
will return to your previous environment after the program exits.
</p>
</div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="chapter-working-with-source.html"><img src="icons/prev.png" alt="Prev"></a> </td>
<td width="20%" align="center"><a accesskey="u" href="chapter-working-with-source.html"><img src="icons/up.png" alt="Up"></a></td>
<td width="40%" align="right"> <a accesskey="n" href="chapter-wrapping-c-libraries.html"><img src="icons/next.png" alt="Next"></a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Appendix F. Working with gtkmm's Source Code </td>
<td width="20%" align="center"><a accesskey="h" href="index.html"><img src="icons/home.png" alt="Home"></a></td>
<td width="40%" align="right" valign="top"> Appendix G. Wrapping C Libraries with gmmproc</td>
</tr>
</table>
</div>
</body>
</html>
