2015-11-16 17:39:53 -05:00
|
|
|
[![Build Status](https://travis-ci.org/aspiers/stow.svg)](https://travis-ci.org/aspiers/stow)
|
2015-11-16 20:50:27 -05:00
|
|
|
[![Coverage Status](https://coveralls.io/repos/aspiers/stow/badge.svg?branch=master&service=github)](https://coveralls.io/github/aspiers/stow?branch=master)
|
2015-11-16 17:39:53 -05:00
|
|
|
|
2012-03-01 06:40:34 -05:00
|
|
|
README for GNU Stow
|
|
|
|
===================
|
|
|
|
|
|
|
|
This is GNU Stow, a symlink farm manager program which takes distinct
|
|
|
|
packages of software and/or data located in separate directories on
|
|
|
|
the filesystem, and makes them appear to be installed in the same
|
2015-11-16 17:12:02 -05:00
|
|
|
place. For example, `/usr/local/bin` could contain symlinks to files
|
|
|
|
within `/usr/local/stow/emacs/bin`, `/usr/local/stow/perl/bin` etc., and
|
|
|
|
likewise recursively for any other subdirectories such as `.../share`,
|
|
|
|
`.../man`, and so on.
|
2012-03-01 06:40:34 -05:00
|
|
|
|
|
|
|
This is particularly useful for keeping track of system-wide and
|
|
|
|
per-user installations of software built from source, but can also
|
|
|
|
facilitate a more controlled approach to management of configuration
|
|
|
|
files in the user's home directory, especially when coupled with
|
|
|
|
version control systems.
|
|
|
|
|
|
|
|
Stow is implemented as a combination of a Perl script providing a CLI
|
|
|
|
interface, and a backend Perl module which does most of the work.
|
|
|
|
|
|
|
|
You can get the latest information about Stow from the home page:
|
|
|
|
|
|
|
|
http://www.gnu.org/software/stow/
|
|
|
|
|
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
|
|
|
Stow is free software, licensed under the GNU General Public License,
|
2015-11-16 17:12:02 -05:00
|
|
|
which can be found in the file [`COPYING`](COPYING).
|
2012-03-01 06:40:34 -05:00
|
|
|
|
|
|
|
Installation
|
|
|
|
------------
|
2001-12-24 09:57:46 -05:00
|
|
|
|
2015-11-16 17:21:44 -05:00
|
|
|
See [`INSTALL.md`](INSTALL.md) for installation instructions.
|
2001-12-24 09:57:46 -05:00
|
|
|
|
2012-03-01 06:40:34 -05:00
|
|
|
Feedback
|
|
|
|
--------
|
2001-12-24 09:57:46 -05:00
|
|
|
|
2012-03-01 06:40:34 -05:00
|
|
|
Please do send comments, questions, and constructive criticism. The
|
|
|
|
mailing lists and any other communication channels are detailed on the
|
|
|
|
above home page.
|
2001-12-24 09:57:46 -05:00
|
|
|
|
2012-03-01 06:40:34 -05:00
|
|
|
Brief history
|
|
|
|
-------------
|
2001-12-24 09:57:46 -05:00
|
|
|
|
2012-03-01 06:40:34 -05:00
|
|
|
Stow was inspired by Carnegie Mellon's "Depot" program, but is
|
|
|
|
substantially simpler. Whereas Depot requires database files to keep
|
|
|
|
things in sync, Stow stores no extra state between runs, so there's no
|
|
|
|
danger (as there is in Depot) of mangling directories when file
|
|
|
|
hierarchies don't match the database. Also unlike Depot, Stow will
|
|
|
|
never delete any files, directories, or links that appear in a Stow
|
2015-11-16 17:12:02 -05:00
|
|
|
directory (e.g., `/usr/local/stow/emacs`), so it's always possible to
|
|
|
|
rebuild the target tree (e.g., `/usr/local`).
|