====== Building the gEDA/gaf git repository version ======
===== General Instructions =====
To build the git repository version of gEDA/gaf, follow these instructions:
* 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.
* A C/C++ compiler and standard library ([[ http://gcc.gnu.org/ | GCC ]] and [[ http://www.gnu.org/software/libc/ | GNU Libc ]] are recommended)
* [[ http://flex.sourceforge.net/ | flex ]] current
* [[ http://www.gnu.org/software/gawk/ | GNU awk ]] current
* [[ http://www.gnu.org/software/automake | automake ]] 1.11.0 or later
* [[ http://www.gnu.org/software/autoconf/ | autoconf ]] 2.60 or later
* [[ http://www.gnu.org/software/libtool/ | libtool ]] current
* [[ http://www.gnu.org/software/texinfo/ | texinfo ]] current
* [[ http://pkgconfig.freedesktop.org/wiki | pkg-config ]] current
* [[ http://www.gnu.org/software/gettext/ | gettext ]] 0.18 or later
* [[ http://www.gnu.org/software/guile" | guile ]] 2.0 or 2.2 (1.x is no longer supported)
* [[ http://www.gtk.org/ | gtk+ ]] 2.18.0 or later
* [[ http://www.gnu.org/software/groff/groff.html | groff ]] current
* [[ http://git-scm.com | git ]] 1.6.x or later
* [[https://www.python.org/downloads/|CPython]] 2.7
* [[http://oss.sgi.com/projects/fam/|FAM]] or [[https://people.gnome.org/~veillard/gamin/|Gamin]] (Gamin is recommended)
* [[ http://freedesktop.org/Software/shared-mime-info | freedesktop.org MIME info database ]] current
* [[ http://www.freedesktop.org/software/desktop-file-utils/releases | freedesktop.org utilities for manipulating .desktop files ]] current
* 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.
* Clone the source from the official git repository. For information on how to do this, read the [[ geda:scm | gEDA SCM page ]]
* Build the software by executing the following commands inside of the newly cloned git repository:
$ ./autogen.sh
$ ./configure --prefix=$HOME/geda --enable-silent-rules
$ make
$ make install
* If the above commands execute without **any** 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.
* You can now run the various programs in the gEDA suite. Please read the toplevel README file which describes what is available.
* gschem is the schematic capture program and can be run by executing: ''PATH_WHERE_gEDA_GAF_IS_INSTALLED/bin/gschem''
* It is recommended that you add ''PATH_WHERE_gEDA_GAF_IS_INSTALLED/bin'' to your PATH environment variable (typically done by modifying one of the following files: ''$HOME/.bashrc'', ''$HOME/.bash_profile'', or ''$HOME/.profile'').
* 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.
* If you want to get gEDA/gaf repository commit log e-mail messages, please subscribe to the geda-cvs mailing list. Please see the [[ geda:mailinglists | mailing lists page ]] for info on how to do this.
* For build problems, please be sure to read the [[ geda:mailinglists | mailing list archives ]] or [[ http://www.geda-project.org/search.html | search ]] this site. Also look at the [[ :start | gEDA wiki ]] for more hints.
===== Distro-specific information =====
==== Debian-based ====
This is tested on [[http://crunchbanglinux.org/|Crunchbang Linux]] but should work on Debian Wheezy and possibly Ubuntu also.
- Install the build dependencies for the packaged version of gEDA:
$ sudo apt-get build-dep geda
- Install the packages that don't get pulled in by the above command:
$ sudo apt-get install texinfo
$ sudo apt-get install autopoint
$ sudo apt-get install libtool
- If you want to generate doxygen output, install it and the other prerequisites:
$ sudo apt-get install doxygen
$ sudo apt-get install imagemagick
$ sudo apt-get install graphviz
- Clone the source from the official git repository. For information on how to do this, read the [[ geda:scm | gEDA SCM topic ]].
- From inside the newly cloned repository, build gEDA/gaf:
$ ./autogen.sh
$ ./configure --prefix=$HOME/geda --enable-silent-rules [--enable-doxygen]
$ make
$ make install
==== MacPorts ====
[[http://www.macports.org/|MacPorts]] is an open-source community initiative to design an easy-to-use system for compiling, installing, and upgrading open-source software on the Mac OS X operating system. MacPorts has a packaged installation of gEDA/gaf but occasionally one needs a more up-to-date version (such as that from git). The easiest way to build from git HEAD on MacPorts is to install the packaged version (at time of writing, 1.6.2) as a way of bringing most of the dependencies into the MacPorts tree.
- [[http://www.macports.org/install.php|Install MacPorts]].
- Install the MacPorts-packaged version of gEDA/gaf. As a happy side-effect, this brings in most of the build prerequisites. Also install autoconf and automake:
$ sudo port install geda-gaf
$ sudo port install autoconf
$ sudo port install automake
- If you want to generate doxygen output, install doxygen:
$ sudo port install doxygen
- Clone the source from the official git repository. For information on how to do this, read the [[ geda:scm | gEDA SCM topic ]].
- From inside the newly cloned repository, build gEDA/gaf:
$ ./autogen.sh
$ ./configure --prefix=$HOME/geda --disable-update-xdg-database --enable-silent-rules [--enable-doxygen]
$ make
$ make install
- If you are running a recent release of OS X, X server is not included by default so you might need to install [[http://xquartz.macosforge.org/landing/|XQuartz]]
- To run the software, you need to set an environment variable to allow Guile to load its shared libraries:
$ export LTDL_LIBRARY_PATH=/opt/local/lib
$ gschem