00dani/stow
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
257 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 7ede3c8df0 fix naming of man page 
The title of the generated man page was ending up as something like

  IO::FILE=IO(0XA719C0)(1)

Also, with newer perls (e.g. v5.22.1), pod2man requires --name if
used within a pipeline.

Closes #18.

https://github.com/aspiers/stow/issues/18
2016-09-20 18:33:07 +01: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
lib remove superfluous space in function call 2016-08-23 10:37:12 +01: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.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 fix naming of man page 2016-09-20 18:33:07 +01:00
MANIFEST fix breakage caused by converting files to Markdown 2015-11-16 22:35:56 +00:00
MANIFEST.SKIP add .travis.yml to MANIFEST.SKIP 2015-11-17 01:35:47 +00: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
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).