.\" Copyright 2007-2013 Gentoo Foundation
.\" Distributed under the terms of the GNU General Public License v2
.\" $Id: $
.\"
.TH guile.eselect 5 "August 2015" "Gentoo Linux" eselect
.SH NAME
guile.eselect \- The Guile management module for Gentoo's eselect
.SH SYNOPSIS
.B eselect guile
.RB [ help | usage | version ]
.br
.B eselect guile list
.br
.B eselect guile set
.I version
.br
.B eselect guile show
.br
.B eselect guile unset
.br
.B eselect guile update
.RB [ --if-unset ]
.SH DESCRIPTION
.B eselect
is Gentoo's configuration and management tool. It features modules
that care for the individual administrative tasks.
.SH ACTION: LIST
.B eselect guile list
.br
List all installed Guile versions

# eselect guile list
.br
Available versions of Guile:
.br
  [1]   guile-1.8
  [2]   guile-2 *
  [3]   guile-2.2
.SH ACTION: SET
.B eselect guile set
.I version
.br
Activate the selected Guile version.
.I version
can be either an identification number given by
.B eselect guile list
or the name of one installed version.
.\" To avoid runtime issues with
.\" incompatible byte-code from the previously selected Emacs version, run
.\" .B emacs-updater -a rebuild
.\" to remerge all needed packages.
.\" FIXME:
.\" FIXME: A real fix for this would be to separate the Emacs ebuild.
.\" FIXME:

# eselect guile set 1
.br
Switching version of Guile to guile-1.8 ...
.SH ACTION: SHOW
.B eselect guile show
.br
Print the currently activated version of Guile.

# eselect guile show
.br
Current version of Guile:
.br
  emacs-1.8
.SH ACTION: UNSET
.B eselect guile unset
.br
Unset the current version of Guile. This action removes all symlinks
and files created by
.B eselect guile set
or
.B eselect guile update
actions.

# eselect guile unset
.br
Unsetting the current version of Guile ...
.SH ACTION: UPDATE
.B eselect guile update
.RB [ --if-unset ]
.br
Update the version of Guile to the last available version. If option
.B --if-unset
is given, a previously set version is not overridden.

The update process consists in creating symlinks for guile's binaries,
man page and aclocal.m4. It also generates an environment file.
The symlinks concerns:
.br
* /usr/bin/guil[de] and /usr/bin/guile-{config,snarf,tools} binaries;
.br
* /usr/share/aclocal/guile.m4;
.br
* guile(1) man page.
.br
The environment file (/etc/env.d/50guile) defines INFOPATH.
.\" and GUILE_LOAD_PATH.

# eselect guile update
.br
Switching version of Guile to guile-2.0 ...
.SH AUTHORS
Barry Schwartz <sortsmill@crudfactory.com>
.br
This man page is based on the eselect-emacs man-page, whose authors are
.br
Christian Faulhammer <fauli@gentoo.org>
.br
Ulrich Mueller <ulm@gentoo.org>
.br
and on the app-admin/eselect-guile::lisp man-page, whose author is
.br
Cyprien Nicolas <cyp@fulax.fr>
.SH SEE ALSO
.BR eselect (1)
.\" .SH REVISION
.\" $Id$