00dani/stow
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity
256 commits 1 branch 21 tags 1.3 MiB
Perl 89.7%
Makefile 5.6%
Shell 2.2%
M4 1.6%
Dockerfile 0.9%
Go to file
Charles LeDoux 95ffbc5ebd Add docker files for local testing. 
* Use docker to locally run tests on multiple perl versions
    * perlbrew used to install multiple perls
    * perl environments bootstrapped when image built
* Based on travis configuration
* Adds docker folder to MANIFEST.SKIP
* Running image runs all tests.
    * If exit with no error, then all tests pass.
* ./build-docker.sh builds stow testing image.
* ./test-docker.sh runs stow testing image.
    * Assumes built with options in build-docker.sh
* *-docker.sh scripts added to MANIFEST.SKIP
2016-05-18 17:31:04 -05:00
automake remove automake files 2015-02-07 19:30:26 +00:00
bin Allow directory with trailing and leading spaces 2015-11-13 20:17:58 +07:00
doc HOWTO-RELEASE: remove body indent 2015-11-09 11:05:20 +00:00
docker Add docker files for local testing. 2016-05-18 17:31:04 -05:00
lib add Stow/Util.pm.in with @VERSION@ substitution 2015-11-09 12:36:51 +00:00
t fixed testutil to support cygwin which reports -z = true on directories 2016-02-28 13:39:03 +00:00
.gitignore add Stow/Util.pm.in with @VERSION@ substitution 2015-11-09 12:36:51 +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 Add docker files for local testing. 2016-05-18 17:31:04 -05:00
Build.PL add IO::Scalar to build_requires 2015-11-13 12:05:42 +00:00
configure.ac fix breakage caused by converting files to Markdown 2015-11-16 22:35:56 +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 another attempt to fix automake config 2015-11-17 17:27:39 +00:00
MANIFEST fix breakage caused by converting files to Markdown 2015-11-16 22:35:56 +00:00
MANIFEST.SKIP Add docker files for local testing. 2016-05-18 17:31:04 -05:00
META.json add IO::Scalar to build_requires 2015-11-13 12:05:42 +00:00
META.yml add IO::Scalar to build_requires 2015-11-13 12:05:42 +00:00
NEWS NEWS: Explain why 2.2.1 was not released 2015-11-09 12:36:51 +00:00
README.md add coveralls badge 2015-11-17 01:50:27 +00:00
test-docker.sh Add docker files for local testing. 2016-05-18 17:31:04 -05:00
THANKS Correctly handle empty STOW_DIR (#5, #6) 2015-11-11 11:28:47 +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).