00dani/stow
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
274 commits 1 branch 21 tags 1.3 MiB
Perl 89.7%
Makefile 5.6%
Shell 2.2%
M4 1.6%
Dockerfile 0.9%
Find a file
Adam Spiers 8d738353f8 fix documentation for --verbose 
It actually goes up to 5 these days.  Thanks to Kristoffer Haugsbakk
for spotting that:

  http://lists.gnu.org/archive/html/bug-stow/2016-08/msg00000.html
2016-12-18 23:11:23 +00:00
automake remove automake files 2015-02-07 19:30:26 +00:00
bin fix documentation for --verbose 2016-12-18 23:11:23 +00:00
doc HOWTO-RELEASE: use Docker to test before releasing 2016-11-20 22:57:39 +00:00
docker whitespace cleanups 2016-11-20 22:20:46 +00:00
lib Merge pull request #17 from jvkersch/enh/dot-files 2016-10-05 17:47:51 +01:00
t Special processing for dotfiles 2016-10-04 17:51:01 +01:00
.gitignore ignore cover_db generated by Coveralls 2016-11-20 22:57:39 +00:00
.travis.yml add coveralls 2015-11-17 01:43:38 +00:00
aclocal.m4 update aclocal 2014-09-22 00:14:56 +01:00
AUTHORS Add a missing space. 2011-12-03 17:09:48 +00:00
build-docker.sh tag Docker images with the corresponding version number 2016-11-20 22:50:22 +00:00
Build.PL add IO::Scalar to build_requires 2015-11-13 12:05:42 +00:00
configure.ac Bump version to 2.3.0 2016-11-20 22:57:39 +00:00
COPYING Grafted root commit from savannah git master: 2011-11-16 14:04:03 +00:00
default-ignore-list default-ignore-list: ignore top-level README.*, LICENSE.*, and COPYING 2013-04-12 17:42:14 +01:00
INSTALL.md convert INSTALL to Markdown 2015-11-16 22:22:01 +00:00
Makefile.am fix naming of man page 2016-09-20 18:33:07 +01:00
MANIFEST Special processing for dotfiles 2016-10-04 17:51:01 +01:00
MANIFEST.SKIP Add docker files for local testing. 2016-05-18 17:31:04 -05:00
META.json Bump version to 2.3.0 2016-11-20 22:57:39 +00:00
META.yml Bump version to 2.3.0 2016-11-20 22:57:39 +00:00
NEWS Prepare NEWS file for 2.3.0 release 2016-11-20 22:57:39 +00:00
README.md add coveralls badge 2015-11-17 01:50:27 +00:00
test-docker.sh tag Docker images with the corresponding version number 2016-11-20 22:50:22 +00:00
THANKS fix documentation for --verbose 2016-12-18 23:11:23 +00:00
TODO add TODO for install-hooks 2013-04-24 08:46:52 +01:00

README.md

Build Status Coverage Status

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 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.

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, which can be found in the file COPYING.

Installation

See INSTALL.md for installation instructions.

Feedback

Please do send comments, questions, and constructive criticism. The mailing lists and any other communication channels are detailed on the above home page.

Brief history

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 directory (e.g., /usr/local/stow/emacs), so it's always possible to rebuild the target tree (e.g., /usr/local).