Rebuild based on upstream Stow 2.4.0

This commit is contained in:
Danielle McLean 2024-06-03 13:08:10 +10:00
parent be6413057e
commit 91c35521c9
Signed by: 00dani
GPG key ID: 6854781A0488421C
39 changed files with 1968 additions and 1231 deletions

View file

@ -123,6 +123,5 @@ sub list {
# Local variables:
# mode: perl
# cperl-indent-level: 4
# End:
# vim: ft=perl

View file

@ -31,7 +31,7 @@ stow [ options ] package ...
=head1 DESCRIPTION
This manual page describes GNU Stow 2.3.2-fixbug56727. This is not the
This manual page describes GNU Stow 2.4.0. This is not the
definitive documentation for Stow; for that, see the accompanying info
manual, e.g. by typing C<info stow>.
@ -474,7 +474,6 @@ sub main {
my ($options, $pkgs_to_unstow, $pkgs_to_stow) = process_options();
my $stow = new Stow(%$options);
# current dir is now the target directory
$stow->plan_unstow(@$pkgs_to_unstow);
$stow->plan_stow (@$pkgs_to_stow);
@ -849,6 +848,5 @@ sub version {
# Local variables:
# mode: perl
# cperl-indent-level: 4
# end:
# vim: ft=perl

File diff suppressed because it is too large Load diff

View file

@ -32,16 +32,18 @@ Supporting utility routines for L<Stow>.
use strict;
use warnings;
use File::Spec;
use POSIX qw(getcwd);
use base qw(Exporter);
our @EXPORT_OK = qw(
error debug set_debug_level set_test_mode
join_paths parent canon_path restore_cwd adjust_dotfile
join_paths parent canon_path restore_cwd
adjust_dotfile unadjust_dotfile
);
our $ProgramName = 'stow';
our $VERSION = '2.3.2-fixbug56727';
our $VERSION = '2.4.0';
#############################################################################
#
@ -93,7 +95,7 @@ sub set_test_mode {
}
}
=head2 debug($level, $msg)
=head2 debug($level[, $indent_level], $msg)
Logs to STDERR based on C<$debug_level> setting. C<$level> is the
minimum verbosity level required to output C<$msg>. All output is to
@ -125,13 +127,18 @@ overriding, fixing invalid links
=cut
sub debug {
my ($level, $msg) = @_;
my $level = shift;
my $indent_level;
# Maintain backwards-compatibility in case anyone's relying on this.
$indent_level = $_[0] =~ /^\d+$/ ? shift : 0;
my $msg = shift;
if ($debug_level >= $level) {
my $indent = ' ' x $indent_level;
if ($test_mode) {
print "# $msg\n";
print "# $indent$msg\n";
}
else {
warn "$msg\n";
warn "$indent$msg\n";
}
}
}
@ -142,29 +149,53 @@ sub debug {
# Parameters: path1, path2, ... => paths
# Returns : concatenation of given paths
# Throws : n/a
# Comments : factors out redundant path elements:
# : '//' => '/' and 'a/b/../c' => 'a/c'
# Comments : Factors out some redundant path elements:
# : '//' => '/', and 'a/b/../c' => 'a/c'. We need this function
# : with this behaviour, even though b could be a symlink to
# : elsewhere, as noted in the perldoc for File::Spec->canonpath().
# : This behaviour is deliberately different to
# : Stow::Util::canon_path(), because the way join_paths() is used
# : relies on this. Firstly, there is no guarantee that the paths
# : exist, so a filesystem check is inappropriate.
# :
# : For example, it's used to determine the path from the target
# : directory to a symlink destination. So if a symlink
# : path/to/target/a/b/c points to ../../../stow/pkg/a/b/c,
# : then joining path/to/target/a/b with ../../../stow/pkg/a/b/c
# : yields path/to/stow/pkg/a/b/c, and it's crucial that the
# : path/to/stow prefix matches a recognisable stow directory.
#============================================================================
sub join_paths {
my @paths = @_;
# weed out empty components and concatenate
my $result = join '/', grep {! /\A\z/} @paths;
debug(5, 5, "| Joining: @paths");
my $result = '';
for my $part (@paths) {
next if ! length $part; # probably shouldn't happen?
$part = File::Spec->canonpath($part);
# factor out back references and remove redundant /'s)
my @result = ();
PART:
for my $part (split m{/+}, $result) {
next PART if $part eq '.';
if (@result && $part eq '..' && $result[-1] ne '..') {
pop @result;
if (substr($part, 0, 1) eq '/') {
$result = $part; # absolute path, so ignore all previous parts
}
else {
push @result, $part;
$result .= '/' if length $result && $result ne '/';
$result .= $part;
}
debug(7, 6, "| Join now: $result");
}
debug(6, 5, "| Joined: $result");
return join '/', @result;
# Need this to remove any initial ./
$result = File::Spec->canonpath($result);
# remove foo/..
1 while $result =~ s,(^|/)(?!\.\.)[^/]+/\.\.(/|$),$1,;
debug(6, 5, "| After .. removal: $result");
$result = File::Spec->canonpath($result);
debug(5, 5, "| Final join: $result");
return $result;
}
#===== METHOD ===============================================================
@ -209,17 +240,17 @@ sub restore_cwd {
}
sub adjust_dotfile {
my ($target) = @_;
my ($pkg_node) = @_;
(my $adjusted = $pkg_node) =~ s/^dot-([^.])/.$1/;
return $adjusted;
}
my @result = ();
for my $part (split m{/+}, $target) {
if (($part ne "dot-") && ($part ne "dot-.")) {
$part =~ s/^dot-/./;
}
push @result, $part;
}
return join '/', @result;
# Needed when unstowing with --compat and --dotfiles
sub unadjust_dotfile {
my ($target_node) = @_;
return $target_node if $target_node =~ /^\.\.?$/;
(my $adjusted = $target_node) =~ s/^\./dot-/;
return $adjusted;
}
=head1 BUGS
@ -232,6 +263,5 @@ sub adjust_dotfile {
# Local variables:
# mode: perl
# cperl-indent-level: 4
# end:
# vim: ft=perl

View file

@ -60,6 +60,56 @@ You can get the latest information about Stow from the home page:
http://www.gnu.org/software/stow/
Installation
------------
See [`INSTALL.md`](INSTALL.md) for installation instructions.
Documentation
-------------
Documentation for Stow is available
[online](https://www.gnu.org/software/stow/manual/), as is
[documentation for most GNU
software](https://www.gnu.org/software/manual/). 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](https://lists.gnu.org/mailman/listinfo/help-stow) is for
general user help and discussion.
- [stow-devel](https://lists.gnu.org/mailman/listinfo/stow-devel) is
used to discuss most aspects of Stow, including development and
enhancement requests.
- [bug-stow](https://lists.gnu.org/mailman/listinfo/bug-stow) is for
bug reports.
Announcements about Stow are posted to
[info-stow](http://lists.gnu.org/mailman/listinfo/info-stow) and also,
as with most other GNU software, to
[info-gnu](http://lists.gnu.org/mailman/listinfo/info-gnu)
([archive](http://lists.gnu.org/archive/html/info-gnu/)).
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](http://lists.gnu.org/mailman/listinfo/security) mailing
list for advice.
The Savannah project also has a [mailing
lists](https://savannah.gnu.org/mail/?group=stow) page.
Getting involved
----------------
Please see the [`CONTRIBUTING.md` file](CONTRIBUTING.md).
License
-------
@ -71,18 +121,6 @@ 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`](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
----------------------------

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -84,7 +84,7 @@ ul.toc-numbered-mark {list-style: none}
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a class="top" id="SEC_Top"></a>
<p>This manual describes GNU Stow 2.3.2-fixbug56727 (2 November 2023), a
<p>This manual describes GNU Stow 2.4.0 (3 June 2024), a
symlink farm manager which takes distinct sets of software and/or data
located in separate directories on the filesystem, and makes them
appear to be installed in a single directory tree.
@ -124,7 +124,7 @@ appear to be installed in a single directory tree.
<li><a id="toc-Multiple-Stow-Directories-1" href="#Multiple-Stow-Directories">9 Multiple Stow Directories</a></li>
<li><a id="toc-Target-Maintenance-1" href="#Target-Maintenance">10 Target Maintenance</a></li>
<li><a id="toc-Resource-Files-1" href="#Resource-Files">11 Resource Files</a></li>
<li><a id="toc-Compile_002dtime-vs-Install_002dtime-1" href="#Compile_002dtime-vs-Install_002dtime">12 Compile-time vs Install-time</a>
<li><a id="toc-Compile_002dtime-vs_002e-Install_002dtime-1" href="#Compile_002dtime-vs_002e-Install_002dtime">12 Compile-time vs. Install-time</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Advice-on-changing-compilation-and-installation-parameters" href="#Advice-on-changing-compilation-and-installation-parameters">12.1 Advice on changing compilation and installation parameters</a></li>
<li><a id="toc-GNU-Emacs-1" href="#GNU-Emacs">12.2 GNU Emacs</a></li>
@ -240,9 +240,12 @@ to be installed in a particular directory structure &mdash; e.g., with
</p>
<a class="index-entry-id" id="index-target-directory"></a>
<p>A <em class="dfn">target directory</em> is the root of a tree in which one or more
packages wish to <em class="emph">appear</em> to be installed. A common, but by no
means the only such location is <samp class="file">/usr/local</samp>. The examples in this
manual will use <samp class="file">/usr/local</samp> as the target directory.
packages wish to <em class="emph">appear</em> to be installed. <samp class="file">/usr/local</samp> is a
common choice for this, but by no means the only such location. Another
common choice is <samp class="file">~</samp> (i.e. the user&rsquo;s <code class="code">$HOME</code> directory) in
the case where Stow is being used to manage the user&rsquo;s configuration
(&ldquo;dotfiles&rdquo;) and other files in their <code class="code">$HOME</code>. The examples in
this manual will use <samp class="file">/usr/local</samp> as the target directory.
</p>
<a class="index-entry-id" id="index-stow-directory"></a>
<p>A <em class="dfn">stow directory</em> is the root of a tree containing separate
@ -260,6 +263,11 @@ installation image for Perl includes: a <samp class="file">bin</samp> directory
containing Texinfo documentation; a <samp class="file">lib/perl</samp> directory containing
Perl libraries; and a <samp class="file">man/man1</samp> directory containing man pages.
</p>
<blockquote class="quotation">
<p><b class="b">Note:</b> This is a <em class="emph">pre-</em>installation image which exists even before Stow
has installed any symlinks into the target directory which point to it.
</p></blockquote>
<a class="index-entry-id" id="index-package-directory"></a>
<a class="index-entry-id" id="index-package-name"></a>
<p>A <em class="dfn">package directory</em> is the root of a tree containing the
@ -275,16 +283,62 @@ target directory, <samp class="file">/usr/local/stow</samp> is the stow director
<samp class="file">/usr/local/stow/perl</samp> is the package directory, and
<samp class="file">bin/perl</samp> within is part of the installation image.
</p>
<a class="index-entry-id" id="index-symlink"></a>
<a class="anchor" id="symlink"></a><a class="index-entry-id" id="index-symlink"></a>
<a class="index-entry-id" id="index-symlink-source"></a>
<a class="index-entry-id" id="index-symlink-destination"></a>
<a class="index-entry-id" id="index-relative-symlink"></a>
<a class="index-entry-id" id="index-absolute-symlink"></a>
<p>A <em class="dfn">symlink</em> is a symbolic link. A symlink can be <em class="dfn">relative</em> or
<em class="dfn">absolute</em>. An absolute symlink names a full path; that is, one
starting from <samp class="file">/</samp>. A relative symlink names a relative path; that
is, one not starting from <samp class="file">/</samp>. The target of a relative symlink is
computed starting from the symlink&rsquo;s own directory. Stow only
creates relative symlinks.
<p>A <em class="dfn">symlink</em> is a symbolic link, i.e. an entry on the filesystem
whose path is sometimes called the <em class="dfn">symlink source</em>, which points to
another location on the filesystem called the <em class="dfn">symlink destination</em>.
There is no guarantee that the destination actually exists.
</p>
<p>In general, symlinks can be <em class="dfn">relative</em> or <em class="dfn">absolute</em>. A symlink
is absolute when the destination names a full path; that is, one
starting from <samp class="file">/</samp>. A symlink is relative when the destination
names a relative path; that is, one not starting from <samp class="file">/</samp>. The
destination of a relative symlink is computed starting from the
symlink&rsquo;s own directory, i.e. the directory containing the symlink
source.
</p>
<blockquote class="quotation">
<p><b class="b">Note:</b> Stow only creates symlinks within the target directory which point to
locations <em class="emph">outside</em> the target directory and inside the stow
directory.
</p>
<p>Consequently, we avoid referring to symlink destinations as symlink
<em class="emph">targets</em>, since this would result in the word &ldquo;target&rdquo; having
two different meanings:
</p>
<ol class="enumerate">
<li> the target directory, i.e. the directory into which Stow targets
installation, where symlinks are managed by Stow, and
</li><li> the destinations of those symlinks.
</li></ol>
<p>If we did not avoid the second meaning of &ldquo;target&rdquo;, then it would lead
to confusing language, such as describing Stow as installing symlinks
into the target directory which point to targets <em class="emph">outside</em> the
target directory.
</p>
<p>Similarly, the word &ldquo;source&rdquo; can have two different meanings in this
context:
</p>
<ol class="enumerate">
<li> the installation image, or some of its contents, and
</li><li> the location of symlinks (the &ldquo;source&rdquo; of the link, vs. its
destination).
</li></ol>
<p>Therefore it should also be avoided, or at least care taken to ensure
that the meaning is not ambiguous.
</p>
</blockquote>
<hr>
</div>
<div class="chapter-level-extent" id="Invoking-Stow">
@ -453,13 +507,15 @@ doing. Verbosity levels are from 0 to 5; 0 is the default. Using
</dd>
<dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt>
<dt>&lsquo;<samp class="samp">--compat</samp>&rsquo;</dt>
<dd><p>Scan the whole target tree when unstowing. By default, only
directories specified in the <em class="dfn">installation image</em> are scanned
during an unstow operation. Scanning the whole tree can be
prohibitive if your target tree is very large. This option restores
the legacy behaviour; however, the <samp class="option">--badlinks</samp> option to the
<code class="command">chkstow</code> utility may be a better way of ensuring that your
installation does not have any dangling symlinks (see <a class="pxref" href="#Target-Maintenance">Target Maintenance</a>).
<dd><p>Scan the whole target tree when unstowing. By default, only directories
specified in the <em class="dfn">installation image</em> are scanned during an unstow
operation. Previously Stow scanned the whole tree, which can be
prohibitive if your target tree is very large, but on the other hand has
the advantage of unstowing previously stowed links which are no longer
present in the installation image and therefore orphaned. This option
restores the legacy behaviour; however, the <samp class="option">--badlinks</samp> option
to the <code class="command">chkstow</code> utility may be a better way of ensuring that
your installation does not have any dangling symlinks (see <a class="pxref" href="#Target-Maintenance">Target Maintenance</a>).
</p>
</dd>
<dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt>
@ -587,6 +643,7 @@ _darcs
\.git
\.gitignore
\.gitmodules
.+~ # emacs backup files
\#.*\# # emacs autosave files
@ -903,7 +960,7 @@ version 21.3 to 21.4a you can now do the following:
invocations of stow, because redundant folding/unfolding operations
can be factored out. In addition, all the operations are calculated
and merged before being executed (see <a class="pxref" href="#Deferred-Operation">Deferred Operation</a>), so the
amount of of time in which GNU Emacs is unavailable is minimised.
amount of time in which GNU Emacs is unavailable is minimised.
</p>
<p>You can mix and match any number of actions, for example,
</p>
@ -997,7 +1054,7 @@ directory.
<div class="chapter-level-extent" id="Resource-Files">
<div class="nav-panel">
<p>
Next: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="n" rel="next">Compile-time vs Install-time</a>, Previous: <a href="#Target-Maintenance" accesskey="p" rel="prev">Target Maintenance</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="n" rel="next">Compile-time vs. Install-time</a>, Previous: <a href="#Target-Maintenance" accesskey="p" rel="prev">Target Maintenance</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Resource-Files-1"><span>11 Resource Files<a class="copiable-link" href="#Resource-Files-1"> &para;</a></span></h2>
<a class="index-entry-id" id="index-resource-files"></a>
@ -1066,12 +1123,12 @@ resource file.
</p>
<hr>
</div>
<div class="chapter-level-extent" id="Compile_002dtime-vs-Install_002dtime">
<div class="chapter-level-extent" id="Compile_002dtime-vs_002e-Install_002dtime">
<div class="nav-panel">
<p>
Next: <a href="#Bootstrapping" accesskey="n" rel="next">Bootstrapping</a>, Previous: <a href="#Resource-Files" accesskey="p" rel="prev">Resource Files</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Compile_002dtime-vs-Install_002dtime-1"><span>12 Compile-time vs Install-time<a class="copiable-link" href="#Compile_002dtime-vs-Install_002dtime-1"> &para;</a></span></h2>
<h2 class="chapter" id="Compile_002dtime-vs_002e-Install_002dtime-1"><span>12 Compile-time vs. Install-time<a class="copiable-link" href="#Compile_002dtime-vs_002e-Install_002dtime-1"> &para;</a></span></h2>
<p>Software whose installation is managed with Stow needs to be installed
in one place (the package directory, e.g. <samp class="file">/usr/local/stow/perl</samp>)
@ -1155,7 +1212,7 @@ following sections.
<div class="section-level-extent" id="GNU-Emacs">
<div class="nav-panel">
<p>
Next: <a href="#Other-FSF-Software" accesskey="n" rel="next">Other FSF Software</a>, Previous: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="p" rel="prev">Compile-time vs Install-time</a>, Up: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Other-FSF-Software" accesskey="n" rel="next">Other FSF Software</a>, Previous: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="p" rel="prev">Compile-time vs. Install-time</a>, Up: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="GNU-Emacs-1"><span>12.2 GNU Emacs<a class="copiable-link" href="#GNU-Emacs-1"> &para;</a></span></h3>
@ -1191,7 +1248,7 @@ make do-install prefix=/usr/local/stow/emacs
<div class="section-level-extent" id="Other-FSF-Software">
<div class="nav-panel">
<p>
Next: <a href="#Cygnus-Software" accesskey="n" rel="next">Cygnus Software</a>, Previous: <a href="#GNU-Emacs" accesskey="p" rel="prev">GNU Emacs</a>, Up: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Cygnus-Software" accesskey="n" rel="next">Cygnus Software</a>, Previous: <a href="#GNU-Emacs" accesskey="p" rel="prev">GNU Emacs</a>, Up: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Other-FSF-Software-1"><span>12.3 Other FSF Software<a class="copiable-link" href="#Other-FSF-Software-1"> &para;</a></span></h3>
@ -1217,7 +1274,7 @@ and &lsquo;<samp class="samp">make install</samp>&rsquo; steps to work correctly
<div class="section-level-extent" id="Cygnus-Software">
<div class="nav-panel">
<p>
Next: <a href="#Perl-and-Perl-5-Modules" accesskey="n" rel="next">Perl and Perl 5 Modules</a>, Previous: <a href="#Other-FSF-Software" accesskey="p" rel="prev">Other FSF Software</a>, Up: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Perl-and-Perl-5-Modules" accesskey="n" rel="next">Perl and Perl 5 Modules</a>, Previous: <a href="#Other-FSF-Software" accesskey="p" rel="prev">Other FSF Software</a>, Up: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Cygnus-Software-1"><span>12.4 Cygnus Software<a class="copiable-link" href="#Cygnus-Software-1"> &para;</a></span></h3>
@ -1251,7 +1308,7 @@ install manually.
<div class="section-level-extent" id="Perl-and-Perl-5-Modules">
<div class="nav-panel">
<p>
Previous: <a href="#Cygnus-Software" accesskey="p" rel="prev">Cygnus Software</a>, Up: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Previous: <a href="#Cygnus-Software" accesskey="p" rel="prev">Cygnus Software</a>, Up: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Perl-and-Perl-5-Modules-1"><span>12.5 Perl and Perl 5 Modules<a class="copiable-link" href="#Perl-and-Perl-5-Modules-1"> &para;</a></span></h3>
@ -1356,7 +1413,7 @@ find cpan.* \( -name .exists -o -name perllocal.pod \) -print | \
<div class="chapter-level-extent" id="Bootstrapping">
<div class="nav-panel">
<p>
Next: <a href="#Reporting-Bugs" accesskey="n" rel="next">Reporting Bugs</a>, Previous: <a href="#Compile_002dtime-vs-Install_002dtime" accesskey="p" rel="prev">Compile-time vs Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
Next: <a href="#Reporting-Bugs" accesskey="n" rel="next">Reporting Bugs</a>, Previous: <a href="#Compile_002dtime-vs_002e-Install_002dtime" accesskey="p" rel="prev">Compile-time vs. Install-time</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Bootstrapping-1"><span>13 Bootstrapping<a class="copiable-link" href="#Bootstrapping-1"> &para;</a></span></h2>
@ -1395,9 +1452,27 @@ Next: <a href="#Known-Bugs" accesskey="n" rel="next">Known Bugs</a>, Previous: <
</div>
<h2 class="chapter" id="Reporting-Bugs-1"><span>14 Reporting Bugs<a class="copiable-link" href="#Reporting-Bugs-1"> &para;</a></span></h2>
<p>Please send bug reports to the current maintainers by electronic
mail. The address to use is &lsquo;<samp class="samp">&lt;bug-stow@gnu.org&gt;</samp>&rsquo;. Please
include:
<p>You can report bugs to the current maintainers in one of three ways:
</p>
<ol class="enumerate">
<li> Send e-mail to <a class="email" href="mailto:bug-stow@gnu.org">bug-stow@gnu.org</a>.
</li><li> File an issue in <a class="uref" href="https://savannah.gnu.org/bugs/?group=stow">the Savannah bug tracker</a>.
</li><li> File an issue in
<a class="uref" href="https://github.com/aspiers/stow/issues/">the GitHub project</a>.
</li></ol>
<p>While GitHub is arguably the most convenient of these three options, it
<a class="uref" href="https://www.gnu.org/software/repo-criteria-evaluation.html#GitHub">is not the most ethical or freedom-preserving way to host software
projects</a>. Therefore the GitHub project may be
<a class="uref" href="https://github.com/aspiers/stow/issues/43">moved to a more ethical
hosting service</a> in the future.
</p>
<p>Before reporting a bug, it is recommended to check whether it is already
known, so please first see <a class="pxref" href="#Known-Bugs">Known Bugs</a>.
</p>
<p>When reporting a new bug, please include:
</p>
<ul class="itemize mark-bullet">
<li>the version number of Stow (&lsquo;<samp class="samp">stow --version</samp>&rsquo;);
@ -1412,12 +1487,13 @@ include:
</li><li>the precise command you gave;
</li><li>the output from the command (preferably verbose output, obtained by
adding &lsquo;<samp class="samp">--verbose=3</samp>&rsquo; to the Stow command line).
adding &lsquo;<samp class="samp">--verbose=5</samp>&rsquo; to the Stow command line).
</li></ul>
<p>If you are really keen, consider developing a minimal test case and
creating a new test. See the <samp class="file">t/</samp> directory in the source for
lots of examples.
creating a new test. See the <samp class="file">t/</samp> directory in the source for lots
of examples, and the <samp class="file">CONTRIBUTING.md</samp> file for a guide on how to
contribute.
</p>
<p>Before reporting a bug, please read the manual carefully, especially
<a class="ref" href="#Known-Bugs">Known Bugs</a>, to see whether you&rsquo;re encountering
@ -1433,10 +1509,20 @@ Next: <a href="#GNU-General-Public-License" accesskey="n" rel="next">GNU General
</div>
<h2 class="chapter" id="Known-Bugs-1"><span>15 Known Bugs<a class="copiable-link" href="#Known-Bugs-1"> &para;</a></span></h2>
<p>There are no known bugs in Stow version 2.3.2-fixbug56727!
If you think you have found one, please see <a class="pxref" href="#Reporting-Bugs">Reporting Bugs</a>.
<p>Known bugs can be found in the following locations:
</p>
<ul class="itemize mark-bullet">
<li><a class="uref" href="https://github.com/aspiers/stow/issues/">the GitHub issue tracker</a>
</li><li><a class="uref" href="https://savannah.gnu.org/bugs/?group=stow">the Savannah bug
tracker</a>
</li><li>the <a class="uref" href="https://lists.gnu.org/archive/html/bug-stow/">bug-stow list
archives</a>
</li></ul>
<p>If you think you have found a new bug, please see <a class="pxref" href="#Reporting-Bugs">Reporting Bugs</a>.
</p>
<hr>
</div>
<div class="unnumbered-level-extent" id="GNU-General-Public-License">
@ -2236,6 +2322,8 @@ Previous: <a href="#GNU-General-Public-License" accesskey="p" rel="prev">GNU Gen
<tr><td></td><td class="printindex-index-entry"><a href="#index-splitting-open-folded-trees">splitting open folded trees</a></td><td class="printindex-index-section"><a href="#Installing-Packages">Installing Packages</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-stow-directory">stow directory</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-symlink">symlink</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-symlink-destination">symlink destination</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-symlink-source">symlink source</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-T">T</th></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-target-directory">target directory</a></td><td class="printindex-index-section"><a href="#Terminology">Terminology</a></td></tr>

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -49,7 +49,7 @@ approved by the Free Software Foundation. -->
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top">
<link href="Reporting-Bugs.html" rel="next" title="Reporting Bugs">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="prev" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="prev" title="Compile-time vs. Install-time">
<style type="text/css">
<!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="chapter-level-extent" id="Bootstrapping">
<div class="nav-panel">
<p>
Next: <a href="Reporting-Bugs.html" accesskey="n" rel="next">Reporting Bugs</a>, Previous: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="p" rel="prev">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Reporting-Bugs.html" accesskey="n" rel="next">Reporting Bugs</a>, Previous: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="p" rel="prev">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h2 class="chapter" id="Bootstrapping-1"><span>13 Bootstrapping<a class="copiable-link" href="#Bootstrapping-1"> &para;</a></span></h2>

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -35,10 +35,10 @@ Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation
approved by the Free Software Foundation. -->
<title>Compile-time vs Install-time (Stow)</title>
<title>Compile-time vs. Install-time (Stow)</title>
<meta name="description" content="Compile-time vs Install-time (Stow)">
<meta name="keywords" content="Compile-time vs Install-time (Stow)">
<meta name="description" content="Compile-time vs. Install-time (Stow)">
<meta name="keywords" content="Compile-time vs. Install-time (Stow)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@ -63,13 +63,13 @@ span:hover a.copiable-link {visibility: visible}
</head>
<body lang="en">
<div class="chapter-level-extent" id="Compile_002dtime-vs-Install_002dtime">
<div class="chapter-level-extent" id="Compile_002dtime-vs_002e-Install_002dtime">
<div class="nav-panel">
<p>
Next: <a href="Bootstrapping.html" accesskey="n" rel="next">Bootstrapping</a>, Previous: <a href="Resource-Files.html" accesskey="p" rel="prev">Resource Files</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h2 class="chapter" id="Compile_002dtime-vs-Install_002dtime-1"><span>12 Compile-time vs Install-time<a class="copiable-link" href="#Compile_002dtime-vs-Install_002dtime-1"> &para;</a></span></h2>
<h2 class="chapter" id="Compile_002dtime-vs_002e-Install_002dtime-1"><span>12 Compile-time vs. Install-time<a class="copiable-link" href="#Compile_002dtime-vs_002e-Install_002dtime-1"> &para;</a></span></h2>
<p>Software whose installation is managed with Stow needs to be installed
in one place (the package directory, e.g. <samp class="file">/usr/local/stow/perl</samp>)

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -47,7 +47,7 @@ approved by the Free Software Foundation. -->
<link href="index.html" rel="start" title="Top">
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="up" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="up" title="Compile-time vs. Install-time">
<link href="Perl-and-Perl-5-Modules.html" rel="next" title="Perl and Perl 5 Modules">
<link href="Other-FSF-Software.html" rel="prev" title="Other FSF Software">
<style type="text/css">
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="section-level-extent" id="Cygnus-Software">
<div class="nav-panel">
<p>
Next: <a href="Perl-and-Perl-5-Modules.html" accesskey="n" rel="next">Perl and Perl 5 Modules</a>, Previous: <a href="Other-FSF-Software.html" accesskey="p" rel="prev">Other FSF Software</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Perl-and-Perl-5-Modules.html" accesskey="n" rel="next">Perl and Perl 5 Modules</a>, Previous: <a href="Other-FSF-Software.html" accesskey="p" rel="prev">Other FSF Software</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="Cygnus-Software-1"><span>12.4 Cygnus Software<a class="copiable-link" href="#Cygnus-Software-1"> &para;</a></span></h3>

View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -47,9 +47,9 @@ approved by the Free Software Foundation. -->
<link href="index.html" rel="start" title="Top">
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="up" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="up" title="Compile-time vs. Install-time">
<link href="Other-FSF-Software.html" rel="next" title="Other FSF Software">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="prev" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="prev" title="Compile-time vs. Install-time">
<style type="text/css">
<!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="section-level-extent" id="GNU-Emacs">
<div class="nav-panel">
<p>
Next: <a href="Other-FSF-Software.html" accesskey="n" rel="next">Other FSF Software</a>, Previous: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="p" rel="prev">Compile-time vs Install-time</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Other-FSF-Software.html" accesskey="n" rel="next">Other FSF Software</a>, Previous: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="p" rel="prev">Compile-time vs. Install-time</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="GNU-Emacs-1"><span>12.2 GNU Emacs<a class="copiable-link" href="#GNU-Emacs-1"> &para;</a></span></h3>

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -229,13 +229,15 @@ doing. Verbosity levels are from 0 to 5; 0 is the default. Using
</dd>
<dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt>
<dt>&lsquo;<samp class="samp">--compat</samp>&rsquo;</dt>
<dd><p>Scan the whole target tree when unstowing. By default, only
directories specified in the <em class="dfn">installation image</em> are scanned
during an unstow operation. Scanning the whole tree can be
prohibitive if your target tree is very large. This option restores
the legacy behaviour; however, the <samp class="option">--badlinks</samp> option to the
<code class="command">chkstow</code> utility may be a better way of ensuring that your
installation does not have any dangling symlinks (see <a class="pxref" href="Target-Maintenance.html">Target Maintenance</a>).
<dd><p>Scan the whole target tree when unstowing. By default, only directories
specified in the <em class="dfn">installation image</em> are scanned during an unstow
operation. Previously Stow scanned the whole tree, which can be
prohibitive if your target tree is very large, but on the other hand has
the advantage of unstowing previously stowed links which are no longer
present in the installation image and therefore orphaned. This option
restores the legacy behaviour; however, the <samp class="option">--badlinks</samp> option
to the <code class="command">chkstow</code> utility may be a better way of ensuring that
your installation does not have any dangling symlinks (see <a class="pxref" href="Target-Maintenance.html">Target Maintenance</a>).
</p>
</dd>
<dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt>

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -54,6 +54,7 @@ approved by the Free Software Foundation. -->
<!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
span:hover a.copiable-link {visibility: visible}
ul.mark-bullet {list-style-type: disc}
-->
</style>
@ -69,10 +70,20 @@ Next: <a href="GNU-General-Public-License.html" accesskey="n" rel="next">GNU Gen
<hr>
<h2 class="chapter" id="Known-Bugs-1"><span>15 Known Bugs<a class="copiable-link" href="#Known-Bugs-1"> &para;</a></span></h2>
<p>There are no known bugs in Stow version 2.3.2-fixbug56727!
If you think you have found one, please see <a class="pxref" href="Reporting-Bugs.html">Reporting Bugs</a>.
<p>Known bugs can be found in the following locations:
</p>
<ul class="itemize mark-bullet">
<li><a class="uref" href="https://github.com/aspiers/stow/issues/">the GitHub issue tracker</a>
</li><li><a class="uref" href="https://savannah.gnu.org/bugs/?group=stow">the Savannah bug
tracker</a>
</li><li>the <a class="uref" href="https://lists.gnu.org/archive/html/bug-stow/">bug-stow list
archives</a>
</li></ul>
<p>If you think you have found a new bug, please see <a class="pxref" href="Reporting-Bugs.html">Reporting Bugs</a>.
</p>
</div>

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -86,7 +86,7 @@ version 21.3 to 21.4a you can now do the following:
invocations of stow, because redundant folding/unfolding operations
can be factored out. In addition, all the operations are calculated
and merged before being executed (see <a class="pxref" href="Conflicts.html#Deferred-Operation">Deferred Operation</a>), so the
amount of of time in which GNU Emacs is unavailable is minimised.
amount of time in which GNU Emacs is unavailable is minimised.
</p>
<p>You can mix and match any number of actions, for example,
</p>

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -47,7 +47,7 @@ approved by the Free Software Foundation. -->
<link href="index.html" rel="start" title="Top">
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="up" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="up" title="Compile-time vs. Install-time">
<link href="Cygnus-Software.html" rel="next" title="Cygnus Software">
<link href="GNU-Emacs.html" rel="prev" title="GNU Emacs">
<style type="text/css">
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="section-level-extent" id="Other-FSF-Software">
<div class="nav-panel">
<p>
Next: <a href="Cygnus-Software.html" accesskey="n" rel="next">Cygnus Software</a>, Previous: <a href="GNU-Emacs.html" accesskey="p" rel="prev">GNU Emacs</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Cygnus-Software.html" accesskey="n" rel="next">Cygnus Software</a>, Previous: <a href="GNU-Emacs.html" accesskey="p" rel="prev">GNU Emacs</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="Other-FSF-Software-1"><span>12.3 Other FSF Software<a class="copiable-link" href="#Other-FSF-Software-1"> &para;</a></span></h3>

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -47,7 +47,7 @@ approved by the Free Software Foundation. -->
<link href="index.html" rel="start" title="Top">
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="up" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="up" title="Compile-time vs. Install-time">
<link href="Cygnus-Software.html" rel="prev" title="Cygnus Software">
<style type="text/css">
<!--
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="section-level-extent" id="Perl-and-Perl-5-Modules">
<div class="nav-panel">
<p>
Previous: <a href="Cygnus-Software.html" accesskey="p" rel="prev">Cygnus Software</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Previous: <a href="Cygnus-Software.html" accesskey="p" rel="prev">Cygnus Software</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="u" rel="up">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="Perl-and-Perl-5-Modules-1"><span>12.5 Perl and Perl 5 Modules<a class="copiable-link" href="#Perl-and-Perl-5-Modules-1"> &para;</a></span></h3>
@ -169,7 +169,7 @@ find cpan.* \( -name .exists -o -name perllocal.pod \) -print | \
<hr>
<div class="nav-panel">
<p>
Previous: <a href="Cygnus-Software.html">Cygnus Software</a>, Up: <a href="Compile_002dtime-vs-Install_002dtime.html">Compile-time vs Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Previous: <a href="Cygnus-Software.html">Cygnus Software</a>, Up: <a href="Compile_002dtime-vs_002e-Install_002dtime.html">Compile-time vs. Install-time</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -70,9 +70,27 @@ Next: <a href="Known-Bugs.html" accesskey="n" rel="next">Known Bugs</a>, Previou
<hr>
<h2 class="chapter" id="Reporting-Bugs-1"><span>14 Reporting Bugs<a class="copiable-link" href="#Reporting-Bugs-1"> &para;</a></span></h2>
<p>Please send bug reports to the current maintainers by electronic
mail. The address to use is &lsquo;<samp class="samp">&lt;bug-stow@gnu.org&gt;</samp>&rsquo;. Please
include:
<p>You can report bugs to the current maintainers in one of three ways:
</p>
<ol class="enumerate">
<li> Send e-mail to <a class="email" href="mailto:bug-stow@gnu.org">bug-stow@gnu.org</a>.
</li><li> File an issue in <a class="uref" href="https://savannah.gnu.org/bugs/?group=stow">the Savannah bug tracker</a>.
</li><li> File an issue in
<a class="uref" href="https://github.com/aspiers/stow/issues/">the GitHub project</a>.
</li></ol>
<p>While GitHub is arguably the most convenient of these three options, it
<a class="uref" href="https://www.gnu.org/software/repo-criteria-evaluation.html#GitHub">is not the most ethical or freedom-preserving way to host software
projects</a>. Therefore the GitHub project may be
<a class="uref" href="https://github.com/aspiers/stow/issues/43">moved to a more ethical
hosting service</a> in the future.
</p>
<p>Before reporting a bug, it is recommended to check whether it is already
known, so please first see <a class="pxref" href="Known-Bugs.html">Known Bugs</a>.
</p>
<p>When reporting a new bug, please include:
</p>
<ul class="itemize mark-bullet">
<li>the version number of Stow (&lsquo;<samp class="samp">stow --version</samp>&rsquo;);
@ -87,12 +105,13 @@ include:
</li><li>the precise command you gave;
</li><li>the output from the command (preferably verbose output, obtained by
adding &lsquo;<samp class="samp">--verbose=3</samp>&rsquo; to the Stow command line).
adding &lsquo;<samp class="samp">--verbose=5</samp>&rsquo; to the Stow command line).
</li></ul>
<p>If you are really keen, consider developing a minimal test case and
creating a new test. See the <samp class="file">t/</samp> directory in the source for
lots of examples.
creating a new test. See the <samp class="file">t/</samp> directory in the source for lots
of examples, and the <samp class="file">CONTRIBUTING.md</samp> file for a guide on how to
contribute.
</p>
<p>Before reporting a bug, please read the manual carefully, especially
<a class="ref" href="Known-Bugs.html">Known Bugs</a>, to see whether you&rsquo;re encountering

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -48,7 +48,7 @@ approved by the Free Software Foundation. -->
<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top">
<link href="Compile_002dtime-vs-Install_002dtime.html" rel="next" title="Compile-time vs Install-time">
<link href="Compile_002dtime-vs_002e-Install_002dtime.html" rel="next" title="Compile-time vs. Install-time">
<link href="Target-Maintenance.html" rel="prev" title="Target Maintenance">
<style type="text/css">
<!--
@ -65,7 +65,7 @@ span:hover a.copiable-link {visibility: visible}
<div class="chapter-level-extent" id="Resource-Files">
<div class="nav-panel">
<p>
Next: <a href="Compile_002dtime-vs-Install_002dtime.html" accesskey="n" rel="next">Compile-time vs Install-time</a>, Previous: <a href="Target-Maintenance.html" accesskey="p" rel="prev">Target Maintenance</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Compile_002dtime-vs_002e-Install_002dtime.html" accesskey="n" rel="next">Compile-time vs. Install-time</a>, Previous: <a href="Target-Maintenance.html" accesskey="p" rel="prev">Target Maintenance</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h2 class="chapter" id="Resource-Files-1"><span>11 Resource Files<a class="copiable-link" href="#Resource-Files-1"> &para;</a></span></h2>
@ -137,7 +137,7 @@ resource file.
<hr>
<div class="nav-panel">
<p>
Next: <a href="Compile_002dtime-vs-Install_002dtime.html">Compile-time vs Install-time</a>, Previous: <a href="Target-Maintenance.html">Target Maintenance</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
Next: <a href="Compile_002dtime-vs_002e-Install_002dtime.html">Compile-time vs. Install-time</a>, Previous: <a href="Target-Maintenance.html">Target Maintenance</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -77,9 +77,12 @@ to be installed in a particular directory structure &mdash; e.g., with
</p>
<a class="index-entry-id" id="index-target-directory"></a>
<p>A <em class="dfn">target directory</em> is the root of a tree in which one or more
packages wish to <em class="emph">appear</em> to be installed. A common, but by no
means the only such location is <samp class="file">/usr/local</samp>. The examples in this
manual will use <samp class="file">/usr/local</samp> as the target directory.
packages wish to <em class="emph">appear</em> to be installed. <samp class="file">/usr/local</samp> is a
common choice for this, but by no means the only such location. Another
common choice is <samp class="file">~</samp> (i.e. the user&rsquo;s <code class="code">$HOME</code> directory) in
the case where Stow is being used to manage the user&rsquo;s configuration
(&ldquo;dotfiles&rdquo;) and other files in their <code class="code">$HOME</code>. The examples in
this manual will use <samp class="file">/usr/local</samp> as the target directory.
</p>
<a class="index-entry-id" id="index-stow-directory"></a>
<p>A <em class="dfn">stow directory</em> is the root of a tree containing separate
@ -97,6 +100,11 @@ installation image for Perl includes: a <samp class="file">bin</samp> directory
containing Texinfo documentation; a <samp class="file">lib/perl</samp> directory containing
Perl libraries; and a <samp class="file">man/man1</samp> directory containing man pages.
</p>
<blockquote class="quotation">
<p><b class="b">Note:</b> This is a <em class="emph">pre-</em>installation image which exists even before Stow
has installed any symlinks into the target directory which point to it.
</p></blockquote>
<a class="index-entry-id" id="index-package-directory"></a>
<a class="index-entry-id" id="index-package-name"></a>
<p>A <em class="dfn">package directory</em> is the root of a tree containing the
@ -112,16 +120,62 @@ target directory, <samp class="file">/usr/local/stow</samp> is the stow director
<samp class="file">/usr/local/stow/perl</samp> is the package directory, and
<samp class="file">bin/perl</samp> within is part of the installation image.
</p>
<a class="index-entry-id" id="index-symlink"></a>
<a class="anchor" id="symlink"></a><a class="index-entry-id" id="index-symlink"></a>
<a class="index-entry-id" id="index-symlink-source"></a>
<a class="index-entry-id" id="index-symlink-destination"></a>
<a class="index-entry-id" id="index-relative-symlink"></a>
<a class="index-entry-id" id="index-absolute-symlink"></a>
<p>A <em class="dfn">symlink</em> is a symbolic link. A symlink can be <em class="dfn">relative</em> or
<em class="dfn">absolute</em>. An absolute symlink names a full path; that is, one
starting from <samp class="file">/</samp>. A relative symlink names a relative path; that
is, one not starting from <samp class="file">/</samp>. The target of a relative symlink is
computed starting from the symlink&rsquo;s own directory. Stow only
creates relative symlinks.
<p>A <em class="dfn">symlink</em> is a symbolic link, i.e. an entry on the filesystem
whose path is sometimes called the <em class="dfn">symlink source</em>, which points to
another location on the filesystem called the <em class="dfn">symlink destination</em>.
There is no guarantee that the destination actually exists.
</p>
<p>In general, symlinks can be <em class="dfn">relative</em> or <em class="dfn">absolute</em>. A symlink
is absolute when the destination names a full path; that is, one
starting from <samp class="file">/</samp>. A symlink is relative when the destination
names a relative path; that is, one not starting from <samp class="file">/</samp>. The
destination of a relative symlink is computed starting from the
symlink&rsquo;s own directory, i.e. the directory containing the symlink
source.
</p>
<blockquote class="quotation">
<p><b class="b">Note:</b> Stow only creates symlinks within the target directory which point to
locations <em class="emph">outside</em> the target directory and inside the stow
directory.
</p>
<p>Consequently, we avoid referring to symlink destinations as symlink
<em class="emph">targets</em>, since this would result in the word &ldquo;target&rdquo; having
two different meanings:
</p>
<ol class="enumerate">
<li> the target directory, i.e. the directory into which Stow targets
installation, where symlinks are managed by Stow, and
</li><li> the destinations of those symlinks.
</li></ol>
<p>If we did not avoid the second meaning of &ldquo;target&rdquo;, then it would lead
to confusing language, such as describing Stow as installing symlinks
into the target directory which point to targets <em class="emph">outside</em> the
target directory.
</p>
<p>Similarly, the word &ldquo;source&rdquo; can have two different meanings in this
context:
</p>
<ol class="enumerate">
<li> the installation image, or some of its contents, and
</li><li> the location of symlinks (the &ldquo;source&rdquo; of the link, vs. its
destination).
</li></ol>
<p>Therefore it should also be avoided, or at least care taken to ensure
that the meaning is not ambiguous.
</p>
</blockquote>
</div>
<hr>
<div class="nav-panel">

View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -96,6 +96,7 @@ _darcs
\.git
\.gitignore
\.gitmodules
.+~ # emacs backup files
\#.*\# # emacs autosave files

View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@ -154,6 +154,8 @@ Previous: <a href="GNU-General-Public-License.html" accesskey="p" rel="prev">GNU
<tr><td></td><td class="printindex-index-entry"><a href="Installing-Packages.html#index-splitting-open-folded-trees">splitting open folded trees</a></td><td class="printindex-index-section"><a href="Installing-Packages.html">Installing Packages</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-stow-directory">stow directory</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-symlink">symlink</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-symlink-destination">symlink destination</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-symlink-source">symlink source</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-T">T</th></tr>
<tr><td></td><td class="printindex-index-entry"><a href="Terminology.html#index-target-directory">target directory</a></td><td class="printindex-index-section"><a href="Terminology.html">Terminology</a></td></tr>

View file

@ -0,0 +1,55 @@
<!DOCTYPE html>
<html>
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided also that the
section entitled "GNU General Public License" is included with the
modified manual, and provided that the entire resulting derived work is
distributed under the terms of a permission notice identical to this
one.
Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation
approved by the Free Software Foundation. -->
<title>symlink (Stow)</title>
<meta name="description" content="symlink (Stow)">
<meta name="keywords" content="symlink (Stow)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Refresh" content="0; url=Terminology.html#symlink">
<meta name="viewport" content="width=device-width,initial-scale=1">
</head>
<body lang="en">
<p>The node you are looking for is at <a href="Terminology.html#symlink">symlink</a>.</p>
</body>

View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727
(2 November 2023), a program for managing farms of symbolic links.
<!-- This manual describes GNU Stow version 2.4.0
(3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
© 1993, 1994, 1995, 1996 Bob Glickstein <bobg+stow@zanshin.com>
© 1993, 1994, 1995, 1996 Bob Glickstein bobg+stow@zanshin.com
© 2000, 2001 Guillaume Morin <gmorin@gnu.org>
© 2000, 2001 Guillaume Morin gmorin@gnu.org
© 2007 Kahlil (Kal) Hodgson <kahlil@internode.on.net>
© 2007 Kahlil (Kal) Hodgson kahlil@internode.on.net
© 2011 Adam Spiers <stow@adamspiers.org>
© 2011 Adam Spiers stow@adamspiers.org
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are

Binary file not shown.

View file

@ -1,4 +1,4 @@
@set UPDATED 2 November 2023
@set UPDATED-MONTH November 2023
@set EDITION 2.3.2-fixbug56727
@set VERSION 2.3.2-fixbug56727
@set UPDATED 3 June 2024
@set UPDATED-MONTH June 2024
@set EDITION 2.4.0
@set VERSION 2.4.0

View file

@ -1,7 +1,7 @@
This is stow.info, produced by makeinfo version 7.1 from stow.texi.
This manual describes GNU Stow version 2.3.2-fixbug56727 (2 November
2023), a program for managing farms of symbolic links.
This manual describes GNU Stow version 2.4.0 (3 June 2024), a program
for managing farms of symbolic links.
Software and documentation is copyrighted by the following:
@ -36,10 +36,10 @@ File: stow.info, Node: Top, Next: Introduction, Up: (dir)
Stow
****
This manual describes GNU Stow 2.3.2-fixbug56727 (2 November 2023), a
symlink farm manager which takes distinct sets of software and/or data
located in separate directories on the filesystem, and makes them appear
to be installed in a single directory tree.
This manual describes GNU Stow 2.4.0 (3 June 2024), a symlink farm
manager which takes distinct sets of software and/or data located in
separate directories on the filesystem, and makes them appear to be
installed in a single directory tree.
* Menu:
@ -54,7 +54,7 @@ to be installed in a single directory tree.
* Multiple Stow Directories:: Further segregating software.
* Target Maintenance:: Cleaning up mistakes.
* Resource Files:: Setting default command line options.
* Compile-time vs Install-time:: Faking out 'make install'.
* Compile-time vs. Install-time:: Faking out 'make install'.
* Bootstrapping:: When stow and perl are not yet stowed.
* Reporting Bugs:: How, what, where, and when to report.
* Known Bugs:: Don't report any of these.
@ -174,9 +174,12 @@ be installed in a particular directory structure -- e.g., with bin,
lib, and man subdirectories.
A “target directory” is the root of a tree in which one or more
packages wish to _appear_ to be installed. A common, but by no means
the only such location is /usr/local. The examples in this manual
will use /usr/local as the target directory.
packages wish to _appear_ to be installed. /usr/local is a common
choice for this, but by no means the only such location. Another common
choice is ~ (i.e. the user's $HOME directory) in the case where Stow
is being used to manage the user's configuration ("dotfiles") and other
files in their $HOME. The examples in this manual will use
/usr/local as the target directory.
A “stow directory” is the root of a tree containing separate packages
in private subtrees. When Stow runs, it uses the current directory as
@ -192,6 +195,10 @@ installation image for Perl includes: a bin directory containing
documentation; a lib/perl directory containing Perl libraries; and a
man/man1 directory containing man pages.
Note: This is a _pre-_installation image which exists even before
Stow has installed any symlinks into the target directory which
point to it.
A “package directory” is the root of a tree containing the
installation image for a particular package. Each package directory
must reside in a stow directory -- e.g., the package directory
@ -205,12 +212,46 @@ directory, /usr/local/stow is the stow directory,
/usr/local/stow/perl is the package directory, and bin/perl within
is part of the installation image.
A “symlink” is a symbolic link. A symlink can be “relative” or
“absolute”. An absolute symlink names a full path; that is, one
starting from /. A relative symlink names a relative path; that is,
one not starting from /. The target of a relative symlink is computed
starting from the symlink's own directory. Stow only creates relative
symlinks.
A “symlink” is a symbolic link, i.e. an entry on the filesystem whose
path is sometimes called the “symlink source”, which points to another
location on the filesystem called the “symlink destination”. There is
no guarantee that the destination actually exists.
In general, symlinks can be “relative” or “absolute”. A symlink is
absolute when the destination names a full path; that is, one starting
from /. A symlink is relative when the destination names a relative
path; that is, one not starting from /. The destination of a relative
symlink is computed starting from the symlink's own directory, i.e. the
directory containing the symlink source.
Note: Stow only creates symlinks within the target directory which
point to locations _outside_ the target directory and inside the
stow directory.
Consequently, we avoid referring to symlink destinations as symlink
_targets_, since this would result in the word "target" having two
different meanings:
1. the target directory, i.e. the directory into which Stow
targets installation, where symlinks are managed by Stow, and
2. the destinations of those symlinks.
If we did not avoid the second meaning of "target", then it would
lead to confusing language, such as describing Stow as installing
symlinks into the target directory which point to targets _outside_
the target directory.
Similarly, the word "source" can have two different meanings in
this context:
1. the installation image, or some of its contents, and
2. the location of symlinks (the "source" of the link, vs. its
destination).
Therefore it should also be avoided, or at least care taken to
ensure that the meaning is not ambiguous.

File: stow.info, Node: Invoking Stow, Next: Ignore Lists, Prev: Terminology, Up: Top
@ -366,12 +407,14 @@ The following options are supported:
--compat
Scan the whole target tree when unstowing. By default, only
directories specified in the “installation image” are scanned
during an unstow operation. Scanning the whole tree can be
prohibitive if your target tree is very large. This option
restores the legacy behaviour; however, the --badlinks option to
the chkstow utility may be a better way of ensuring that your
installation does not have any dangling symlinks (*note Target
Maintenance::).
during an unstow operation. Previously Stow scanned the whole
tree, which can be prohibitive if your target tree is very large,
but on the other hand has the advantage of unstowing previously
stowed links which are no longer present in the installation image
and therefore orphaned. This option restores the legacy behaviour;
however, the --badlinks option to the chkstow utility may be a
better way of ensuring that your installation does not have any
dangling symlinks (*note Target Maintenance::).
-V
--version
@ -475,6 +518,7 @@ list files:
\.git
\.gitignore
\.gitmodules
.+~ # emacs backup files
\#.*\# # emacs autosave files
@ -755,7 +799,7 @@ invocation.
invocations of stow, because redundant folding/unfolding operations can
be factored out. In addition, all the operations are calculated and
merged before being executed (*note Deferred Operation::), so the amount
of of time in which GNU Emacs is unavailable is minimised.
of time in which GNU Emacs is unavailable is minimised.
You can mix and match any number of actions, for example,
@ -825,7 +869,7 @@ The following options are supported:
target directory.

File: stow.info, Node: Resource Files, Next: Compile-time vs Install-time, Prev: Target Maintenance, Up: Top
File: stow.info, Node: Resource Files, Next: Compile-time vs. Install-time, Prev: Target Maintenance, Up: Top
11 Resource Files
*****************
@ -884,10 +928,10 @@ escape the $ or ~ with a backslash.
is also true of any package names given in the resource file.

File: stow.info, Node: Compile-time vs Install-time, Next: Bootstrapping, Prev: Resource Files, Up: Top
File: stow.info, Node: Compile-time vs. Install-time, Next: Bootstrapping, Prev: Resource Files, Up: Top
12 Compile-time vs Install-time
*******************************
12 Compile-time vs. Install-time
********************************
Software whose installation is managed with Stow needs to be installed
in one place (the package directory, e.g. /usr/local/stow/perl) but
@ -962,7 +1006,7 @@ following sections.
* Perl and Perl 5 Modules::

File: stow.info, Node: GNU Emacs, Next: Other FSF Software, Prev: Compile-time vs Install-time, Up: Compile-time vs Install-time
File: stow.info, Node: GNU Emacs, Next: Other FSF Software, Prev: Compile-time vs. Install-time, Up: Compile-time vs. Install-time
12.2 GNU Emacs
==============
@ -993,7 +1037,7 @@ around this problem is:
(1) As I write this, the current version of Emacs is 19.31.

File: stow.info, Node: Other FSF Software, Next: Cygnus Software, Prev: GNU Emacs, Up: Compile-time vs Install-time
File: stow.info, Node: Other FSF Software, Next: Cygnus Software, Prev: GNU Emacs, Up: Compile-time vs. Install-time
12.3 Other FSF Software
=======================
@ -1013,7 +1057,7 @@ and make install steps to work correctly without needing to "fool" the
build process.

File: stow.info, Node: Cygnus Software, Next: Perl and Perl 5 Modules, Prev: Other FSF Software, Up: Compile-time vs Install-time
File: stow.info, Node: Cygnus Software, Next: Perl and Perl 5 Modules, Prev: Other FSF Software, Up: Compile-time vs. Install-time
12.4 Cygnus Software
====================
@ -1044,7 +1088,7 @@ recompiling files. Usually it will work just fine; otherwise, install
manually.

File: stow.info, Node: Perl and Perl 5 Modules, Prev: Cygnus Software, Up: Compile-time vs Install-time
File: stow.info, Node: Perl and Perl 5 Modules, Prev: Cygnus Software, Up: Compile-time vs. Install-time
12.5 Perl and Perl 5 Modules
============================
@ -1129,7 +1173,7 @@ convention, you can simply do this:
xargs rm

File: stow.info, Node: Bootstrapping, Next: Reporting Bugs, Prev: Compile-time vs Install-time, Up: Top
File: stow.info, Node: Bootstrapping, Next: Reporting Bugs, Prev: Compile-time vs. Install-time, Up: Top
13 Bootstrapping
****************
@ -1160,8 +1204,27 @@ File: stow.info, Node: Reporting Bugs, Next: Known Bugs, Prev: Bootstrapping,
14 Reporting Bugs
*****************
Please send bug reports to the current maintainers by electronic mail.
The address to use is <bug-stow@gnu.org>. Please include:
You can report bugs to the current maintainers in one of three ways:
1. Send e-mail to <bug-stow@gnu.org>.
2. File an issue in the Savannah bug tracker
(https://savannah.gnu.org/bugs/?group=stow).
3. File an issue in the GitHub project
(https://github.com/aspiers/stow/issues/).
While GitHub is arguably the most convenient of these three options,
it is not the most ethical or freedom-preserving way to host software
projects
(https://www.gnu.org/software/repo-criteria-evaluation.html#GitHub).
Therefore the GitHub project may be moved to a more ethical hosting
service (https://github.com/aspiers/stow/issues/43) in the future.
Before reporting a bug, it is recommended to check whether it is
already known, so please first *note Known Bugs::.
When reporting a new bug, please include:
• the version number of Stow (stow --version);
@ -1175,11 +1238,12 @@ The address to use is <bug-stow@gnu.org>. Please include:
• the precise command you gave;
• the output from the command (preferably verbose output, obtained by
adding --verbose=3 to the Stow command line).
adding --verbose=5 to the Stow command line).
If you are really keen, consider developing a minimal test case and
creating a new test. See the t/ directory in the source for lots of
examples.
examples, and the CONTRIBUTING.md file for a guide on how to
contribute.
Before reporting a bug, please read the manual carefully, especially
*note Known Bugs::, to see whether you're encountering something that
@ -1191,8 +1255,17 @@ File: stow.info, Node: Known Bugs, Next: GNU General Public License, Prev: Re
15 Known Bugs
*************
There are no known bugs in Stow version 2.3.2-fixbug56727! If you think
you have found one, please *note Reporting Bugs::.
Known bugs can be found in the following locations:
• the GitHub issue tracker (https://github.com/aspiers/stow/issues/)
• the Savannah bug tracker
(https://savannah.gnu.org/bugs/?group=stow)
• the bug-stow list archives
(https://lists.gnu.org/archive/html/bug-stow/)
If you think you have found a new bug, please *note Reporting Bugs::.

File: stow.info, Node: GNU General Public License, Next: Index, Prev: Known Bugs, Up: Top
@ -1919,7 +1992,7 @@ Index
[index]
* Menu:
* absolute symlink: Terminology. (line 43)
* absolute symlink: Terminology. (line 50)
* adopting existing files: Invoking Stow. (line 115)
* configuration files: Resource Files. (line 6)
* conflicts: Installing Packages. (line 85)
@ -1937,20 +2010,22 @@ Index
* ignoring files and directories: Ignore Lists. (line 6)
* installation: Installing Packages. (line 6)
* installation conflicts: Installing Packages. (line 85)
* installation image: Terminology. (line 23)
* installation image: Terminology. (line 26)
* maintenance: Target Maintenance. (line 6)
* mixing operations: Mixing Operations. (line 6)
* ownership: Installing Packages. (line 72)
* package: Terminology. (line 6)
* package directory: Terminology. (line 30)
* package name: Terminology. (line 30)
* package directory: Terminology. (line 37)
* package name: Terminology. (line 37)
* refolding trees: Deleting Packages. (line 25)
* relative symlink: Terminology. (line 43)
* relative symlink: Terminology. (line 50)
* resource files: Resource Files. (line 6)
* simulated run: Invoking Stow. (line 137)
* splitting open folded trees: Installing Packages. (line 51)
* stow directory: Terminology. (line 16)
* symlink: Terminology. (line 43)
* stow directory: Terminology. (line 19)
* symlink: Terminology. (line 50)
* symlink destination: Terminology. (line 50)
* symlink source: Terminology. (line 50)
* target directory: Terminology. (line 11)
* tree folding: Installing Packages. (line 16)
* tree refolding: Deleting Packages. (line 25)
@ -1962,43 +2037,44 @@ Index

Tag Table:
Node: Top1427
Node: Introduction3088
Ref: Introduction-Footnote-16570
Ref: Introduction-Footnote-26679
Ref: Introduction-Footnote-36777
Node: Terminology6854
Node: Invoking Stow9349
Node: Ignore Lists17276
Node: Motivation For Ignore Lists17540
Node: Types And Syntax Of Ignore Lists19071
Ref: Types And Syntax Of Ignore Lists-Footnote-122368
Ref: Types And Syntax Of Ignore Lists-Footnote-222534
Ref: Types And Syntax Of Ignore Lists-Footnote-322778
Node: Justification For Yet Another Set Of Ignore Files22927
Node: Installing Packages24542
Ref: tree folding25104
Ref: Tree unfolding27102
Node: Deleting Packages29241
Ref: tree refolding30304
Ref: Deleting Packages-Footnote-130853
Node: Conflicts31449
Ref: Deferred Operation32439
Node: Mixing Operations33039
Node: Multiple Stow Directories34031
Node: Target Maintenance35115
Node: Resource Files36398
Node: Compile-time vs Install-time38993
Node: GNU Emacs42502
Ref: GNU Emacs-Footnote-143491
Node: Other FSF Software43555
Node: Cygnus Software44336
Node: Perl and Perl 5 Modules45847
Node: Bootstrapping49476
Node: Reporting Bugs50285
Node: Known Bugs51300
Node: GNU General Public License51560
Node: Index89114
Node: Top1411
Node: Introduction3057
Ref: Introduction-Footnote-16539
Ref: Introduction-Footnote-26648
Ref: Introduction-Footnote-36746
Node: Terminology6823
Ref: symlink9312
Node: Invoking Stow11136
Node: Ignore Lists19249
Node: Motivation For Ignore Lists19513
Node: Types And Syntax Of Ignore Lists21044
Ref: Types And Syntax Of Ignore Lists-Footnote-124359
Ref: Types And Syntax Of Ignore Lists-Footnote-224525
Ref: Types And Syntax Of Ignore Lists-Footnote-324769
Node: Justification For Yet Another Set Of Ignore Files24918
Node: Installing Packages26533
Ref: tree folding27095
Ref: Tree unfolding29093
Node: Deleting Packages31232
Ref: tree refolding32295
Ref: Deleting Packages-Footnote-132844
Node: Conflicts33440
Ref: Deferred Operation34430
Node: Mixing Operations35030
Node: Multiple Stow Directories36019
Node: Target Maintenance37103
Node: Resource Files38386
Node: Compile-time vs. Install-time40982
Node: GNU Emacs44494
Ref: GNU Emacs-Footnote-145485
Node: Other FSF Software45549
Node: Cygnus Software46331
Node: Perl and Perl 5 Modules47843
Node: Bootstrapping51473
Node: Reporting Bugs52283
Node: Known Bugs54051
Node: GNU General Public License54557
Node: Index92111

End Tag Table

View file

@ -55,7 +55,7 @@
.\" ========================================================================
.\"
.IX Title "stow 8"
.TH stow 8 2023-11-02 "perl v5.38.0" "User Contributed Perl Documentation"
.TH stow 8 2024-06-03 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@ -67,7 +67,7 @@ stow \- manage farms of symbolic links
stow [ options ] package ...
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This manual page describes GNU Stow 2.3.2\-fixbug56727. This is not the
This manual page describes GNU Stow 2.4.0. This is not the
definitive documentation for Stow; for that, see the accompanying info
manual, e.g. by typing \f(CW\*(C`info stow\*(C'\fR.
.PP