docs/wiki/geda-gaf_building_git_version.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   2  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html>
   4 <head>
   5   <title></title>
   6   <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
   7   <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
   8   <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
   9
  10   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  11 </head>
  12 <body>
  13
  14
  15 <h2 class="sectionedit1400"><a name="building_the_geda_gaf_git_repository_version" id="building_the_geda_gaf_git_repository_version">Building the gEDA/gaf git repository version</a></h2>
  16 <div class="level2">
  17
  18 <p>
  19 To build the git repository version of gEDA/gaf, follow these instructions:
  20
  21 </p>
  22 <ul>
  23 <li class="level1"><div class="li"> Download and install all the following dependencies.  You will probably want to use your distributions package management system (such as apt-get or yum) to install the dependencies.</div>
  24 <ul>
  25 <li class="level2"><div class="li"> A C compiler and C standard library (<a href="http://gcc.gnu.org/" class="urlextern" title="http://gcc.gnu.org/"  rel="nofollow"> GCC </a> and <a href="http://www.gnu.org/software/libc/" class="urlextern" title="http://www.gnu.org/software/libc/"  rel="nofollow"> GNU Libc </a> are recommended)</div>
  26 </li>
  27 <li class="level2"><div class="li"> <a href="http://flex.sourceforge.net/" class="urlextern" title="http://flex.sourceforge.net/"  rel="nofollow"> flex </a> current</div>
  28 </li>
  29 <li class="level2"><div class="li"> <a href="http://www.gnu.org/software/gawk/" class="urlextern" title="http://www.gnu.org/software/gawk/"  rel="nofollow"> GNU awk </a> current</div>
  30 </li>
  31 <li class="level2"><div class="li"> <a href="http://www.gnu.org/software/automake" class="urlextern" title="http://www.gnu.org/software/automake"  rel="nofollow"> automake </a> 1.6.x or later</div>
  32 </li>
  33 <li class="level2"><div class="li"> <a href="http://www.gnu.org/software/autoconf/" class="urlextern" title="http://www.gnu.org/software/autoconf/"  rel="nofollow"> autoconf </a>  2.60 or later</div>
  34 </li>
  35 <li class="level2"><div class="li"> <a href="http://www.gnu.org/software/libtool/" class="urlextern" title="http://www.gnu.org/software/libtool/"  rel="nofollow"> libtool </a> current</div>
  36 </li>
  37 <li class="level2"><div class="li"> <a href="http://pkgconfig.freedesktop.org/wiki" class="urlextern" title="http://pkgconfig.freedesktop.org/wiki"  rel="nofollow"> pkg-config </a> current</div>
  38 </li>
  39 <li class="level2"><div class="li"> <a href="http://www.gnu.org/software/gettext/" class="urlextern" title="http://www.gnu.org/software/gettext/"  rel="nofollow"> gettext </a>  0.16 or later</div>
  40 </li>
  41 <li class="level2"><div class="li"> <a href="http://www.gnu.org/software/guile%22" class="urlextern" title="http://www.gnu.org/software/guile&quot;"  rel="nofollow"> guile </a>  1.8.x (1.6.x is no longer supported)</div>
  42 </li>
  43 <li class="level2"><div class="li"> <a href="http://www.gtk.org/" class="urlextern" title="http://www.gtk.org/"  rel="nofollow"> gtk+ </a> 2.10.x or later</div>
  44 </li>
  45 <li class="level2"><div class="li"> <a href="http://www.gnu.org/software/groff/groff.html" class="urlextern" title="http://www.gnu.org/software/groff/groff.html"  rel="nofollow"> groff </a> current</div>
  46 </li>
  47 <li class="level2"><div class="li"> <a href="http://git-scm.com" class="urlextern" title="http://git-scm.com"  rel="nofollow"> git </a> 1.6.x or later</div>
  48 </li>
  49 <li class="level2"><div class="li"> <a href="http://www.nongnu.org/cvs/" class="urlextern" title="http://www.nongnu.org/cvs/"  rel="nofollow"> cvs </a> current</div>
  50 </li>
  51 <li class="level2"><div class="li"> <a href="http://freedesktop.org/Software/shared-mime-info" class="urlextern" title="http://freedesktop.org/Software/shared-mime-info"  rel="nofollow"> freedesktop.org MIME info database </a> current</div>
  52 </li>
  53 <li class="level2"><div class="li"> <a href="http://www.freedesktop.org/software/desktop-file-utils/releases" class="urlextern" title="http://www.freedesktop.org/software/desktop-file-utils/releases"  rel="nofollow"> freedesktop.org utilities for manipulating .desktop files </a> current </div>
  54 </li>
  55 </ul>
  56 </li>
  57 </ul>
  58 <ul>
  59 <li class="level1"><div class="li"> It is pretty important to have all of the above programs (especially automake, autoconf, libtool, gtk, and guile) installed in the same prefix (like /usr or /usr/local).  If you do not have them all installed in the same prefix, then building and installing gEDA/gaf is much harder.</div>
  60 </li>
  61 </ul>
  62 <ul>
  63 <li class="level1"><div class="li"> Clone the source from the official git repository.  For information on how to do this, read the <a href="geda-scm.html" class="wikilink1" title="geda-scm.html"> gEDA SCM page </a></div>
  64 </li>
  65 </ul>
  66 <ul>
  67 <li class="level1"><div class="li"> Build the software by executing the following commands inside of the newly cloned git repository:</div>
  68 </li>
  69 </ul>
  70 <pre class="code">    ./autogen.sh
  71     ./configure --prefix=$HOME/geda
  72     make
  73     make install</pre>
  74 <ul>
  75 <li class="level1"><div class="li"> If the above commands execute without <strong>any</strong> error messages, then you have successfully built and installed gEDA/gaf.  If you encounter any errors, be sure to read the README and INSTALL files contained within the tarball.</div>
  76 </li>
  77 </ul>
  78 <ul>
  79 <li class="level1"><div class="li"> You can now run the various programs in the gEDA suite.  Please read the toplevel README file which describes what is available.</div>
  80 </li>
  81 </ul>
  82 <ul>
  83 <li class="level1"><div class="li"> gschem is the schematic capture program and can be run by executing: <code>PATH_WHERE_gEDA_GAF_IS_INSTALLED/bin/gschem</code></div>
  84 </li>
  85 </ul>
  86 <ul>
  87 <li class="level1"><div class="li"> It is recommended that you add <code>PATH_WHERE_gEDA_GAF_IS_INSTALLED/bin</code> to your PATH environment variable (typically done by modifying one of the following files: <code>$HOME/.bashrc</code>, <code>$HOME/.bash_profile</code>, or <code>$HOME/.profile</code>).</div>
  88 </li>
  89 </ul>
  90 <ul>
  91 <li class="level1"><div class="li"> It is highly recommended that you read the gEDA documentation at this point.  You can access the gEDA documentation by running gschem and select Help/gEDA Documentation… from the top menu.</div>
  92 </li>
  93 </ul>
  94 <ul>
  95 <li class="level1"><div class="li"> If you want to get gEDA/gaf repository commit log e-mail messages, please subscribe to the geda-cvs mailing list.  Please see the <a href="geda-mailinglists.html" class="wikilink1" title="geda-mailinglists.html"> mailing lists page </a> for info on how to do this.</div>
  96 </li>
  97 </ul>
  98 <ul>
  99 <li class="level1"><div class="li"> For build problems, please be sure to read the <a href="geda-mailinglists.html" class="wikilink1" title="geda-mailinglists.html"> mailing list archives </a> or <a href="http://www.gpleda.org/search.html" class="urlextern" title="http://www.gpleda.org/search.html"  rel="nofollow"> search </a> this site.  Also look at the <a href="start.html" class="wikilink1" title="start.html"> gEDA wiki </a> for more hints.</div>
 100 </li>
 101 </ul>
 102
 103 </div>
 104 </body>
 105 </html>