dot/stow
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Rebuild based on upstream Stow 2.4.0

Browse source
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
Show stats Download patch file Download diff file Expand all files Collapse all files

1
dot-local/bin/chkstow
View file

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

4
dot-local/bin/stow
View file

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

2034
dot-local/lib/perl/Stow.pm
View file

File diff suppressed because it is too large Load diff

90
dot-local/lib/perl/Stow/Util.pm
View file

@ -32,16 +32,18 @@ Supporting utility routines for L<Stow>.
use strict; use strict;
use warnings; use warnings;
use File::Spec;
use POSIX qw(getcwd); use POSIX qw(getcwd);
use base qw(Exporter); use base qw(Exporter);
our @EXPORT_OK = qw( our @EXPORT_OK = qw(
error debug set_debug_level set_test_mode 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 $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 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 minimum verbosity level required to output C<$msg>. All output is to
@ -125,13 +127,18 @@ overriding, fixing invalid links
=cut =cut
sub debug { 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) { if ($debug_level >= $level) {
my $indent = ' ' x $indent_level;
if ($test_mode) { if ($test_mode) {
print "# $msg\n"; print "# $indent$msg\n";
} }
else { else {
warn "$msg\n"; warn "$indent$msg\n";
} }
} }
} }
@ -142,29 +149,53 @@ sub debug {
# Parameters: path1, path2, ... => paths # Parameters: path1, path2, ... => paths
# Returns : concatenation of given paths # Returns : concatenation of given paths
# Throws : n/a # Throws : n/a
# Comments : factors out redundant path elements: # Comments : Factors out some redundant path elements:
# : '//' => '/' and 'a/b/../c' => 'a/c' # : '//' => '/', 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 { sub join_paths {
my @paths = @_; my @paths = @_;
# weed out empty components and concatenate debug(5, 5, "| Joining: @paths");
my $result = join '/', grep {! /\A\z/} @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) if (substr($part, 0, 1) eq '/') {
my @result = (); $result = $part; # absolute path, so ignore all previous parts
PART:
for my $part (split m{/+}, $result) {
next PART if $part eq '.';
if (@result && $part eq '..' && $result[-1] ne '..') {
pop @result;
} }
else { 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 =============================================================== #===== METHOD ===============================================================
@ -209,17 +240,17 @@ sub restore_cwd {
} }
sub adjust_dotfile { sub adjust_dotfile {
my ($target) = @_; my ($pkg_node) = @_;
(my $adjusted = $pkg_node) =~ s/^dot-([^.])/.$1/;
return $adjusted;
}
my @result = (); # Needed when unstowing with --compat and --dotfiles
for my $part (split m{/+}, $target) { sub unadjust_dotfile {
if (($part ne "dot-") && ($part ne "dot-.")) { my ($target_node) = @_;
$part =~ s/^dot-/./; return $target_node if $target_node =~ /^\.\.?$/;
} (my $adjusted = $target_node) =~ s/^\./dot-/;
push @result, $part; return $adjusted;
}
return join '/', @result;
} }
=head1 BUGS =head1 BUGS
@ -232,6 +263,5 @@ sub adjust_dotfile {
# Local variables: # Local variables:
# mode: perl # mode: perl
# cperl-indent-level: 4
# end: # end:
# vim: ft=perl # vim: ft=perl

62
dot-local/share/doc/stow/README.md
View file

@ -60,6 +60,56 @@ You can get the latest information about Stow from the home page:
http://www.gnu.org/software/stow/ 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 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, notice and this notice are preserved. This file is offered as-is,
without any warranty. 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 Brief history and authorship
---------------------------- ----------------------------

172
dot-local/share/doc/stow/manual-single.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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> 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> </div>
<a class="top" id="SEC_Top"></a> <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 symlink farm manager which takes distinct sets of software and/or data
located in separate directories on the filesystem, and makes them located in separate directories on the filesystem, and makes them
appear to be installed in a single directory tree. 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-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-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-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"> <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-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> <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> </p>
<a class="index-entry-id" id="index-target-directory"></a> <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 <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 packages wish to <em class="emph">appear</em> to be installed. <samp class="file">/usr/local</samp> is a
means the only such location is <samp class="file">/usr/local</samp>. The examples in this common choice for this, but by no means the only such location. Another
manual will use <samp class="file">/usr/local</samp> as the target directory. 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> </p>
<a class="index-entry-id" id="index-stow-directory"></a> <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 <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 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. Perl libraries; and a <samp class="file">man/man1</samp> directory containing man pages.
</p> </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-directory"></a>
<a class="index-entry-id" id="index-package-name"></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 <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">/usr/local/stow/perl</samp> is the package directory, and
<samp class="file">bin/perl</samp> within is part of the installation image. <samp class="file">bin/perl</samp> within is part of the installation image.
</p> </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-relative-symlink"></a>
<a class="index-entry-id" id="index-absolute-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 <p>A <em class="dfn">symlink</em> is a symbolic link, i.e. an entry on the filesystem
<em class="dfn">absolute</em>. An absolute symlink names a full path; that is, one whose path is sometimes called the <em class="dfn">symlink source</em>, which points to
starting from <samp class="file">/</samp>. A relative symlink names a relative path; that another location on the filesystem called the <em class="dfn">symlink destination</em>.
is, one not starting from <samp class="file">/</samp>. The target of a relative symlink is There is no guarantee that the destination actually exists.
computed starting from the symlink&rsquo;s own directory. Stow only
creates relative symlinks.
</p> </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> <hr>
</div> </div>
<div class="chapter-level-extent" id="Invoking-Stow"> <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> </dd>
<dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt> <dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt>
<dt>&lsquo;<samp class="samp">--compat</samp>&rsquo;</dt> <dt>&lsquo;<samp class="samp">--compat</samp>&rsquo;</dt>
<dd><p>Scan the whole target tree when unstowing. By default, only <dd><p>Scan the whole target tree when unstowing. By default, only directories
directories specified in the <em class="dfn">installation image</em> are scanned specified in the <em class="dfn">installation image</em> are scanned during an unstow
during an unstow operation. Scanning the whole tree can be operation. Previously Stow scanned the whole tree, which can be
prohibitive if your target tree is very large. This option restores prohibitive if your target tree is very large, but on the other hand has
the legacy behaviour; however, the <samp class="option">--badlinks</samp> option to the the advantage of unstowing previously stowed links which are no longer
<code class="command">chkstow</code> utility may be a better way of ensuring that your present in the installation image and therefore orphaned. This option
installation does not have any dangling symlinks (see <a class="pxref" href="#Target-Maintenance">Target Maintenance</a>). 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> </p>
</dd> </dd>
<dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt> <dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt>
@ -587,6 +643,7 @@ _darcs
\.git \.git
\.gitignore \.gitignore
\.gitmodules
.+~ # emacs backup files .+~ # emacs backup files
\#.*\# # emacs autosave 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 invocations of stow, because redundant folding/unfolding operations
can be factored out. In addition, all the operations are calculated 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 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>
<p>You can mix and match any number of actions, for example, <p>You can mix and match any number of actions, for example,
</p> </p>
@ -997,7 +1054,7 @@ directory.
<div class="chapter-level-extent" id="Resource-Files"> <div class="chapter-level-extent" id="Resource-Files">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>
<h2 class="chapter" id="Resource-Files-1"><span>11 Resource Files<a class="copiable-link" href="#Resource-Files-1"> &para;</a></span></h2> <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> <a class="index-entry-id" id="index-resource-files"></a>
@ -1066,12 +1123,12 @@ resource file.
</p> </p>
<hr> <hr>
</div> </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"> <div class="nav-panel">
<p> <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> 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> </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 <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>) 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="section-level-extent" id="GNU-Emacs">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </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> <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="section-level-extent" id="Other-FSF-Software">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </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> <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="section-level-extent" id="Cygnus-Software">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </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> <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="section-level-extent" id="Perl-and-Perl-5-Modules">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </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> <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="chapter-level-extent" id="Bootstrapping">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>
<h2 class="chapter" id="Bootstrapping-1"><span>13 Bootstrapping<a class="copiable-link" href="#Bootstrapping-1"> &para;</a></span></h2> <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> </div>
<h2 class="chapter" id="Reporting-Bugs-1"><span>14 Reporting Bugs<a class="copiable-link" href="#Reporting-Bugs-1"> &para;</a></span></h2> <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 <p>You can report bugs to the current maintainers in one of three ways:
mail. The address to use is &lsquo;<samp class="samp">&lt;bug-stow@gnu.org&gt;</samp>&rsquo;. Please </p>
include: <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> </p>
<ul class="itemize mark-bullet"> <ul class="itemize mark-bullet">
<li>the version number of Stow (&lsquo;<samp class="samp">stow --version</samp>&rsquo;); <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 precise command you gave;
</li><li>the output from the command (preferably verbose output, obtained by </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> </li></ul>
<p>If you are really keen, consider developing a minimal test case and <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 creating a new test. See the <samp class="file">t/</samp> directory in the source for lots
lots of examples. of examples, and the <samp class="file">CONTRIBUTING.md</samp> file for a guide on how to
contribute.
</p> </p>
<p>Before reporting a bug, please read the manual carefully, especially <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 <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> </div>
<h2 class="chapter" id="Known-Bugs-1"><span>15 Known Bugs<a class="copiable-link" href="#Known-Bugs-1"> &para;</a></span></h2> <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! <p>Known bugs can be found in the following locations:
If you think you have found one, please see <a class="pxref" href="#Reporting-Bugs">Reporting Bugs</a>.
</p> </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> <hr>
</div> </div>
<div class="unnumbered-level-extent" id="GNU-General-Public-License"> <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-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-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">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><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-T">T</th></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> <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>

16
dot-local/share/doc/stow/manual-split/Bootstrapping.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top"> <link href="index.html" rel="up" title="Top">
<link href="Reporting-Bugs.html" rel="next" title="Reporting Bugs"> <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"> <style type="text/css">
<!-- <!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em} 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="chapter-level-extent" id="Bootstrapping">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>
<hr> <hr>
<h2 class="chapter" id="Bootstrapping-1"><span>13 Bootstrapping<a class="copiable-link" href="#Bootstrapping-1"> &para;</a></span></h2> <h2 class="chapter" id="Bootstrapping-1"><span>13 Bootstrapping<a class="copiable-link" href="#Bootstrapping-1"> &para;</a></span></h2>

22
dot-local/share/doc/stow/manual-split/Compile_002dtime-vs-Install_002dtime.html → dot-local/share/doc/stow/manual-split/Compile_002dtime-vs_002e-Install_002dtime.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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, into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation except that this permission notice may be stated in a translation
approved by the Free Software Foundation. --> 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="description" content="Compile-time vs. Install-time (Stow)">
<meta name="keywords" 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="resource-type" content="document">
<meta name="distribution" content="global"> <meta name="distribution" content="global">
<meta name="Generator" content="makeinfo"> <meta name="Generator" content="makeinfo">
@ -63,13 +63,13 @@ span:hover a.copiable-link {visibility: visible}
</head> </head>
<body lang="en"> <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"> <div class="nav-panel">
<p> <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> 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> </div>
<hr> <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 <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>) in one place (the package directory, e.g. <samp class="file">/usr/local/stow/perl</samp>)

12
dot-local/share/doc/stow/manual-split/Conflicts.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

16
dot-local/share/doc/stow/manual-split/Cygnus-Software.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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="start" title="Top">
<link href="Index.html" rel="index" title="Index"> <link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> <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="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"> <link href="Other-FSF-Software.html" rel="prev" title="Other FSF Software">
<style type="text/css"> <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="section-level-extent" id="Cygnus-Software">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>
<hr> <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> <h3 class="section" id="Cygnus-Software-1"><span>12.4 Cygnus Software<a class="copiable-link" href="#Cygnus-Software-1"> &para;</a></span></h3>

12
dot-local/share/doc/stow/manual-split/Deferred-Operation.html
View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor --> <!-- This file redirects to the location of a node or anchor -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Deleting-Packages.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

18
dot-local/share/doc/stow/manual-split/GNU-Emacs.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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="start" title="Top">
<link href="Index.html" rel="index" title="Index"> <link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> <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="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"> <style type="text/css">
<!-- <!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em} 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="section-level-extent" id="GNU-Emacs">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>
<hr> <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> <h3 class="section" id="GNU-Emacs-1"><span>12.2 GNU Emacs<a class="copiable-link" href="#GNU-Emacs-1"> &para;</a></span></h3>

12
dot-local/share/doc/stow/manual-split/GNU-General-Public-License.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Ignore-Lists.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Installing-Packages.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Introduction.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

28
dot-local/share/doc/stow/manual-split/Invoking-Stow.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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> </dd>
<dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt> <dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt>
<dt>&lsquo;<samp class="samp">--compat</samp>&rsquo;</dt> <dt>&lsquo;<samp class="samp">--compat</samp>&rsquo;</dt>
<dd><p>Scan the whole target tree when unstowing. By default, only <dd><p>Scan the whole target tree when unstowing. By default, only directories
directories specified in the <em class="dfn">installation image</em> are scanned specified in the <em class="dfn">installation image</em> are scanned during an unstow
during an unstow operation. Scanning the whole tree can be operation. Previously Stow scanned the whole tree, which can be
prohibitive if your target tree is very large. This option restores prohibitive if your target tree is very large, but on the other hand has
the legacy behaviour; however, the <samp class="option">--badlinks</samp> option to the the advantage of unstowing previously stowed links which are no longer
<code class="command">chkstow</code> utility may be a better way of ensuring that your present in the installation image and therefore orphaned. This option
installation does not have any dangling symlinks (see <a class="pxref" href="Target-Maintenance.html">Target Maintenance</a>). 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> </p>
</dd> </dd>
<dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt> <dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt>

12
dot-local/share/doc/stow/manual-split/Justification-For-Yet-Another-Set-Of-Ignore-Files.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

27
dot-local/share/doc/stow/manual-split/Known-Bugs.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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} a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
span:hover a.copiable-link {visibility: visible} span:hover a.copiable-link {visibility: visible}
ul.mark-bullet {list-style-type: disc}
--> -->
</style> </style>
@ -69,10 +70,20 @@ Next: <a href="GNU-General-Public-License.html" accesskey="n" rel="next">GNU Gen
<hr> <hr>
<h2 class="chapter" id="Known-Bugs-1"><span>15 Known Bugs<a class="copiable-link" href="#Known-Bugs-1"> &para;</a></span></h2> <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! <p>Known bugs can be found in the following locations:
If you think you have found one, please see <a class="pxref" href="Reporting-Bugs.html">Reporting Bugs</a>.
</p> </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> </div>

14
dot-local/share/doc/stow/manual-split/Mixing-Operations.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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 invocations of stow, because redundant folding/unfolding operations
can be factored out. In addition, all the operations are calculated 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 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>
<p>You can mix and match any number of actions, for example, <p>You can mix and match any number of actions, for example,
</p> </p>

12
dot-local/share/doc/stow/manual-split/Motivation-For-Ignore-Lists.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/Multiple-Stow-Directories.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

16
dot-local/share/doc/stow/manual-split/Other-FSF-Software.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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="start" title="Top">
<link href="Index.html" rel="index" title="Index"> <link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> <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="Cygnus-Software.html" rel="next" title="Cygnus Software">
<link href="GNU-Emacs.html" rel="prev" title="GNU Emacs"> <link href="GNU-Emacs.html" rel="prev" title="GNU Emacs">
<style type="text/css"> <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="section-level-extent" id="Other-FSF-Software">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>
<hr> <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> <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>

18
dot-local/share/doc/stow/manual-split/Perl-and-Perl-5-Modules.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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="start" title="Top">
<link href="Index.html" rel="index" title="Index"> <link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> <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"> <link href="Cygnus-Software.html" rel="prev" title="Cygnus Software">
<style type="text/css"> <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="section-level-extent" id="Perl-and-Perl-5-Modules">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>
<hr> <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> <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> <hr>
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>

43
dot-local/share/doc/stow/manual-split/Reporting-Bugs.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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> <hr>
<h2 class="chapter" id="Reporting-Bugs-1"><span>14 Reporting Bugs<a class="copiable-link" href="#Reporting-Bugs-1"> &para;</a></span></h2> <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 <p>You can report bugs to the current maintainers in one of three ways:
mail. The address to use is &lsquo;<samp class="samp">&lt;bug-stow@gnu.org&gt;</samp>&rsquo;. Please </p>
include: <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> </p>
<ul class="itemize mark-bullet"> <ul class="itemize mark-bullet">
<li>the version number of Stow (&lsquo;<samp class="samp">stow --version</samp>&rsquo;); <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 precise command you gave;
</li><li>the output from the command (preferably verbose output, obtained by </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> </li></ul>
<p>If you are really keen, consider developing a minimal test case and <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 creating a new test. See the <samp class="file">t/</samp> directory in the source for lots
lots of examples. of examples, and the <samp class="file">CONTRIBUTING.md</samp> file for a guide on how to
contribute.
</p> </p>
<p>Before reporting a bug, please read the manual carefully, especially <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 <a class="ref" href="Known-Bugs.html">Known Bugs</a>, to see whether you&rsquo;re encountering

18
dot-local/share/doc/stow/manual-split/Resource-Files.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top"> <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"> <link href="Target-Maintenance.html" rel="prev" title="Target Maintenance">
<style type="text/css"> <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="chapter-level-extent" id="Resource-Files">
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>
<hr> <hr>
<h2 class="chapter" id="Resource-Files-1"><span>11 Resource Files<a class="copiable-link" href="#Resource-Files-1"> &para;</a></span></h2> <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> <hr>
<div class="nav-panel"> <div class="nav-panel">
<p> <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> </div>

12
dot-local/share/doc/stow/manual-split/Target-Maintenance.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

86
dot-local/share/doc/stow/manual-split/Terminology.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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> </p>
<a class="index-entry-id" id="index-target-directory"></a> <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 <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 packages wish to <em class="emph">appear</em> to be installed. <samp class="file">/usr/local</samp> is a
means the only such location is <samp class="file">/usr/local</samp>. The examples in this common choice for this, but by no means the only such location. Another
manual will use <samp class="file">/usr/local</samp> as the target directory. 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> </p>
<a class="index-entry-id" id="index-stow-directory"></a> <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 <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 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. Perl libraries; and a <samp class="file">man/man1</samp> directory containing man pages.
</p> </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-directory"></a>
<a class="index-entry-id" id="index-package-name"></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 <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">/usr/local/stow/perl</samp> is the package directory, and
<samp class="file">bin/perl</samp> within is part of the installation image. <samp class="file">bin/perl</samp> within is part of the installation image.
</p> </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-relative-symlink"></a>
<a class="index-entry-id" id="index-absolute-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 <p>A <em class="dfn">symlink</em> is a symbolic link, i.e. an entry on the filesystem
<em class="dfn">absolute</em>. An absolute symlink names a full path; that is, one whose path is sometimes called the <em class="dfn">symlink source</em>, which points to
starting from <samp class="file">/</samp>. A relative symlink names a relative path; that another location on the filesystem called the <em class="dfn">symlink destination</em>.
is, one not starting from <samp class="file">/</samp>. The target of a relative symlink is There is no guarantee that the destination actually exists.
computed starting from the symlink&rsquo;s own directory. Stow only
creates relative symlinks.
</p> </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> </div>
<hr> <hr>
<div class="nav-panel"> <div class="nav-panel">

12
dot-local/share/doc/stow/manual-split/Tree-unfolding.html
View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor --> <!-- This file redirects to the location of a node or anchor -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

13
dot-local/share/doc/stow/manual-split/Types-And-Syntax-Of-Ignore-Lists.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are
@ -96,6 +96,7 @@ _darcs
\.git \.git
\.gitignore \.gitignore
\.gitmodules
.+~ # emacs backup files .+~ # emacs backup files
\#.*\# # emacs autosave files \#.*\# # emacs autosave files

14
dot-local/share/doc/stow/manual-split/index.html
View file

@ -3,21 +3,21 @@
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ --> <!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are 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="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-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">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><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-T">T</th></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> <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>

55
dot-local/share/doc/stow/manual-split/symlink.html Normal file
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>

12
dot-local/share/doc/stow/manual-split/tree-folding.html
View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor --> <!-- This file redirects to the location of a node or anchor -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

12
dot-local/share/doc/stow/manual-split/tree-refolding.html
View file

@ -4,21 +4,21 @@
<!-- This file redirects to the location of a node or anchor --> <!-- This file redirects to the location of a node or anchor -->
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual describes GNU Stow version 2.3.2-fixbug56727 <!-- This manual describes GNU Stow version 2.4.0
(2 November 2023), a program for managing farms of symbolic links. (3 June 2024), a program for managing farms of symbolic links.
Software and documentation is copyrighted by the following: 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 Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are manual provided the copyright notice and this permission notice are

BIN
dot-local/share/doc/stow/manual.pdf
View file

Binary file not shown.

8
dot-local/share/doc/stow/version.texi
View file

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

240
dot-local/share/info/stow.info
View file

@ -1,7 +1,7 @@
This is stow.info, produced by makeinfo version 7.1 from stow.texi. 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 This manual describes GNU Stow version 2.4.0 (3 June 2024), a program
2023), a program for managing farms of symbolic links. for managing farms of symbolic links.
Software and documentation is copyrighted by the following: Software and documentation is copyrighted by the following:
@ -36,10 +36,10 @@ File: stow.info, Node: Top, Next: Introduction, Up: (dir)
Stow Stow
**** ****
This manual describes GNU Stow 2.3.2-fixbug56727 (2 November 2023), a This manual describes GNU Stow 2.4.0 (3 June 2024), a symlink farm
symlink farm manager which takes distinct sets of software and/or data manager which takes distinct sets of software and/or data located in
located in separate directories on the filesystem, and makes them appear separate directories on the filesystem, and makes them appear to be
to be installed in a single directory tree. installed in a single directory tree.
* Menu: * Menu:
@ -54,7 +54,7 @@ to be installed in a single directory tree.
* Multiple Stow Directories:: Further segregating software. * Multiple Stow Directories:: Further segregating software.
* Target Maintenance:: Cleaning up mistakes. * Target Maintenance:: Cleaning up mistakes.
* Resource Files:: Setting default command line options. * 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. * Bootstrapping:: When stow and perl are not yet stowed.
* Reporting Bugs:: How, what, where, and when to report. * Reporting Bugs:: How, what, where, and when to report.
* Known Bugs:: Don't report any of these. * 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. ‘lib’, and ‘man’ subdirectories.
A “target directory” is the root of a tree in which one or more 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 packages wish to _appear_ to be installed. ‘/usr/local’ is a common
the only such location is ‘/usr/local’. The examples in this manual choice for this, but by no means the only such location. Another common
will use ‘/usr/local’ as the target directory. 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 A “stow directory” is the root of a tree containing separate packages
in private subtrees. When Stow runs, it uses the current directory as 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 documentation; a ‘lib/perl’ directory containing Perl libraries; and a
‘man/man1’ directory containing man pages. ‘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 A “package directory” is the root of a tree containing the
installation image for a particular package. Each package directory installation image for a particular package. Each package directory
must reside in a stow directory -- e.g., the 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 ‘/usr/local/stow/perl’ is the package directory, and ‘bin/perl’ within
is part of the installation image. is part of the installation image.
A “symlink” is a symbolic link. A symlink can be “relative” or A “symlink” is a symbolic link, i.e. an entry on the filesystem whose
“absolute”. An absolute symlink names a full path; that is, one path is sometimes called the “symlink source”, which points to another
starting from ‘/’. A relative symlink names a relative path; that is, location on the filesystem called the “symlink destination”. There is
one not starting from ‘/’. The target of a relative symlink is computed no guarantee that the destination actually exists.
starting from the symlink's own directory. Stow only creates relative
symlinks. 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 File: stow.info, Node: Invoking Stow, Next: Ignore Lists, Prev: Terminology, Up: Top
@ -366,12 +407,14 @@ The following options are supported:
‘--compat’ ‘--compat’
Scan the whole target tree when unstowing. By default, only Scan the whole target tree when unstowing. By default, only
directories specified in the “installation image” are scanned directories specified in the “installation image” are scanned
during an unstow operation. Scanning the whole tree can be during an unstow operation. Previously Stow scanned the whole
prohibitive if your target tree is very large. This option tree, which can be prohibitive if your target tree is very large,
restores the legacy behaviour; however, the ‘--badlinks’ option to but on the other hand has the advantage of unstowing previously
the ‘chkstow’ utility may be a better way of ensuring that your stowed links which are no longer present in the installation image
installation does not have any dangling symlinks (*note Target and therefore orphaned. This option restores the legacy behaviour;
Maintenance::). 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’ ‘-V’
‘--version’ ‘--version’
@ -475,6 +518,7 @@ list files:
\.git \.git
\.gitignore \.gitignore
\.gitmodules
.+~ # emacs backup files .+~ # emacs backup files
\#.*\# # emacs autosave files \#.*\# # emacs autosave files
@ -755,7 +799,7 @@ invocation.
invocations of stow, because redundant folding/unfolding operations can invocations of stow, because redundant folding/unfolding operations can
be factored out. In addition, all the operations are calculated and be factored out. In addition, all the operations are calculated and
merged before being executed (*note Deferred Operation::), so the amount 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, You can mix and match any number of actions, for example,
@ -825,7 +869,7 @@ The following options are supported:
target directory. 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 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. 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 Software whose installation is managed with Stow needs to be installed
in one place (the package directory, e.g. ‘/usr/local/stow/perl’) but in one place (the package directory, e.g. ‘/usr/local/stow/perl’) but
@ -962,7 +1006,7 @@ following sections.
* Perl and Perl 5 Modules:: * 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 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. (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 12.3 Other FSF Software
======================= =======================
@ -1013,7 +1057,7 @@ and ‘make install’ steps to work correctly without needing to "fool" the
build process. 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 12.4 Cygnus Software
==================== ====================
@ -1044,7 +1088,7 @@ recompiling files. Usually it will work just fine; otherwise, install
manually. 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 12.5 Perl and Perl 5 Modules
============================ ============================
@ -1129,7 +1173,7 @@ convention, you can simply do this:
xargs rm 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 13 Bootstrapping
**************** ****************
@ -1160,8 +1204,27 @@ File: stow.info, Node: Reporting Bugs, Next: Known Bugs, Prev: Bootstrapping,
14 Reporting Bugs 14 Reporting Bugs
***************** *****************
Please send bug reports to the current maintainers by electronic mail. You can report bugs to the current maintainers in one of three ways:
The address to use is ‘<bug-stow@gnu.org>’. Please include:
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’); • 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 precise command you gave;
• the output from the command (preferably verbose output, obtained by • 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 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 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 Before reporting a bug, please read the manual carefully, especially
*note Known Bugs::, to see whether you're encountering something that *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 15 Known Bugs
************* *************
There are no known bugs in Stow version 2.3.2-fixbug56727! If you think Known bugs can be found in the following locations:
you have found one, please *note Reporting Bugs::.
• 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 File: stow.info, Node: GNU General Public License, Next: Index, Prev: Known Bugs, Up: Top
@ -1919,7 +1992,7 @@ Index
[index] [index]
* Menu: * Menu:
* absolute symlink: Terminology. (line 43) * absolute symlink: Terminology. (line 50)
* adopting existing files: Invoking Stow. (line 115) * adopting existing files: Invoking Stow. (line 115)
* configuration files: Resource Files. (line 6) * configuration files: Resource Files. (line 6)
* conflicts: Installing Packages. (line 85) * conflicts: Installing Packages. (line 85)
@ -1937,20 +2010,22 @@ Index
* ignoring files and directories: Ignore Lists. (line 6) * ignoring files and directories: Ignore Lists. (line 6)
* installation: Installing Packages. (line 6) * installation: Installing Packages. (line 6)
* installation conflicts: Installing Packages. (line 85) * installation conflicts: Installing Packages. (line 85)
* installation image: Terminology. (line 23) * installation image: Terminology. (line 26)
* maintenance: Target Maintenance. (line 6) * maintenance: Target Maintenance. (line 6)
* mixing operations: Mixing Operations. (line 6) * mixing operations: Mixing Operations. (line 6)
* ownership: Installing Packages. (line 72) * ownership: Installing Packages. (line 72)
* package: Terminology. (line 6) * package: Terminology. (line 6)
* package directory: Terminology. (line 30) * package directory: Terminology. (line 37)
* package name: Terminology. (line 30) * package name: Terminology. (line 37)
* refolding trees: Deleting Packages. (line 25) * refolding trees: Deleting Packages. (line 25)
* relative symlink: Terminology. (line 43) * relative symlink: Terminology. (line 50)
* resource files: Resource Files. (line 6) * resource files: Resource Files. (line 6)
* simulated run: Invoking Stow. (line 137) * simulated run: Invoking Stow. (line 137)
* splitting open folded trees: Installing Packages. (line 51) * splitting open folded trees: Installing Packages. (line 51)
* stow directory: Terminology. (line 16) * stow directory: Terminology. (line 19)
* symlink: Terminology. (line 43) * symlink: Terminology. (line 50)
* symlink destination: Terminology. (line 50)
* symlink source: Terminology. (line 50)
* target directory: Terminology. (line 11) * target directory: Terminology. (line 11)
* tree folding: Installing Packages. (line 16) * tree folding: Installing Packages. (line 16)
* tree refolding: Deleting Packages. (line 25) * tree refolding: Deleting Packages. (line 25)
@ -1962,43 +2037,44 @@ Index
 
Tag Table: Tag Table:
Node: Top1427 Node: Top1411
Node: Introduction3088 Node: Introduction3057
Ref: Introduction-Footnote-16570 Ref: Introduction-Footnote-16539
Ref: Introduction-Footnote-26679 Ref: Introduction-Footnote-26648
Ref: Introduction-Footnote-36777 Ref: Introduction-Footnote-36746
Node: Terminology6854 Node: Terminology6823
Node: Invoking Stow9349 Ref: symlink9312
Node: Ignore Lists17276 Node: Invoking Stow11136
Node: Motivation For Ignore Lists17540 Node: Ignore Lists19249
Node: Types And Syntax Of Ignore Lists19071 Node: Motivation For Ignore Lists19513
Ref: Types And Syntax Of Ignore Lists-Footnote-122368 Node: Types And Syntax Of Ignore Lists21044
Ref: Types And Syntax Of Ignore Lists-Footnote-222534 Ref: Types And Syntax Of Ignore Lists-Footnote-124359
Ref: Types And Syntax Of Ignore Lists-Footnote-322778 Ref: Types And Syntax Of Ignore Lists-Footnote-224525
Node: Justification For Yet Another Set Of Ignore Files22927 Ref: Types And Syntax Of Ignore Lists-Footnote-324769
Node: Installing Packages24542 Node: Justification For Yet Another Set Of Ignore Files24918
Ref: tree folding25104 Node: Installing Packages26533
Ref: Tree unfolding27102 Ref: tree folding27095
Node: Deleting Packages29241 Ref: Tree unfolding29093
Ref: tree refolding30304 Node: Deleting Packages31232
Ref: Deleting Packages-Footnote-130853 Ref: tree refolding32295
Node: Conflicts31449 Ref: Deleting Packages-Footnote-132844
Ref: Deferred Operation32439 Node: Conflicts33440
Node: Mixing Operations33039 Ref: Deferred Operation34430
Node: Multiple Stow Directories34031 Node: Mixing Operations35030
Node: Target Maintenance35115 Node: Multiple Stow Directories36019
Node: Resource Files36398 Node: Target Maintenance37103
Node: Compile-time vs Install-time38993 Node: Resource Files38386
Node: GNU Emacs42502 Node: Compile-time vs. Install-time40982
Ref: GNU Emacs-Footnote-143491 Node: GNU Emacs44494
Node: Other FSF Software43555 Ref: GNU Emacs-Footnote-145485
Node: Cygnus Software44336 Node: Other FSF Software45549
Node: Perl and Perl 5 Modules45847 Node: Cygnus Software46331
Node: Bootstrapping49476 Node: Perl and Perl 5 Modules47843
Node: Reporting Bugs50285 Node: Bootstrapping51473
Node: Known Bugs51300 Node: Reporting Bugs52283
Node: GNU General Public License51560 Node: Known Bugs54051
Node: Index89114 Node: GNU General Public License54557
Node: Index92111
 
End Tag Table End Tag Table

4
dot-local/share/man/man8/stow.8
View file

@ -55,7 +55,7 @@
.\" ======================================================================== .\" ========================================================================
.\" .\"
.IX Title "stow 8" .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 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents. .\" way too many mistakes in technical documents.
.if n .ad l .if n .ad l
@ -67,7 +67,7 @@ stow \- manage farms of symbolic links
stow [ options ] package ... stow [ options ] package ...
.SH DESCRIPTION .SH DESCRIPTION
.IX Header "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 definitive documentation for Stow; for that, see the accompanying info
manual, e.g. by typing \f(CW\*(C`info stow\*(C'\fR. manual, e.g. by typing \f(CW\*(C`info stow\*(C'\fR.
.PP .PP