Next: , Previous: , Up: Introduction   [Contents][Index]


1.2 Obtaining and Installing Guile-CV

Guile-CV can be obtained from the following archive site. The file will be named guile-cv-version.tar.gz. The current version is 0.2.0, so the file you should grab is:

http://ftp.gnu.org/gnu/guile-cv/guile-cv-0.2.0.tar.gz

Dependencies

Guile-CV needs the following software to run:

Install from the tarball

Assuming you have satisfied the dependencies, open a terminal and proceed with the following steps:

cd <download-path>
tar zxf guile-cv-0.2.0.tar.gz
cd guile-cv-0.2.0
./configure [--prefix=/your/prefix] [--with-guile-site=yes]
make
make install

Special notes:

Before you start to use Guile-CV, make sure you read and implement the recommendation made in the manual, section See Configuring Guile for Guile-CV.

Happy Guile-CV!

Install from the source

Guile-CV uses Git for revision control, hosted on Savannah, you may browse the sources repository here.

There are currently 2 [important] branches: master and devel. Guile-CV stable branch is master, developments occur on the devel branch.

So, to grab, compile and install from the source, open a terminal and:

git clone git://git.savannah.gnu.org/guile-cv.git
cd guile-cv
./autogen.sh
./configure [--prefix=/your/prefix] [--with-guile-site=yes]
make
make install

Special notes:

Before you start to use Guile-CV, make sure you read and implement the recommendation made in the manual, section See Configuring Guile for Guile-CV.

The above steps ensure you’re using Guile-CV bleeding edge stable version. If you wish to participate to developments, checkout the devel branch:

git checkout devel

Happy hacking!


Notes:

  1. The default and --prefix installation locations for source modules and compiled files (in the absence of --with-guile-site=yes) are:
    $(datadir)/guile-cv
    $(libdir)/guile-cv/guile/$(GUILE_EFFECTIVE_VERSION)/site-ccache
    

    If you pass --with-guile-site=yes, these locations become the Guile site and site-ccache directories, respectively.

    The configure step reports these locations as the content of the sitedir and siteccachedir variables, respectivelly the source modules and compiled files install locations. After installation, you may consult these variables using pkg-config:

    pkg-config guile-cv-1.0 --variable=sitedir
    pkg-config guile-cv-1.0 --variable=siteccachedir
    

    You will need - unless you have used --with-guile-site=yes, or unless these locations are already ’known’ by Guile - to define or augment your GUILE_LOAD_PATH and GUILE_COMPILED_PATH environment variables with these locations, respectively (or %load-path and %load-compiled-path at run time if you prefer2 (See Environment Variables and Load Path in the Guile Reference Manual).

  2. Guile-CV also installs its libguile-cv.* library files, in $(libdir). The configure step reports its location as the content of the libdir variable, which depends on on the content of the prefix and exec_prefix variables (also reported). After nstallation, you may consult these variables using pkg-config:
    pkg-config guile-cv-1.0 --variable=prefix
    pkg-config guile-cv-1.0 --variable=exec_prefix
    pkg-config guile-cv-1.0 --variable=libdir
    

    You will need - unless the $(libdir) location is already ’known’ by your system - to either define or augment your $LD_LIBRARY_PATH environment variable, or alter the /etc/ld.so.conf (or add a file in /etc/ld.so.conf.d) and run (as root) ldconfig, so that Guile-CV finds its libguile-cv.* library files3.

  3. To install Guile-CV, you must have write permissions to the default or $(prefix) directory and its subdirs, as well as to both Guile’s site and site-ccache directories if --with-guile-site=yes was passed.

  4. Like for any other GNU Tool Chain compatible software, you may install the documentation locally using make install-info, make install-html and/or make install-pdf.

  5. Last but not least :), Guile-CV comes with a test-suite, which we recommend you to run (especially before Reporting Bugs):
    make check
    

Footnotes

(1)

We do our best to check that the libvigra_c installed library does contain the required Guile-CV functionalty though, and these checks are listed as part of our configure steps

(2)

In this case, you may as well decide to either alter your $HOME/.guile personal file, or, if you are working in a mult-user environmet, you may also opt for a global configuration. In this case, the file must be named init.scm and placed it here (evaluate the following expression in a terminal): guile -c "(display (%global-site-dir))(newline)".

(3)

Contact your administrator if you opt for the second solution but don’t have write priviledges on your system.


Next: , Previous: , Up: Introduction   [Contents][Index]