Нет описания

Hugo Sales fe85454971 Add --dotfiles to usage output 4 лет назад
automake 3a7cf35165 remove automake files 10 лет назад
bin fe85454971 Add --dotfiles to usage output 4 лет назад
doc 9fd3624a75 HOWTO-RELEASE: explicitly push to master 5 лет назад
docker 8b2123847d Split perlbrew install-multiple into separate RUN cmd 5 лет назад
lib f2c89596ae Allow unstowing absolute path links if given -a option 4 лет назад
t b6ee2d10d6 cli.t: test with the right Perl executable 5 лет назад
tools 157f39385a Change -w to "use warnings;" in tools/get-version 5 лет назад
.gitignore 22ca973d59 Switch to makeinfo --html --no-split for single-page HTML manual (#21) 5 лет назад
.travis.yml ba243c0a61 Allow make to fail if missing modules for test dependencies 5 лет назад
AUTHORS 311c2d139e Improve the history of individual contributions and repositories 5 лет назад
Build.PL 9ce10eb3b1 Remove dependencies on Hash::Merge and Clone::Choose 5 лет назад
COPYING 27796720d5 Upgrade to GPL v3 and add headers to files (#44) 5 лет назад
INSTALL.md 27796720d5 Upgrade to GPL v3 and add headers to files (#44) 5 лет назад
MANIFEST 8b0733a8a0 add tools/get-version to MANIFEST 5 лет назад
MANIFEST.SKIP 22ca973d59 Switch to makeinfo --html --no-split for single-page HTML manual (#21) 5 лет назад
META.json d94f325e51 Bump version to 2.3.2 for development of next release 5 лет назад
META.yml d94f325e51 Bump version to 2.3.2 for development of next release 5 лет назад
Makefile.am 8d0a46cc88 Set DISTCLEANFILES to clean up more 5 лет назад
NEWS 59658a6c4e NEWS: disable org-export-with-toc 5 лет назад
README.md fea63ffe65 Improve the history of individual contributions and repositories (#49) 5 лет назад
THANKS b6ee2d10d6 cli.t: test with the right Perl executable 5 лет назад
TODO 27796720d5 Upgrade to GPL v3 and add headers to files (#44) 5 лет назад
aclocal.m4 e2af22c11a update aclocal.m4 using aclocal 1.15.1 6 лет назад
build-docker.sh ee57b1abc6 Make docker scripts use get-version 5 лет назад
configure.ac d94f325e51 Bump version to 2.3.2 for development of next release 5 лет назад
default-ignore-list fe5b658803 default-ignore-list: ignore top-level README.*, LICENSE.*, and COPYING 11 лет назад
test-docker.sh 5d667c3e71 Make testing within Docker containers easier 5 лет назад

README.md

Build Status Coverage Status

README for GNU Stow

This README describes GNU Stow. This is not the definitive documentation for Stow; for that, see the info manual.

Stow is a symlink farm manager program which takes distinct sets of software and/or data located in separate directories on the filesystem, and makes them all appear to be installed in a single directory tree.

Originally Stow was born to address the need to administer, upgrade, install, and remove files in independent software packages without confusing them with other files sharing the same file system space. For instance, many years ago it used to be common to compile programs such as Perl and Emacs from source and install them in /usr/local. By using Stow, /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.

While this is useful for keeping track of system-wide and per-user installations of software built from source, in more recent times software packages are often managed by more sophisticated package management software such as rpm, dpkg, and Nix / GNU Guix, or language-native package managers such as Ruby's gem, Python's pip, Javascript's npm, and so on.

However Stow is still used not only for software package management, but also for other purposes, such as facilitating a more controlled approach to management of configuration files in the user's home directory, especially when coupled with version control systems.

Stow was inspired by Carnegie Mellon's Depot program, but is substantially simpler and safer. Whereas Depot required database files to keep things in sync, Stow stores no extra state between runs, so there's no danger (as there was 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).

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.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.

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 and authorship

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

For a high-level overview of the contributions of the main developers over the years, see the AUTHORS file.

For a more detailed history, please see the ChangeLog file.