No description
Find a file
Danielle McLean 08d7a9f7af Release 2.4.0
-----BEGIN PGP SIGNATURE-----
 
 iQIzBAABCAAdFiEElCuQdazKBOkDfHP+0xtVY9rB1PoFAmYS3jkACgkQ0xtVY9rB
 1PqSxBAAvPPMSrrxdfGAL9anzCDZArRrtplbS1493fj+OiNIjDWSGsJwm1mZX1ny
 i04te8Hne/ppZs/CrYAe0PZGl6LowswBKFuHkft//f9maeXG/zl+Uh4E7dYWhXik
 N0+9cgh/ngKJ5QgQelfNxZGrHTZZmbbnNfrtuMPqGIDGIDSzNw2qlqdFzp9VxRth
 /dbLLAHoRXY2uRhSgSnEhnk+zJyxR9od5tU3p094xyUEhbBkNRzCE4TwA9oGvyFQ
 N6onEo4wj5w8Mqtu5p6BY5IktYIgechJxF86Sqy27UU/uNQyzeaG2Qs+diwScpop
 9eOsEUDY5mi7oLs4KME0SGqF/V54Spv+QDGks7bftvSQf3WQvFWX+w1fYymbtctD
 US1caKlsleODnQGmyXEBPyNwGmsLmbaF03yIW1BtLfibDxKeDXK0e2zznpBHRRGO
 2klSjH+qd2hqDT3eYNP8SLpRPUdWiuHP2fb1LV+VzjO7vR4iPLdjvTddFEsm7u2M
 IknSXtxCzJuBD4Dz9fZ/fbVEp+2wYmbtKgqmcnKSNtZ5GaFrmA96mekAbyVWYwdB
 IHuscAWlZSCwJJVPp3VMVGVdXfbYhLJRC+Ft6QAzJeJZ2Q44dxnmPDLQHpngNXWJ
 3YhZ62j5C0wInTh0NzUiDbGkxHwY1v4xJC4OXrR6k8+qqPOe1J4=
 =SC3E
 -----END PGP SIGNATURE-----
gpgsig -----BEGIN PGP SIGNATURE-----
 
 iQIzBAABCAAdFiEEdnljh8gT62W19LaLaFR4GgSIQhwFAmZdM3cACgkQaFR4GgSI
 Qhx/GA/7BbccrVBYNEnu1TJ9riozvN0k1AO6LE96R7QJQH+hpVcM+al4uIc2+GXA
 gcgoVtdADv7nD3DMtQsJlPxQsS+RFjaipZy3kdLSZyU3EixK/Zy2GtK0zjYLMlI/
 rGEEkPx0um3MBm/gtvfZ/pK9i9v2Au61jn49+z4moPnfc4Gk6ZlRXtggDP4ApHPp
 uHeQmr34AZ+dAcc+cs7bCuZvzxxv97WNB7dfFA8RR3+5cQzkbw+Fjjp4GT1J6ifA
 pn4znVZCdb4HhqjFoQzRi68x61MVdhEq4309Mm8xGi7fTqWgxoRPZjKmgpLUF0Wp
 rUNpmd+whNiebMhi0G1yYl1+Pf0x5Thoa7x66M6YWrSMwbr5KJuU3XFNQAr787ls
 pN3nXimX3jw1Mrp8QP4WQby563jHqG4yzBNn+qX22xXxhZOctDJFUDmGZMHHRD5D
 +GICfmgCEp1Ph/YlP4x34jnC4phoIKRs1pUQuIKZM9ECN5Pg6spbT5BmuOn2AhtF
 dLgdSfXAEhnfhxNzf+uvHgelgeeXpTTZEJbX63XoZelK337f1n9CL4Cbumm3JCNS
 YcgJV5L/lw7jRHcaSnyKY37b6iw5+vOdr5yibgJN1LlCGVEbHdpBOPoFZkBA1cTM
 TouP87RHfb47yu+W8WYnBZ+Tr9M6h1S7gfTJ+qjJf244wWaYLO8=
 =Q/B6
 -----END PGP SIGNATURE-----

Pull in upstream Stow 2.4.0
2024-06-03 13:07:34 +10:00
.github/workflows Port Travis CI workflow to a GitHub CI workflow 2024-04-05 01:52:42 +01:00
automake Ditch texinfo.tex from distribution 2021-04-15 15:11:29 +01:00
bin stow: remove misleading comment about current dir 2024-04-07 18:00:03 +01:00
doc HOWTO-RELEASE: THANKS is no longer being updated 2024-04-07 18:34:35 +01:00
docker Fix Dockerfile by updating from jessie to bookworm 2024-04-07 13:50:09 +01:00
lib Fix unstowing with --compat --dotfiles 2024-04-07 17:21:44 +01:00
t t/unstow.t: move final set of tests into a subtest 2024-04-07 17:44:44 +01:00
tools Change -w to "use warnings;" in tools/get-version 2019-06-27 20:39:16 +01:00
.coveralls.yml Port Travis CI workflow to a GitHub CI workflow 2024-04-05 01:52:42 +01:00
.dir-locals.el emacs: tweak more cperl indentation config to match existing style 2024-04-01 22:39:32 +01:00
.dumbjump Add support for emacs dumb-jump 2021-04-15 15:11:30 +01:00
.gitignore merge unstow_orig.t into unstow.t and fix unstowing logic 2024-04-07 15:47:38 +01:00
.travis.yml Allow make to fail if missing modules for test dependencies 2019-06-28 20:28:22 +01:00
aclocal.m4 Release 2.4.0 2024-06-03 13:07:34 +10:00
AUTHORS AUTHORS: mention THANKS file 2021-04-15 15:11:30 +01:00
build-docker.sh Make docker scripts use get-version 2019-06-28 17:08:48 +01:00
Build.PL Remove dependencies on Hash::Merge and Clone::Choose 2019-06-29 13:42:19 +01:00
configure.ac Release 2.4.0 2024-06-03 13:07:34 +10:00
CONTRIBUTING.md Add details on how to view coverage locally 2024-04-07 18:22:56 +01:00
COPYING Upgrade to GPL v3 and add headers to files (#44) 2019-06-27 20:37:40 +01:00
default-ignore-list Add .gitmodules to the default ignore list 2022-08-12 20:43:56 -07:00
INSTALL.md Upgrade to GPL v3 and add headers to files (#44) 2019-06-27 20:37:40 +01:00
Makefile.am Release 2.4.0 2024-06-03 13:07:34 +10:00
MANIFEST merge unstow_orig.t into unstow.t and fix unstowing logic 2024-04-07 15:47:38 +01:00
MANIFEST.SKIP merge unstow_orig.t into unstow.t and fix unstowing logic 2024-04-07 15:47:38 +01:00
META.json Rebuild META.* 2024-04-07 18:38:12 +01:00
META.yml Rebuild META.* 2024-04-07 18:38:12 +01:00
NEWS Update NEWS for v2.4.0 2024-04-07 18:32:51 +01:00
README.md Beef up README.md and add CONTRIBUTING.md 2021-04-15 15:11:30 +01:00
test-docker.sh Make testing within Docker containers easier 2019-06-28 20:36:38 +01:00
THANKS cli.t: test with the right Perl executable 2019-07-15 16:12:26 -04:00
TODO Replace broken gmane links with links to lists.gnu.org 2021-04-15 15:11:29 +01:00

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/

Installation

See INSTALL.md for installation instructions.

Documentation

Documentation for Stow is available online, as is documentation for most GNU software. Once you have Stow installed, you may also find more information about Stow by running info stow or man stow, or by looking at /usr/share/doc/stow/, /usr/local/doc/stow/, or similar directories on your system. A brief summary is available by running stow --help.

Mailing lists

Stow has the following mailing lists:

  • help-stow is for general user help and discussion.
  • stow-devel is used to discuss most aspects of Stow, including development and enhancement requests.
  • bug-stow is for bug reports.

Announcements about Stow are posted to info-stow and also, as with most other GNU software, to info-gnu (archive).

Security reports that should not be made immediately public can be sent directly to the maintainer. If there is no response to an urgent issue, you can escalate to the general security mailing list for advice.

The Savannah project also has a mailing lists page.

Getting involved

Please see the CONTRIBUTING.md file.

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.

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.