README

[![Build Status](https://travis-ci.org/RobertLuptonTheGood/eups.svg?branch=master)](https://travis-ci.org/RobertLuptonTheGood/eups)

# EUPS : A Unix Product Versioning System

A system similar to [environment modules](http://modules.sourceforge.net)
that allows for simple management of multiple versions of software on a UNIX
machine, as well as their dependencies.

Example usage:
```
source /path/to/eups/bin/setups.sh  # Initialize EUPS
setup lsst_distrib 11.0             # Add the LSST software stack v11 to the path
unsetup lsst_distrib                # Remove the currently set up LSST software stack
```

## Installing

```
./configure --prefix=/path/to/eups --with-eups=/path/to/managed/software/products
make
make install
```
where `/path/to/eups` is the directory where EUPS will be installed, while
`/path/to/managed/software/products` is the path where software managed by
EUPS will be installed. It is recommended that the latter is not a subpath
of the former.

## Manual
Details on using EUPS are given in the manual, `doc/eups.tex`. To produce
a readable copy, cd doc and say:
```
    latex eups.tex; dvips -f eups.dvi > eups.ps
```
or
```
    pdflatex eups.tex
```
**WARNING: The manual is significantly out of date; caveat reader!**

## Legal

Copyright (C) 2003-2018 Nikhil Padmanabhan and Robert Lupton
npadmana@princeton.edu and rhl@astro.princeton.edu

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

Note that this package is distributed free of cost, and the user is
free to update any/all parts of the code.  This is with the implicit
assumption that the original code will be acknowledged.